A API Verifications e a API Business Information foram lançadas. O trabalho de migração é obrigatório. Consulte nossa programação da descontinuação para ver mais informações sobre endpoints obsoletos. Você também pode se inscrever na nossa lista de e-mails para receber informações relacionadas.

GoogleLocations

A API GoogleLocations permite ver com antecedência se um local foi reivindicado no Google Meu Negócio. Dessa forma, se ele tiver sido reivindicado, você poderá solicitar acesso imediatamente. Além disso, se você gerencia contas verificadas em massa, pode selecionar com antecedência possíveis correspondências com mais precisão e evitar a criação de locais duplicados.

O endpoint da API retorna um URL que indica se um local já foi reivindicado. Em caso afirmativo, você poderá usar esse mesmo URL para iniciar o processo de solicitação de acesso.

Veja na imagem a seguir uma visão geral do processo para solicitar a propriedade de um local.

Figura 1. Diagrama de raias de propriedade de local do Google Meu Negócio

Para usar a API GoogleLocations, siga estas etapas:

  1. Colete os dados de local do comerciante.
  2. Chame o endpoint googleLocations.search. Adicione os dados de local ao corpo da chamada. Você também pode incluí-los em uma string de consulta semelhante àquela que um usuário digita na Pesquisa Google ou no Maps. Por exemplo, "Starbucks Avenida Paulista SP".

    A API retorna uma lista de locais possivelmente correspondentes e informações sobre cada local, como locationName e endereço.

  3. Selecione a opção que corresponde ao seu local. Se não houver correspondências, chame accounts.locations.create e pule para a etapa 5.
  4. Analise o estado de requestAdminRightsUrl na resposta e faça o seguinte:

    1. Se requestAdminRightsUrl estiver presente, então outro usuário é o proprietário da ficha da empresa. Direcione o comerciante para o URL e inicie uma solicitação de acesso e propriedade do local existente no Google Meu Negócio.
    2. Se requestAdminRightsUrl não existir, chame accounts.locations.create e crie uma nova ficha que será verificada mais tarde.
  5. Se você criou novas fichas de empresa como parte desse processo, inicie a verificação delas usando as APIs correspondentes. Para mais informações, consulte Gerenciar verificação.