Obter uma chave do YouTube

O chat do YouTube no Astral Overlay exige sua própria chave da YouTube Data API v3. Um painel da Twitch não precisa desta configuração.

1. Abrir o Google Cloud

Abra o Google Cloud Console e entre com sua conta Google. Use o seletor de projetos no topo para criar um projeto ou escolher um já usado para esta integração.

Um nome como Astral Overlay Chat facilita reconhecê-lo. Mantenha esse projeto selecionado nas próximas etapas.

2. Ativar a YouTube Data API v3

Abra a página da YouTube Data API v3 na biblioteca de APIs e escolha Ativar.

Se já estiver ativa, continue para as credenciais. Ativar outra API relacionada ao YouTube não substitui esta etapa.

3. Criar uma chave API

Abra APIs e serviços > Credenciais e escolha Criar credenciais > Chave de API.

Selecione YouTube Data API v3 se o diálogo perguntar qual API a chave pode acessar. Copie a chave e dê um nome reconhecível a ela.

Escolha uma chave API, não um ID de cliente OAuth nem credenciais de conta de serviço. A configuração atual aceita a string da chave.

Veja as instruções de credenciais do YouTube do Google se o console estiver diferente.

4. Definir restrições compatíveis

Abra as configurações da chave na página Credenciais:

Em Restrições de API, escolha Restringir chave e selecione apenas YouTube Data API v3.
Em Restrições de aplicativos, Nenhuma é a opção prática para o cliente Windows atual, a menos que você mantenha uma restrição por IP externo.
Salve as configurações.

O Astral Overlay faz solicitações diretamente do seu computador. A restrição Sites, inclusive para esta documentação, não corresponde a esse cliente. Restrições Android e iOS também não servem.

Para restringir mais o acesso, Endereços IP pode permitir o IP público de Internet do computador. Ele precisa ser atualizado se sua conexão ou VPN mudar. Não use 127.0.0.1 nem um endereço privado da rede doméstica.

Sem restrições de aplicativo, a chave não fica vinculada a um computador específico. Mantenha a restrição API somente para YouTube e a chave privada. A referência de restrições do Google explica as opções.

5. Colar no Astral Overlay

Abra Telas > Adicionar chat e escolha YouTube.
Cole o link do vídeo ao vivo no campo de vídeo.
Cole a chave no campo de chave API.
Adicione o painel de chat.

Use a URL do vídeo ao vivo, não a página do canal. O Astral Overlay mascara a chave e salva uma chave nova ao adicionar o chat. O cartão também permite esquecer uma chave salva.

Se não conectar

Mensagem ou sintoma	O que verificar
API não ativada	Ative a YouTube Data API v3 no projeto que possui a chave.
Chave inválida	Copie a chave API novamente; não cole um ID de cliente ou projeto.
Restrições bloqueiam o aplicativo	Confira a restrição da API YouTube e se restrições de site ou IP externo rejeitam este computador.
Cota esgotada	Revise as cotas API do projeto. Recriar a chave no mesmo projeto não renova a cota.
Sem chat ao vivo	Confira se o vídeo está ao vivo e se o chat está disponível.

As solicitações YouTube consomem a cota do projeto. A documentação de cotas explica custos e reinício diário; consulte o console para a cota real do projeto.

Não publique a chave em capturas, código-fonte ou pedidos de suporte. Se ela for exposta, substitua no Google Cloud e atualize no Astral Overlay.

Voltar aos chats da Twitch e do YouTube.