3.14 - YouTube Comments

Regras da API do YouTube

O YouTube disponibiliza a cota de 10.000 pontos para serem utilizados durante 24 horas. O valor é, todos os dias, reestabelecido à meia noite do pacífico, ou seja, às 05 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 e, ao consumir todos os pontos, não é possível utilizar o canal do YouTube Comments. Abaixo, entenda as regras de consumo da API:

Imagem 1 - Regras de Consumo API

Consulta para recebimento de mensagem

Dentro de um determinado espaço de tempo, a API realiza consultas para verificação da existência de novos comentários que devem ser encaminhados para plataforma, onde cada consulta vale 01 ponto. Por padrão, as consultas são realizadas a cada 30 segundos (meio minuto) dentro do horário comercial e a cada 300 segundos (cinco minutos) fora dele. 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. Veja:

Imagem 2 - Intervalos de varredura

Caso necessite de uma cota maior clique aqui para solicitar esse ajuste.

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. Deve-se cadastrar/acessar o Google Cloud Platform (GCP) através do link disponibilizado aqui, clicar para acessar o Console, criar um projeto e nomeá-lo de acordo com a sua preferência. O nome do projeto deve estar disponível na barra superior ao final do processo. A seguir, veja o passo a passo por meio das imagens:

A próxima etapa é buscar pela API que deve ativar, “YouTube Data API v3” e, quando localizá-la, clicar em ativar. Caso a API já esteja ativa, será exibido no botão a palavra Ativar. É necessário configurar a tela de consentimento. Para isso, siga os passos que serão mostrados abaixo e preencha os campos conforme solicitado. Escolha um nome para o aplicativo e adicione o e-mail de suporte ao usuário. O logotipo deve seguir as regras definidas pelo GCP.

Em seguida, forneça os links solicitados referente à sua empresa e ao domínio utilizado, como uma página inicial do aplicativo, uma página de privacidade e termos de serviço, por exemplo. 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”. Adicione os dois escopos necessários para o funcionamento do canal exibidos abaixo, clicando no botão destacado “Adicionar ou Remover Escopos”. Segue links e imagens:

  1. https://www.googleapis.com/auth/youtube

  2. https://www.googleapis.com/auth/youtube.force-ssl

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. Em Usuário de teste, basta clicar para “Salvar e Continuar” e, ao final, é possível visualizar o resumo das configurações feitas. Clique em “Voltar ao painel” e depois “Publicar Aplicativo”. Segue imagens demonstrativas:

Para obter as credenciais que serão inseridas na plataforma Conecta, deve-se 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”. Selecione o tipo Aplicativo web, preencha o campo Nome conforme a sua preferência, navegue até “URI's de relacionamento autorizados” e clique em “Adicionar URI”. Segue:

No 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. As cole na plataforma e preencha os outros campos conforme sua preferência. Depois, clique em Salvar e se autentique com a conta do 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: durante o horário comercial, o ciclo de consulta é realizado de 30 em 30 segundos e, fora dele, o ciclo de consulta é realizado de 300 em 300 segundos, isto é, a cada 5 minutos.



Voltar para Manual de Configuração do Conecta

Voltar para Tela Administrativa

Voltar para Canais