Regras da API do YouTube
O YouTube disponibiliza uma cota de 10.000 pontos para serem utilizados durante 24 horas. O valor é reestabelecido todos os dias à meia noite do pacífico, ou seja, às 5 horas da manhã no horário de Brasília.
As ações realizadas por meio da API consomem os pontos da cota disponibilizada pelo Youtube, por exemplo, troca de mensagens. Os valores descontados variam conforme o ato realizado. Ao consumir todos pontos não será possível utilizar o canal do YouTube Comments.
Entenda as regras de consumo da API na tabela a seguir:
Consulta para recebimento de mensagem
Dentro de um determinado espaço de tempo, a API realiza consultas para verificar se existem novos comentários que devem ser encaminhados para plataforma, onde cada consulta vale 1 ponto.
Por padrão, as consultas são realizadas a cada 30 segundos dentro do horário comercial e a cada 300 segundos fora do horário comercial. Esses espaços de tempo entre as consultas podem ser alterados dentro das configurações do canal, visando a otimização do consumo da API.
Configurações do Canal
Passo 1
Para configurar o canal na plataforma é necessário ter o client ID e o client secret, que são gerados após configurações realizadas no Google Cloud Platform.
Deve-se cadastrar / acessar o Google Cloud Platform (GCP) através do link https://cloud.google.com e clicar para acessar o “Console”. Após isso, crie um projeto e nomeie com a sua preferência.
Passo 2
Siga os passos informados abaixo para que o projeto criado fique em uso.
O nome do projeto deve estar disponível na barra superior ao final do processo.
Passo 3
Busque pela API que você deve ativar, “YouTube Data API v3” e, quando localizá-la, clique em ativar.
Caso a API já esteja ativa, será exibido no botão a palavra “Ativar”.
Passo 4
É necessário configurar a tela de consentimento. Para isso, siga os passos abaixo:
Passo 5
Preencha os campos conforme solicitado. Escolha um nome para o aplicativo, adicione o e-mail de suporte ao usuário e o logotipo deve seguir as regras definidas pelo GCP.
Passo 6
Forneça os links solicitados referente à sua empresa e o domínio utilizado.
Links de exemplo:
Página inicial do aplicativo: http://www.leucotron.com.br
Página de privacidade: Política de Privacidade - Leucotron
Termo de serviço: Política de Privacidade - Leucotron
Passo 7
Informe um e-mail para envio de notificações sobre alterações no projeto e, quando concluir o preenchimento dos campos, clique em “Salvar e Continuar”.
Passo 8
Adicione os 2 escopos necessários para o funcionamento do canal.
Escopos:
Para adicionar, basta clicar no botão destacado na imagem a seguir:
Passo 9
Utilize o filtro para auxiliar na localização dos escopos e, ao encontrá-los, selecione os desejados e clique em atualizar no final da página. Após isso, valide se os escopos foram adicionados corretamente.
Passo 10
Em “Usuário de teste”, basta clicar para “Salvar e Continuar” e, ao final, é possível visualizar o resumo das configurações realizadas. Clique em “Voltar ao painel” e depois “Publicar Aplicativo”.
Passo 11
Para obter as credencias que serão inseridas na plataforma Conecta, você deve utilizar o campo de busca para localizar “Youtube Data API v3”. Ao encontrar, clique em “Gerir” e, após isso, navegue até “Credenciais” e clique para criar um “ID de cliente OAuth”.
Passo 12
Selecione o tipo “Aplicativo web”, preencha o campo Nome conforme a sua preferência. Em seguida, navegue até “URIs de relacionamento autorizados” e clique em “Adcionar URI”.
Passo 13
Dentro do Conecta, navegue até as configurações do canal do YouTube Comments e copie a URI de redirect.
Ao copiar, cole a URI no Google Cloud Plataform e clique em “Criar”. As credenciais serão exibidas na tela.
Passo 14
Cole as credenciais na plataforma e preencha os outros campos conforme sua preferência. Depois, clique em “Salvar” e se autentique com a conta do seu canal do YouTube.
Informação - Tela do Agente
O tempo de atualização do canal para detecção de comentários e notificação do atendimento em espera funciona da seguinte maneira:
Horário comercial: ciclo de consulta é realizado de 30 em 30 segundos.
Fora do horário comercial: ciclo de consulta é realizado de 300 em 300 segundos.