Atenção: em breve, haverá grandes mudanças na API que exigirão um trabalho de migração. Para ver as atualizações, consulte nossa página de lançamentos com frequência.

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 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, deixe o campo LocationKey.placeID em branco 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. 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 estiver presente, chame accounts.locations.create e forneça o placeID do local selecionado retornado na etapa 3 como parte do objeto de local.
  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.