Documentation | No Boss Extensions

Publicando seu App (NobossCalendar) no Google para conexão permanente

Detalhes
Escrito por Johnny Salazar Reidel
Categoria: No Boss Calendar

Objetivo: Este guia irá orientá-lo passo a passo no processo de solicitar a verificação (publicação) do seu aplicativo no Google. Ao concluir este processo, a conexão da extensão NoBossCalendar com a sua conta Google se tornará permanente, removendo a necessidade de se autenticar novamente a cada 7 dias.

Caso você ainda não tenha configurada sua conta de API no Google, veja primeiro o nosso tutorial Guia de Configuração: API do Google Calendar para NoBossCalendar.

 

Parte 1: Checklist de Preparação

Antes de iniciar o processo no Google, você precisará ter três itens prontos.

1. Página de Política de Privacidade

O Google exige que seu site tenha uma página de Política de Privacidade e que o link para ela esteja visível na sua página inicial (geralmente no rodapé ou menu principal).

  • Se você JÁ TEM uma página de Política de Privacidade:

    1. Edite a sua página existente.

    2. Adicione o texto modelo abaixo como uma nova seção dentro da sua página.

    3. Salve a página e copie o link (URL) completo dela. Você precisará colar este link no Google Cloud mais tarde.

  • Se você NÃO TEM uma página de Política de Privacidade:

    1. Na administração do seu site Joomla, crie um novo "Artigo" com o título "Política de Privacidade".

    2. Copie e cole o texto modelo abaixo no conteúdo do artigo.

    3. Salve o artigo e copie o link (URL) completo da nova página. Você precisará colar este link no Google Cloud mais tarde.

    4. Adicione um link para esta nova página em um local visível do seu site, como no menu principal ou no rodapé.

Texto Modelo para a Política de Privacidade:

Integration of the No Boss Calendar extension and the Google Calendar API

This section of our privacy policy describes how our site, through the "No Boss Calendar" extension, accesses and uses data from the Google Calendar API.

1. What data do we access?
When a site administrator authenticates their Google Account to set up the integration, our application requests **read-only** access to the following data:
* `.../auth/calendar.readonly`: To list the available calendars in the administrator's account.
* `.../auth/calendar.events.readonly`: To read the event details (title, date, time, location, and description) from the calendars the administrator has chosen to display publicly.

2. How do we use this data?
The data obtained is used for the sole purpose of displaying calendar events on a public page of our site. Authentication is performed only once by the administrator in the restricted area of the site. Website visitors do not authenticate and do not have their data accessed. We do not store, share, or sell any information obtained through the Google API.

3. How to disconnect or revoke access?
The site administrator can disconnect the integration at any time directly within the "No Boss Calendar" extension's admin panel, as detailed in our setup guide at https://wiki.nobossextensions.com/no-boss-calendar/google-calendar-credentials. Alternatively, the connection can be revoked by managing the OAuth 2.0 Client ID within the Google Cloud project at https://console.cloud.google.com/auth/clients.

2. Vídeo de Demonstração

Você não precisa gravar um vídeo. Nós já preparamos um que demonstra o funcionamento da extensão para o Google. Utilize o link abaixo quando for solicitado:

https://www.youtube.com/watch?v=FxGna6DoNcQ

3. Textos de Justificativa

Os textos para explicar ao Google o motivo do uso dos dados já estão prontos. Você apenas precisará copiá-los nos campos corretos durante o passo a passo.

 

Parte 2: Passo a Passo da Publicação no Google

Com os itens do checklist prontos, vamos iniciar o pedido.

Passo 1: Publicar o App

  1. Acesse a página "Público Alvo" do Google Cloud clicando aqui.

  2. Verifique se o seu projeto "NoBossCalendar" está selecionado no topo da página.

  3. Clique no botão "PUBLICAR APP" e, na janela que aparecer, clique em "CONFIRMAR". Esta ação muda o status do seu app de "Teste" para "Em produção", permitindo iniciar o processo de verificação.

