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, 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 vão variar confirme 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
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.
Você deve se cadastrar/acessar o Google Cloud Platform (GCP) através do link https://cloud.google.com , depois clique para acessar o console:
Crie um projeto e nomeie com a sua preferência:
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:
Busque pela API que você deve ativar: YouTube Data API v3:
Quando localizá-la, clique em ativar. Caso a API já esteja ativa, será exibido no botão a palavra Ativar:
É necessário configurar a tela de consentimento, então navegue até APIs e serviços → tela de permissão OAuth:
Selecione externo e clique para criar:
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:
Forneça os links solicitados referente a 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
Informe um e-mail para envio de notificações sobre alterações no projeto e quando concluir o preenchimento dos campos clique para salvar e continuar:
Adicione os 2 escopos necessários para o funcionamento do canal.
Escopos:
Para adicionar basta clicar no botão destacado na imagem:
Utilize o filtro para auxiliar na localização dos escopos, ao localizar selecione os escopos desejados e clique em atualizar no final da página:
Valide se os escopos foram adicionados corretamente e siga para próxima etapa:
Na etapa 3 - Usuário de teste, basta clicar para salvar e continuar e ao final será possível visualizar o resumo das configurações realizadas.
Clique em voltar ao painel:
Finalize publicando o seu aplicativo:
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 localizar clique em gerir:
Navegue até credenciais e clique para criar um ID de cliente OAuth:
Selecione o tipo aplicativo web, preencha o campo nome conforme a sua preferência. Navegue até URIs de relacionamento autorizados e clique em ADICIONAR URI:
Dentro do Conecta, navegue até as configurações do canal do YouTube Comments e copie a URI de redirect:
Cole a URI no Google Cloud Platform e clique em criar:
As credenciais serão exibidas na tela:
Cole as credenciais na plataforma e preencha os outros campos conforme sua preferência:
Após clicar em salvar você deve se autenticar 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.