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>
Confira 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 na 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.