Documentation | No Boss Extensions

Guia de Configuração: API do Youtube para galeria de videos

Detalhes
Escrito por Johnny Salazar Reidel
Categoria: No Boss Gallery

Como configurar as Credenciais do Youtube no No Boss Gallery

Para exibir seus vídeos ou playlists do Youtube através do módulo No Boss Gallery, você precisará realizar uma integração segura utilizando a API do Google. Este processo envolve a criação de um projeto no Google Cloud Console e a obtenção de chaves de acesso (Client ID e Client Secret).

Siga rigorosamente as etapas abaixo.

Passo 1: Localizar a URL de Redirecionamento no Joomla

Antes de iniciar as configurações no Google, você deve obter a URL que o módulo gera especificamente para o seu site.

  1. No painel administrativo do Joomla, acesse Extensões > Módulos.

  2. Localize e abra o módulo No Boss Gallery.

  3. Vá até a aba Conexões API's e localize a seção Youtube.

  4. No início desta seção, copie a URL exibida. Ela consta logo no começo, antes dos campos de preenchimento.

    • O formato será similar a: http://SEU-DOMINIO/libraries/noboss/src/Form/Field/Nbapiconnection/NbCallbackProxy.php

Passo 2: Criar um Projeto no Google Cloud Console

  1. Acesse o Google Cloud Console.

  2. No topo da página, clique no seletor de projetos e selecione Novo Projeto.

  3. Dê um nome ao projeto (ex: No Boss Gallery) e clique em Criar.

  4. Certifique-se de que o novo projeto está selecionado no seletor de projetos no topo.

Ativar a API do Youtube

  1. No menu lateral, vá em APIs e Serviços > Biblioteca.

  2. Pesquise por YouTube Data API v3.

  3. Clique no resultado e depois no botão Ativar.

Passo 3: Configurar a Autenticação OAuth

O Google exige que você defina quem terá acesso aos dados e como a tela de login será exibida.

  1. No menu lateral, clique em Tela de permissão OAuth.

  2. Selecione o User Type Externo e clique em Criar.

  3. Preencha os campos obrigatórios:

    • Nome do app: No Boss Gallery.

    • E-mail de suporte do usuário: Escolha o seu e-mail.

    • Logotipo do app: Opcional.

    • Domínios autorizados: Insira o domínio do seu site (ex: meusite.com.br).

    • Dados de contato do desenvolvedor: Seu e-mail novamente.

  4. Clique em Salvar e Continuar.

Passo 4: Configurar o Acesso aos Dados (Escopos)

Os escopos definem quais permissões o módulo terá sobre a sua conta do Youtube.

  1. Na etapa de Escopos, clique em Adicionar ou remover escopos.

  2. Procure e selecione o escopo: .../auth/youtube.readonly (para apenas ler dados dos vídeos e playlists).

  3. Clique em Atualizar e depois em Salvar e Continuar.

Passo 5: Adicionar Usuários de Teste

Enquanto o aplicativo estiver em "Modo de Teste", apenas os usuários listados aqui poderão realizar o login.

  1. Na etapa de Usuários de teste, clique em + Add Users.

  2. Insira o seu e-mail do Google (o mesmo que você usará para conectar o módulo).

  3. Clique em Adicionar e depois em Salvar e Continuar.

Passo 6: Criar as Credenciais de Acesso (ID de Cliente OAuth)

Agora vamos gerar as chaves que serão inseridas no Joomla.

  1. No menu lateral, clique em Credenciais.

  2. Clique em + Criar Credenciais no topo e selecione ID do cliente OAuth.

  3. No campo Tipo de aplicativo, selecione Aplicativo da Web.

  4. Em URIs de redirecionamento autorizados, clique em + Adicionar URI e cole a URL que você copiou no Passo 1.

  5. Clique em Criar.

  6. Uma janela exibirá o seu ID de cliente e a Sua chave secreta de cliente. Copie ambos imediatamente.

Passo 7: Finalizar a Configuração no Módulo

Retorne ao seu site Joomla (na aba Conexões API's do módulo, seção Youtube):

  1. Preencha os campos:

    • Youtube Client ID: Insira o ID do cliente.

    • Youtube Client Secret: Insira a chave secreta do cliente.

  2. Salve as configurações do módulo.

Entendendo o "Modo de Teste"

Por padrão, seu projeto no Google começa em modo de teste. Isso significa que:

  • Validade do Token: A conexão pode expirar a cada 7 dias, exigindo que você clique em "Conectar" novamente no módulo.

  • Limite de Usuários: Apenas os e-mails cadastrados no Passo 5 podem fazer login.

Para tornar a conexão permanente e estável, você deve voltar à Tela de permissão OAuth no Google Console e clicar no botão Publicar Aplicativo.

Próximos Passos

Tela de "App não verificado"

Ao tentar conectar o módulo pela primeira vez, o Google pode exibir uma tela dizendo que o "Google não verificou este app".

  • Como o app é de seu uso pessoal/privado, você não precisa pagar pela verificação.

  • Clique em Configurações Avançadas e depois em Acessar No Boss Gallery (não seguro) para prosseguir com a autorização.

Cota da API

A API do Youtube possui um limite diário de "pontos" de consulta. Se você tem muitos vídeos ou muitas visitas, certifique-se de que o cache do módulo no Joomla está ativado para evitar consumir toda a cota rapidamente.

Categorias