Autenticar com a API Maps Booking

Para fazer atualizações em tempo real, faça solicitações à API Maps Booking. A API Maps Booking exige que você autentique suas solicitações via OAuth 2.0 usando uma conta de serviço do GCP com acesso à API e que tenha recebido o QPS necessário. Este guia contém as etapas para:

  1. Configurar seu projeto do Google Cloud
  2. Crie uma conta de serviço
  3. Ativar a API Maps Booking no seu projeto do GCP
  4. Depurar problemas comuns

Para mais informações sobre como fazer solicitações à API, consulte nossa seção Atualizações da API em tempo real do guia completo dos anúncios dos Serviços Locais.

Como configurar um projeto do Google Cloud com a Central de ações

  1. Faça login na sua conta do Google Cloud Platform.
  2. É possível criar um novo projeto ou usar um existente para essa finalidade.
    • Anote o número do projeto na nuvem, porque você vai precisar dele nas próximas etapas. O número do projeto na nuvem também pode ser encontrado na página inicial do Google Cloud Platform. O número do projeto na nuvem é sempre apenas numérico.
  3. Faça login no Portal do parceiro.
  4. Conclua a etapa 1 na página "Tarefas de integração" do Portal do parceiro enviando o número do projeto na nuvem e o endereço de e-mail dele (o endereço usado para administrar o projeto na nuvem).

Como criar uma conta de serviço e credenciais do OAuth

  1. Faça login novamente na sua conta do Google Cloud Platform.
  2. Acesse IAM e administrador > Contas de serviço.
  3. Pesquise o ID do projeto na nuvem atual ou recém-criado.
  4. Crie uma conta de serviço.
  5. Preencha os detalhes da conta de serviço.
  6. Atribua à nova conta de serviço o papel mais adequado às necessidades do seu aplicativo. A escolha do papel da conta de serviço não afeta as chamadas que podem ser feitas para a API Google Maps Booking, já que a alocação de cota suficiente para usá-la é determinada pela associação do número do projeto na configuração da Central de ações. Se você não tiver certeza de qual papel escolher, basta escolher Projeto > Leitor.
  7. Depois de clicar em "Continuar" na etapa (6), você terá a opção de criar chaves JSON.
  8. Salve as credenciais JSON. Armazene-os em um local seguro, porque não será possível recuperá-los posteriormente.
  9. Faça login novamente no Portal do parceiro e conclua as tarefas restantes na página Onboarding Tasks (Tarefas de integração).

Ativar a API MapsBooking

  1. Faça login na sua conta do Google Cloud Platform.
  2. Acesse API e serviços > Painel.
  3. Clique em Ativar APIs e serviços e procure Google Maps Booking API.
  4. Ative as seguintes APIs:
    • API Google Maps Booking
    • API Google Maps Booking (Dev)

Erros comuns

Há vários motivos para problemas de autorização ao fazer solicitações de atualização em tempo real. Se você precisar de orientações gerais sobre como fazer solicitações de atualizações em tempo real, consulte nossa seção Atualizações da API em tempo real no guia completo dos anúncios dos Serviços Locais. Também é possível encontrar clientes de amostra em várias linguagens na seção Amostras de código.

Se você está encontrando erros 403, verifique se está seguindo todos os requisitos a seguir:

  1. Usar uma biblioteca de cliente do Google.
  2. Crie credenciais do OAuth usando a autenticação de conta de serviço.
  3. Autorize de acordo com o escopo apropriado.
  4. Faça chamadas para o endpoint adequado (listado abaixo).

Verifique se você está fazendo chamadas para o endpoint correto:

  1. Sandbox: https://partnerdev-mapsbooking.googleapis.com/v1alpha/...
  2. Produção: https://mapsbooking.googleapis.com/v1alpha/...

Verifique se você está autorizando as solicitações de credenciais do OAuth corretamente:

  1. Você está autorizando o escopo "https://www.googleapis.com/auth/mapsbooking".
  2. Você está usando a chave da conta de serviço criada em Como criar uma conta de serviço e credenciais do OAuth.

Os erros ainda estão aparecendo?

Se os erros continuarem ocorrendo depois de seguir essas etapas, entre em contato com a Central de ações e inclua as seguintes informações:

  • Número e ID do projeto do Google Cloud com uma captura de tela
  • ID da conta de serviço
  • E-mail usado para criar a conta de serviço
  • Detalhes do endpoint tentaram fazer solicitações para
  • Hora das tentativas de solicitação
  • Mensagens completas de solicitação e erro recebidas ao fazer solicitações.