GoogleLocations

Com a API GoogleLocations, é possível saber com antecedência se um local foi reivindicado no Perfil da empresa. Assim, se ele tiver sido reivindicado, você poderá pedir 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 Perfil da Empresa

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. Com base no estado de requestAdminRightsUrl na resposta, 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 Perfil da Empresa.
    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, use as APIs de verificação para começar a verificação das fichas. Para mais informações, consulte Gerenciar verificação.