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.
Para usar a API GoogleLocations
, siga estas etapas:
- Colete os dados de local do comerciante.
-
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. - 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. -
Com base no estado de
requestAdminRightsUrl
na resposta, faça o seguinte:- 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. - Se
requestAdminRightsUrl
não existir, chameaccounts.locations.create
e crie uma nova ficha que será verificada mais tarde.
- Se
- 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.