Integração com YouTube

O que é esta página

A página conecta um canal do YouTube ao aplicativo — como sua descrição diz, "Configure a integração com YouTube para receber mensagens do chat e gerenciar transmissões." Existe em duas variantes: o próprio canal, e uma conta separada da qual o bot responde.

Como configurar

1. Abra Conexões → Canais e abra a página do YouTube. Seu cabeçalho diz Canal do YouTube (Lê eventos, transmissão).
2. Status da Conexão mostra onde você está: Desconectado, ou Conectado como {nome de usuário} uma vez que o canal esteja configurado. A dica ao lado nomeia o que está sendo solicitado: "Requer autorização para verificar transmissões ativas e enviar mensagens para o chat do YouTube."
3. Pressione Autorizar via Navegador. A página tem um botão e nenhum campo para um token — o login abre no seu navegador usual e termina lá.
4. Faça login na conta do Google que possui o canal e concorde com as permissões. Deixe todas as caixas marcadas. O Google lista suas permissões uma por uma e permite que você as desmarque, e desmarcar uma é a razão mais comum para o YouTube acabar conectado e silencioso: sem a permissão para ver suas transmissões, o aplicativo nunca descobre que você está ao vivo, e um chat que não consegue encontrar é um chat que não consegue ler. Desde a versão 0.9.2, o aplicativo recusa tal login e avisa nessa página; antes disso, a conexão simplesmente ficava verde e nada chegava. Em caso de sucesso, a página do navegador diz Autorização bem-sucedida! — "A conta {nome de usuário} foi conectada com sucesso ao YouTube", e abaixo, "Você pode fechar esta janela. Ela será fechada automaticamente em alguns segundos."
5. A página do módulo relata Configuração do YouTube salva com sucesso! e se fecha um momento depois. Nome da Conta (login) agora mostra o canal conectado; o campo é somente leitura.
6. O chat chega junto com uma transmissão: o módulo lê o chat ao vivo de uma transmissão que está em andamento. Sem nada ao vivo, não há nada para ler. Uma transmissão pública é detectada em até um minuto; uma não listada pode levar até meia hora, porque não é mostrada na página do canal e o aplicativo tem que perguntar ao Google sobre ela — raramente, para permanecer dentro de um limite de solicitações compartilhado por todos usando strAImer. Pressionar Autorizar via Navegador a encontra imediatamente.
7. Se o login parar de funcionar depois, abra esta página e pressione Autorizar via Navegador novamente — o mesmo botão o renova. O selo de status voltando para Desconectado é o que te avisa.
8. A seta no canto superior esquerdo, Voltar, sai da página.

A conta do bot

A mesma página em Conexões → Bots tem o cabeçalho Conta do Bot do YouTube (Envia respostas para o chat), e funciona de forma diferente da página do canal acima: um botão, não dois.

1. Pressione Conectar o bot. Uma janela abre dentro do aplicativo: "faça login na conta do Google do bot, então escolha o canal do YouTube no qual ele escreve. Uma conta pode ter vários canais, e o aplicativo não pode saber qual você quer."
2. Faça login como a conta da qual o bot deve responder — não a própria conta do canal.
3. Escolha o canal na página que segue. Essa escolha é o que os espectadores verão como o autor das mensagens do bot.

Uma vez conectado, o botão muda para Fazer login novamente ou trocar de canal e a linha abaixo explica por que o login existe afinal: "O bot escreve da maneira que um navegador faz, então suas respostas e moderação não gastam o limite compartilhado de solicitações do YouTube." Pressione o mesmo botão para mover o bot para outro canal da mesma conta.

Torne o bot um moderador do seu canal. Sem isso, o YouTube recusa bans, time-outs e exclusão de mensagens, não importa o que o aplicativo faça — moderação é um direito que a plataforma concede, não uma configuração aqui.

Se o login salvo parar de funcionar, a página avisa: "O login salvo parou de funcionar, então o bot não está escrevendo. Pressione o botão para fazer login novamente." Logins expiram — esta é a forma normal de renovar um.

Uma coisa para esperar enquanto o caminho próprio do bot é instável. Quando uma mensagem não pode sair através do login do bot, o aplicativo não a descarta — ele a envia através da interface oficial sob o nome do seu próprio canal. Os espectadores veem a mensagem de você em vez de do bot. É uma solução temporária deliberada: silêncio significaria temporizadores, respostas de comandos e o agente todos ficando quietos no YouTube. O aplicativo escreve um aviso no log toda vez que isso acontece, então um bot de repente escrevendo sob seu nome é um sinal de que seu login precisa ser renovado.

O que não pode fazer

• Não há lugar para colar um token, uma chave de acesso ou uma chave de atualização. Autorizar via Navegador é a única forma de entrada, e também é como um login expirado é renovado.
• Nome da Conta (login) não pode ser digitado. Para conectar um canal diferente, faça login com a conta que o possui.
• A página não mostra uma lista de permissões por recurso — o YouTube entrega seu conjunto no login e a página relata apenas se a conta está conectada.
• Não há campos Google Client ID e Google Client Secret — como o módulo diz, "a autorização passa pelo próprio aplicativo strAImer, nenhuma chave necessária".
• A página não tem botão Salvar: tudo é armazenado no final do login do navegador.
• Uma transmissão não pode ser escolhida aqui, e nada na página inicia uma. A página não tem campo para um endereço de transmissão ou um link de vídeo.
• A página não desconecta a conta nem exclui a conexão, e não desliga o módulo.
• O canal e a conta do bot são configurados separadamente: um login não preenche o outro, e eles usam janelas diferentes — o canal faz login através do navegador, o bot dentro do aplicativo.
• O canal do bot não pode ser digitado. É escolhido da lista que a janela de login mostra, e apenas canais da conta com a qual você fez login estão nela.