Integrar rapidamente usuários de plug-ins da Plataforma Google Maps

Janela do widget: conclusão com sucesso

Este tópico é útil para quem está desenvolvendo um plug-in da Plataforma Google Maps para plataformas como WordPress, Shopify, Magento e outras. Ele descreve como integrar rapidamente usuários de plug-ins à Plataforma Google Maps e gerar uma chave de API.

O plug-in precisa enviar a chave de API com cada solicitação para a Plataforma Google Maps. Essa chave é vinculada às informações de faturamento e à Conta do Google do usuário e libera o acesso aos recursos de criação de mapas no seu plug-in.

Para ajudar os usuários do plug-in a gerar rapidamente uma chave de API, forneça um link ou botão que abra o widget de início rápido, uma janela pop-up conveniente que orienta os usuários por algumas etapas simples. O widget de início rápido também mantém o usuário do plug-in na sua plataforma, em vez de direcionar ao console do Google Cloud para executar essas tarefas em várias janelas.

Abrir o widget de início rápido

O widget de início rápido é apenas uma página da Web, e você pode controlar o tamanho dela usando uma chamada JavaScript window.open. Exemplo:

<script>
  function openPopupWindow() {
    var winWidth=570;
    var winHeight=700;
    var left = (screen.width-winWidth)/2;
    var top = (screen.height-winHeight)/2;

    window.open('https://console.cloud.google.com/google/maps-hosted', 'Quick Start Widget',
    'resizable=yes,width='+winWidth+',height='+winHeight+',left='+left+',top='+top);
      return false;
  }
</script>

<!-- CTA to generate Google Maps API Key -->
<button type="button" onClick="openPopupWindow()" style="color: white; background-color: #1a73e8" href="#">
    Get an API Key
</button>

Veja como funciona:

Quando um usuário clica no botão, o widget de início rápido é aberto em uma janela pop-up. Nele, é possível:

  • Criar um projeto e uma Conta do Google, se o usuário ainda não tiver feito isso.
  • Ativar as APIs da Plataforma Google Maps.
  • Gerar uma chave de API que os usuários copiam e colam na configuração do plug-in.

Se o usuário do plug-in já tiver um projeto e uma Conta do Google, o widget vai direcionar à página "Credenciais" no console do Cloud. Lá, é possível encontrar uma chave de API ou criar outra.

Encaminhe os usuários do plug-in ao tópico Sobre o widget de início rápido para que tenham mais informações.

Perguntas frequentes

Preciso pagar para usar o widget de início rápido?

Não. O widget de início rápido está disponível sem custo financeiro a todos os desenvolvedores para simplificar a integração da Plataforma Google Maps.

O widget de início rápido só pode ser usado no WordPress e no Shopify?

Ele pode ser usado em qualquer site de terceiros, não apenas nos de e-commerce ou em criadores de sites.

A plataforma de terceiros tem acesso às informações de faturamento que o usuário digita?

Após a autenticação do usuário no Google, apenas ele pode ver as informações de faturamento e outros dados. Plataformas de terceiros e desenvolvedores de plug-ins não conseguem acessar essas informações.

Posso usar meu projeto e chave de API atuais?

O widget de início rápido vai redirecionar você para o console do Cloud, caso tenha uma conta da Plataforma Google Maps. Nele, é possível usar uma chave de API atual ou gerar uma nova.

Como os usuários do plug-in protegem as chaves de API?

O tópico Práticas recomendadas de segurança de APIs fornece orientações sobre como proteger uma chave de API. Depois de usar o widget de início rápido, os usuários também recebem um e-mail com instruções e um link de acesso ao console do Google Cloud para proteger a chave de API.