Ao utilizar integrações do Google (como YouTube ou Google Calendar), o aplicativo criado no Google Cloud Console começa com o status de "Testing" (Teste). Nesse status, a conexão expira a cada 7 dias, exigindo que você refaça o login.
Para que a conexão seja permanente, é necessário alterar o status para "In Production" (Em Produção). Como nossas extensões solicitam leitura de dados (calendar.readonly ou youtube.readonly), o Google exige um processo de verificação do aplicativo.
Este guia serve para usuários do No Boss Calendar e do No Boss Video Gallery. Siga os 3 passos abaixo rigorosamente para garantir a aprovação pelo Google.
Passo 1: Preparação do Site
Antes de enviar o aplicativo para revisão, seu site precisa cumprir dois requisitos obrigatórios:
1. Domínio Verificado
O domínio do seu site deve estar verificado no Google Search Console utilizando a mesma conta Google que você usou para criar o aplicativo no Cloud Console.
2. Política de Privacidade Adequada
Sua página de Política de Privacidade precisa mencionar o uso dos dados do Google. Copie o texto correspondente à sua extensão e adicione à sua política:
Para o No Boss Calendar:
"Este site utiliza a API do Google Calendar para exibir agendas e eventos. A integração solicita estritamente o acesso de leitura (
calendar.readonly). Nosso site não coleta, armazena, compartilha ou modifica nenhum dado pessoal, credencial ou evento da sua conta Google. O uso das informações recebidas das APIs do Google aderirá à Política de Dados do Usuário dos Serviços de API do Google."
Para o No Boss Video Gallery:
"Este site utiliza a API do YouTube para exibir vídeos. A integração solicita estritamente acesso de leitura (
youtube.readonly). Nosso site não coleta, compartilha ou modifica seus dados. Ao usar o site, você concorda com os Termos de Serviço do YouTube e a Política de Privacidade do Google."
Passo 2: A Gravação do Vídeo de Demonstração (Obrigatório)
O motivo mais comum para o Google recusar a verificação é um vídeo de demonstração incompleto. Você precisa gravar a tela do seu computador mostrando como o aplicativo funciona.
⚠️ A REGRA DE OURO: O Google precisa ver o seu client_id na barra de endereços (URL) do navegador durante o login. Não pule esta etapa!
Grave um vídeo (recomendamos narrar em inglês ou apenas demonstrar silenciosamente com o navegador em inglês) seguindo este roteiro exato:
-
Início: Comece a gravação no painel administrativo do seu Joomla, na tela de configuração da nossa extensão (Calendar ou Video Gallery).
-
O Clique: Clique no botão de conectar/autorizar com o Google.
-
Mostre a URL (Muito Importante): Assim que a janela de login do Google abrir, clique na barra de endereços (URL) do navegador. Mostre claramente toda a URL, destacando a parte que diz
client_id=.... O avaliador do Google vai pausar o vídeo aí para conferir se o código bate com o seu projeto. -
Tela de Consentimento: Siga com o login. Mostre a tela onde aparece o nome do seu aplicativo e a permissão que ele está pedindo (ex: ver seus eventos ou ver sua conta do YouTube).
-
Sucesso: Conclua o login e mostre o retorno ao painel do Joomla indicando que a conexão foi salva com sucesso.
-
Resultado Final: Abra a página pública (frontend) do seu site e mostre a galeria de vídeos ou o calendário funcionando e exibindo os dados perfeitamente.
Onde hospedar o vídeo: Suba este vídeo no YouTube, defina a visibilidade como Não Listado (Unlisted) e guarde o link.
Passo 3: Preenchendo a Justificativa (Use Cases)
Durante o processo de envio no Google Cloud Console, ou ao responder o e-mail de um avaliador do Google, você precisará justificar por que precisa desse acesso.
Copie e cole o texto em inglês correspondente à sua extensão:
Para o No Boss Calendar:
"This application is a Joomla CMS extension used strictly on my own website to display a public-facing calendar. The app needs the 'calendar.readonly' scope to fetch and display event dates, times, and descriptions from my own Google Calendar account onto my website's frontend. It does not write, delete, or share any user data. Attached is the video demonstrating the OAuth flow."
Para o No Boss Video Gallery:
"This application is a Joomla CMS extension used strictly on my own website to build a video gallery. The app needs the 'youtube.readonly' scope to fetch public videos, playlists, and thumbnails from my own YouTube channel to render them on my website's frontend. No user data is modified, collected, or shared. Attached is the video demonstrating the OAuth flow."
Como Enviar ou Responder ao Google
-
Se é a sua primeira vez enviando: Preencha os campos na tela de Consentimento OAuth no Google Cloud Console, insira o link do vídeo do YouTube no campo correspondente e envie para verificação.
-
Se você já foi reprovado antes: O Google envia um e-mail informando o que faltou. Basta responder diretamente ao e-mail deles dizendo que você corrigiu a Política de Privacidade e enviar o novo link do vídeo do YouTube, juntamente com o texto de justificativa do Passo 3.