Passo 2: Preencher Informações de Branding

  1. Acesse a página de Branding clicando aqui. Como alternativa, se você ainda estiver na tela anterior, pode clicar na opção "Branding" no menu à esquerda.

  2. Na seção "Domínios do app", preencha os campos obrigatórios:

    • Página inicial do aplicativo: Coloque o link da página do seu site que exibe o calendário.

    • Link da Política de Privacidade do Aplicativo: Cole o link da sua página de Política de Privacidade que você preparou na Parte 1.

  3. Na seção "Domínios autorizados", verifique se o domínio do seu site está listado corretamente.

  4. Role até o final da página e clique em "Salvar".

Passo 3: Justificar o Uso dos Dados (Acesso a Dados)

  1. Acesse a página de Acesso a Dados clicando aqui. Como alternativa, se você ainda estiver na tela anterior, pode clicar na opção "Acesso a dados" no menu à esquerda.

  2. No campo "Como os escopos serão usados?", copie e cole o seguinte texto em inglês:

    The application is the "No Boss Calendar" extension for Joomla from No Boss Extensions. It uses read-only scopes to display a public calendar on our site:

1. `.../auth/calendar.readonly`: Used by the site administrator in the admin panel to list and select their Google calendars for public display.

2. `.../auth/calendar.events.readonly`: Reads the event details from the selected calendars to display them publicly on our site's calendar.

Regarding authentication: it is performed once by the site administrator in the admin panel. Public visitors do not authenticate. A persistent refresh token is required for the automatic synchronization of events at intervals defined by the administrator. The demonstration video we provide shows this authentication process in the site's administrative area.

  3. No campo "Vídeo de demonstração", cole o link do vídeo que fornecemos no checklist.

  4. Clique em "SALVAR" no final da página.

Passo 4: Enviar o Pedido na Central de Verificação

  1. Acesse a Central de Verificação clicando aqui. Como alternativa, se você ainda estiver na tela anterior, pode clicar na opção "Central de verificação" no menu à esquerda.

  2. Na tela, clique no botão "Prepare-se para a verificação".

  3. Uma janela lateral irá abrir. Role até o final para encontrar o campo "Mais informações" e, nele, copie e cole o seguinte texto em inglês:

    This application is the "No Boss Calendar" extension for the Joomla CMS. Its purpose is to allow a website administrator to display events from one or more of their Google Calendars on a public-facing website. The extension is developed by No Boss Extensions and is listed on the official Joomla Extensions Directory (JED) at: https://extensions.joomla.org/extension/calendars-a-events/no-boss-calendar/.

The Google OAuth flow is confined to the Joomla admin panel and is only initiated by the website administrator. Public visitors do not authenticate. The administrator grants read-only access via their own Google account. To maintain an updated public calendar through periodic, automatic syncing, the extension requires a persistent refresh token. This avoids the need for the admin to re-authenticate every 7 days.

Full documentation for all extension features is available at: https://wiki.nobossextensions.com/no-boss-calendar/how-the-no-boss-calendar-extension-works.

     

4. Verifique as Pendências: Antes de prosseguir, revise a janela para conferir se o Google sinaliza algum outro ajuste pendente. Se houver um item com um botão "Corrigir", você precisará resolvê-lo antes de continuar.

5. Quando tudo estiver correto, o botão "Confirmar" ficará ativo. Clique nele.

6. O "Questionário de verificação" será exibido em seguida na mesma janela. Responda conforme as sugestões abaixo:

  • Seu aplicativo é apenas para uso pessoal?
    • Marque a opção: Não.
  • Seu aplicativo é apenas para uso interno?
    • Marque a opção: Não.
  • O aplicativo é destinado apenas ao uso para desenvolvimento/teste/preparação?
    • Marque a opção: Não.
  • Seu aplicativo é um plug-in SMTP do Gmail para uso exclusivo dos administradores do site do WordPress?
    • Marque a opção: Não.

7. Marque as duas caixas de seleção de confirmação no final do questionário.

8. Clique em "ENVIAR PARA VERIFICAÇÃO" para finalizar.

 

Próximos Passos

Pronto! O seu pedido foi enviado. Agora é só aguardar o retorno da equipe do Google por e-mail, o que pode levar alguns dias

 

Categorias