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. O Google costuma reprovar aplicativos que não deixam claro que a extensão é apenas uma ferramenta administrativa e que não coleta dados dos visitantes. Copie o texto correspondente à sua extensão e adicione à sua política:
Para o No Boss Calendar:
"Este site utiliza a extensão No Boss Calendar, cuja conexão com a API atua estritamente como uma ferramenta administrativa. O aplicativo se conecta exclusivamente à conta Google do administrador do site para buscar e exibir sua própria agenda e eventos públicos na interface do site. A integração solicita o escopo de leitura (
calendar.readonly). O aplicativo NÃO solicita, autentica, coleta, armazena ou compartilha nenhum dado pessoal, credencial ou informação de conta Google dos visitantes públicos do site. 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 extensão No Boss Video Gallery, cuja conexão com a API atua estritamente como uma ferramenta administrativa. O aplicativo se conecta exclusivamente à conta Google/YouTube do administrador do site para buscar e exibir suas próprias playlists e vídeos na interface do site. Ele solicita o escopo de leitura (
youtube.readonly). O aplicativo NÃO solicita, autentica, coleta, armazena ou compartilha nenhum dado pessoal, credencial ou informação de conta Google dos visitantes públicos do site. A conexão é usada apenas para incorporar o conteúdo de vídeo público do administrador. Ao visualizar o conteúdo de vídeo incorporado neste site, os visitantes concordam com os Termos de Serviço do YouTube (https://www.youtube.com/t/terms) e a Política de Privacidade do Google (http://www.google.com/policies/privacy)."
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!
🛑 PASSO PRÉVIO CRÍTICO: Se você já testou a conexão antes, o Google fará o login automático e irá pular a "Tela de Consentimento" (a tela que lista as permissões). Se isso acontecer, seu vídeo será recusado! Para corrigir isso: Antes de começar a gravar, acesse sua Conta do Google (myaccount.google.com) > Segurança > "Conexões de apps de terceiros" (Third-party apps with account access), e REMOVA o acesso do seu aplicativo. Isso forçará a tela de consentimento a aparecer novamente durante a gravação.
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). Nota: Se essa tela não aparecer listando as permissões, você esqueceu de revogar o acesso antes de gravar!
-
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.