Autenticar com a API Mapsbooking

Para fazer atualizações em tempo real, é necessário fazer solicitações à API Maps Booking. Essa API exige que você autentique suas solicitações via OAuth 2.0 usando uma conta de serviço do GCP que tenha acesso à API e que tenha recebido a QPS necessária. Este guia orienta você nas seguintes etapas:

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

Para informações sobre como fazer solicitações à API, consulte a seção Atualizações da API em tempo real do guia de ofertas.

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

  1. Faça login na sua conta do Google Cloud Platform.
  2. Você pode criar um novo projeto ou usar um projeto atual para essa finalidade.
    • Anote o número do projeto do Cloud, porque você vai precisar dele nas próximas etapas. O número do projeto do Cloud também pode ser encontrado na página inicial do Google Cloud Platform. O número do projeto na nuvem é sempre numérico apenas.
  3. Faça login no Portal de parceiros.
  4. Conclua a etapa 1 na página Tarefas de integração do Portal de parceiros enviando o número e o endereço de e-mail do projeto na nuvem (o e-mail 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 admin > Contas de serviço.
  3. Pesquise o ID do seu 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 para a conta de serviço não terá efeito nas chamadas que podem ser feitas para a API Google Maps Booking, já que a alocação de cota suficiente para usá-las é 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, selecione 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-as em um local seguro, porque não será possível recuperá-las mais tarde.
  9. Faça login novamente no Portal de parceiros e conclua as tarefas restantes na página Tarefas de integração do Portal de parceiros.

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 pesquise Google Maps Booking API.
  4. Ative as APIs a seguir:
    • API Google Maps Booking
    • API Google Maps Booking (Dev)

Erros comuns

Há vários motivos para que você tenha 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 a seção Atualizações da API em tempo real do guia de ofertas. Você também pode encontrar clientes de amostra em vários idiomas na seção Amostras de código.

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

  1. Use uma biblioteca de cliente do Google.
  2. Crie credenciais do OAuth usando a autenticação da conta de serviço.
  3. Autorize o escopo apropriado.
  4. Faça chamadas para o endpoint apropriado (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 aparecem?

Se você ainda estiver recebendo erros depois de seguir estas etapas, entre em contato com seu contato da Central de ações com as seguintes informações:

  • Número e ID do projeto na nuvem com uma captura de tela
  • ID da conta de serviço
  • E-mail usado para criar a conta de serviço
  • Detalhes do endpoint que tentou fazer solicitações
  • Horário das tentativas de solicitação
  • Mensagens de erro e solicitação completas recebidas ao fazer solicitações.