O Pedir com o Google exige que você tenha uma conta ativa no Portal de parceiros. O portal dá acesso a ferramentas de upload de feeds de dados e configuração de endpoints de serviço da Web. A configuração da conta será iniciada pela equipe do Pedir com o Google após a assinatura do contrato.
Configuração inicial da conta
Depois que sua conta for criada, um e-mail de confirmação será enviado para o endereço de e-mail associado ao seu contato comercial do Google. O e-mail tem links para sua conta no portal e para o guia de integração.
Siga estas etapas para concluir a configuração inicial da conta:
Clique no link para sua conta fornecido no e-mail de confirmação. Na sua primeira visita ao Portal de parceiros, ele solicitará que você adicione seus dados de contato de emergência, caso ainda não tenha feito isso. Siga este guia para preencher seus detalhes de contato. Os dados de contato poderão ser atualizados posteriormente na página Conta e usuários > Dados de contato.
Acesse a página Conta e usuários no portal. Na guia Usuários, é possível conceder acesso aos membros da equipe adicionando as contas deles à lista de usuários. Para mais detalhes, consulte o artigo Conta e usuários.
Depois que a configuração inicial da conta for concluída, sua equipe poderá usar o Portal do parceiro como a principal ferramenta para gerenciar a integração do Pedir com o Google. Para mais detalhes, siga as etapas listadas na página Tarefas de integração.
Como gerenciar marcas
No Pedidos com o Google, uma marca consiste em um conjunto de localizações. Cada localização tem um nome da marca, um logotipo, uma Política de Privacidade, Termos de Serviço, países e idiomas de destino. Isso permite especificar o branding localizado no nível do país e do idioma. As marcas são configuradas separadamente no sandbox e na produção. Será necessário configurar uma marca com pelo menos uma localização para cada país que você tenha restaurantes. Caso contrário, seus restaurantes não aparecerão no Google nem poderão ser testados no Portal de parceiros. Acesse a página Como gerenciar marcas para ver instruções detalhadas sobre como localizar suas marcas.
Tarefas de integração
A página Tarefas de integração lista as etapas para você dar os primeiros passos e fornecer a configuração inicial da sua conta. Conclua-os para garantir que sua conta esteja totalmente funcional.
Configurar um projeto do Google Cloud
Para gerenciar a integração com as APIs do Pedir com o Google, você precisa de um projeto do Google Cloud. Você pode criar um novo projeto ou usar um existente para essa finalidade. Recomendamos que você crie um novo projeto, porque o Google precisa ter acesso a ele.
Depois que o projeto for criado, você precisará do número e do endereço de e-mail do projeto do Cloud para continuar com as tarefas de integração:
- O número do projeto do Cloud está disponível no Console do GCP. Navegue até Página inicial > Painel > Informações do projeto.
- O endereço de e-mail do projeto do Cloud está listado em IAM e administrador > IAM > Permissões. Você precisa do endereço de e-mail que tem o papel Proprietário.
Adicione e salve o número e o endereço de e-mail do projeto no formulário Portal do parceiro > Tarefas de integração > Configuração do projeto do Cloud.
Configurar origem do feed de dados
Hospede os arquivos do feed de dados na sua infraestrutura. O Pedir com o Google é compatível com três tipos de soluções de hospedagem de arquivos: Google Cloud Storage, Amazon S3 e um host da Web com um sitemap que exibe os arquivos por HTTPS. Requisitos adicionais sobre a fonte do feed de dados são fornecidos na nossa página Pré-requisitos. Em seguida, siga as etapas das próximas seções para seu tipo de fonte do feed de dados.
Configuração inicial da fonte do feed de dados no Google Cloud Storage
- Abra a guia Onboarding Tasks no Portal do parceiro.
- Navegue até a etapa Escolher a fonte do feed.
- Preencha o formulário de fonte do feed:
- Método de envio de feed: escolha Google Cloud Storage.
- Arquivo de marcador: forneça o URL do arquivo
marker.txt
. - Arquivos de dados: forneça o URL ao bucket do GCS que contém os feeds de dados.
- Clique em Enviar.
Configuração inicial da fonte do feed de dados no Amazon S3
- Abra a guia Onboarding Tasks no Portal do parceiro.
- Navegue até a etapa Escolher a fonte do feed.
- Preencha o formulário de fonte do feed:
- Método de envio de feed: escolha Amazon S3.
- Arquivo de marcador: forneça o URL do arquivo
marker.txt
. - Arquivos de dados: envie o URL ao bucket S3 com os feeds de dados.
- ID de acesso: insira o ID da chave de acesso do IAM com permissões para ler os recursos do S3.
- Chave de acesso: insira a chave de acesso secreta do IAM com permissões para ler os recursos do S3.
- Clique em Enviar.
Configuração inicial da fonte do feed de dados em HTTPS com sitemap
- Abra a guia Onboarding Tasks no Portal do parceiro.
- Navegue até a etapa Escolher a fonte do feed.
- Preencha o formulário de fonte do feed:
- Método de envio de feed: escolha HTTPS.
- Arquivo do sitemap: forneça o URL do arquivo
sitemap.xml
. - Nome de usuário: digite as credenciais de nome de usuário para acessar o servidor HTTPS.
- Password: digite a senha para acessar o servidor HTTPS.
- Clique em Enviar.
Você poderá alterar as definições de fonte do feed de dados na página Configuração > Feeds depois que a conta estiver totalmente configurada.
Configurar uma conta de serviço
Você precisa de uma conta de serviço para fazer solicitações HTTPS autenticadas nas APIs do Google, como a API de atualizações em tempo real e a atualização assíncrona do pedido.
Para configurar uma conta de serviço, faça o seguinte:
- Acesse o Console do Google Cloud Platform.
- Sua conta no Portal de parceiros também tem um projeto do Google Cloud associado a ela. Selecione o projeto, se ele ainda não estiver selecionado.
- Clique em Contas de serviço no menu à esquerda.
- Clique em Criar conta de serviço.
- Digite um nome para a conta de serviço e clique em Criar.
- Em Selecionar papel, escolha Projeto > Editor.
- Clique em Continuar.
- Opcional: adicione usuários para conceder a eles acesso à conta de serviço e clique em Concluído.
- Clique em > Criar chave para a conta de serviço que você acabou de criar.
- Selecione JSON como o formato e clique em Criar.
- Depois que o novo par de chaves pública/privada for gerado, faça o download dele na sua máquina.
Adicionar um URL de fulfillment
Para testar sua integração, configure o URL da sua API de fulfillment. O URL de fulfillment associa a conta do Portal do Parceiro ao endpoint do URL do serviço da Web, que hospeda o serviço da Web implementado seguindo o esquema de ação de fulfillment.
Para configurar o URL de fulfillment, siga estas etapas:
- No Portal de parceiros, acesse Configuração > Endpoints.
- Adicione um URL de fulfillment de marcador no campo de texto na guia Pedido com endpoint do Google. Nessa etapa, o URL de fulfillment não precisa ser um URL funcional.
- Clique em Salvar alterações.