YouTube · Guia de configuração
Como criar uma chave de dados YouTube API
StreamBruh usa sua chave YouTube Data API v3 para pesquisas de vídeos públicos e verificações de upload de canais. As cotas de nuvem Google e as restrições de chave API podem afetar essas verificações agendadas.
Configuração passo a passo
Crie ou selecione um projeto Google Cloud
Faça login em Google Cloud Console com uma conta Google. Crie um projeto para essas notificações ou selecione um projeto que você gerencia. Verifique se o projeto pretendido está ativo no cabeçalho do console.
Habilitar YouTube Data API v3
Em APIs e Serviços → Biblioteca, pesquise YouTube Data API v3 e habilite-o para esse projeto. A criação de uma chave por si só não habilita o API.
Crie uma chave API
Abra APIs e serviços → Credenciais, escolha Criar credenciais → Chave API e copie a chave gerada. Restrinja seu acesso API a YouTube Data API v3. Mantenha a chave fora das páginas públicas e do controle de origem.
StreamBruh chama Google de seu servidor, não do navegador do visitante. Uma restrição de site ou referenciador HTTP bloqueará essas solicitações do servidor. Se o suporte StreamBruh confirmar um IP de saída público estável para o VPS, você poderá restringir adicionalmente a chave para esse IP; caso contrário, mantenha a restrição YouTube API e monitore o uso.
Salve a chave em StreamBruh
Abra Bot e integrações, cole a chave na chave YouTube API e salve. Uma chave salva é mascarada. Deixe o campo em branco durante edições posteriores se desejar manter a chave existente.
Escolha pesquisas ou canais
Uma notificação de pesquisa YouTube segue novos vídeos públicos que correspondem a um termo de pesquisa; sua configuração de idioma é uma preferência de relevância e não uma garantia, e palavras bloqueadas separadas por vírgulas excluem títulos que contenham esses termos. Uma notificação de canal aceita um link YouTube @handle, link de ID de canal, identificador ou ID de canal suportado pelo formulário.
Selecione um canal de destino Discord, personalize a mensagem e salve. As verificações são executadas de acordo com uma programação. Solicitações de pesquisa e verificações de canais consomem a cota YouTube API em taxas diferentes; os resultados também dependem da disponibilidade do YouTube.
Verifique sua configuração
- YouTube Data API v3 está habilitado no mesmo projeto que a chave.
- A restrição API da chave inclui YouTube Data API v3 e sua restrição de cliente permite o VPS.
- Um link de canal é resolvido ou uma configuração de pesquisa é salva e o bot pode enviar para o canal Discord selecionado.
Solução de problemas
Chave API rejeitada
Confirme se a chave pertence ao projeto selecionado, se YouTube Data API v3 está habilitado e se suas restrições permitem solicitações do VPS. As restrições do referenciador do navegador não correspondem às chamadas do lado do servidor.
Cota esgotada
Revise o uso e a cota dos dados YouTube API em Google Cloud Console. Reduza pesquisas desnecessárias ou solicite uma extensão de cota por meio de Google, se for elegível; tente novamente depois que a cota estiver disponível.
Nenhum vídeo postado
Verifique se um novo vídeo público corresponde à pesquisa ou ao canal desde a última verificação, se as palavras bloqueadas excluem seu título e se o canal Discord permanece enviável. As verificações agendadas não são instantâneas.