Gerenciar a verificação

Os provedores que oferecem gerenciamento de fichas de empresa diretamente na plataforma deles podem verificar a empresa de um comerciante no próprio site. Assim, não é preciso redirecionar o comerciante para a IU do Perfil da empresa.

Ver o estado atual

Os usuários podem chamar locations.getVoiceOfMerchantState em um local para ver o status atual. Se o booleano hasVoiceOfMerchant for true, o local já estará em situação regular e nenhuma outra ação será necessária. Se a ação gain_voice_of_merchant na resposta contiver verify, será necessário concluir a verificação. Para mais informações, siga as instruções abaixo.

Buscar opções de verificação

Os provedores podem usar o método locations.fetchVerificationOptions para solicitar que os comerciantes escolham uma forma de contato preferida em uma lista de métodos de verificação disponíveis.

Para buscar as opções de verificação, use o seguinte:

HTTP
POST
https://mybusinessverifications.googleapis.com/v1/{locationId}:fetchVerificationOptions

{
  "languageCode": "en"
}

Iniciar o processo de verificação

Depois de escolher um método de verificação, inicie o processo com locations.verify. Como resultado dessa chamada, o local passa para um estado verificado, ou um status de erro é retornado.

HTTP
POST
https://mybusinessverifications.googleapis.com/v1/locations/{locationId}
:verify

// Use only one of the below verification methods

// For postcard verification:
{
  "method": "ADDRESS",
  "languageCode": "en",
  "addressInput": {
    "mailerContactName": "Ann Droyd"
  }
}

// For phone verification:
{
  "method": "PHONE_CALL",
  "languageCode": "en",
  "phoneInput": {
    "phoneNumber": "800-555-0136"
  }
}

// For SMS verification:
{
  "method": "SMS",
  "languageCode": "en",
  "phoneInput": {
    "phoneNumber": "800-555-0136"
  }
}

// For email verification:
{
  "method": "EMAIL",
  "languageCode": "en",
  "emailInput": {
    "emailAddress": "ex@google.com"
  }
}

Recuperar as verificações atuais

A chamada locations.verifications.list recupera o histórico de solicitações de verificação, além do status do local especificado na chamada.

Para recuperar todas as solicitações de verificação, use o seguinte:

HTTP
GET
https://mybusinessverifications.googleapis.com/v1/locations/{locationId}
/verifications

Concluir uma verificação pendente

Um código PIN e o método locations.verifications.complete são necessários para concluir a verificação de uma empresa.

Para concluir uma verificação pendente, use o seguinte:

HTTP
POST
https://mybusinessverifications.googleapis.com/v1/locations/{locationId}
/verifications/{verificationId}:complete

{
  "pin": "123456"
}

Práticas recomendadas para a verificação com o GBP usando a API

Criação de local

Com a API GBP Business Information, é possível incorporar sua plataforma para fornecer a funcionalidade de criação de local. Quando você pedir a um comerciante para adicionar um novo local, siga estas etapas:

Colete as informações de local, como nome, endereço e categoria da empresa do comerciante.

  1. Chame o endpoint googleLocations.search.
  2. Forneça dados de local, como nome, categoria, endereço, número de telefone e site da empresa, na solicitação de API.

Você também pode pesquisar um possível local correspondente seguindo estas etapas:

  1. Consulte possíveis correspondências de local.
  2. Peça ao comerciante para escolher o local correto.
  3. Se requestAdminRightsUrl estiver presente na resposta, ajude o comerciante a solicitar o acesso e a propriedade do local no Perfil da Empresa no Google.
  4. Se requestAdminRightsUrl não existir, crie um novo local com o ID de lugar na resposta.
  5. Verifique o novo local.

Observação: se você não receber possíveis correspondências na consulta inicial, use um ID de lugar em branco para criar um novo local. Em seguida, verifique esse local.

Verificação de local

Para iniciar o processo de verificação usando a API GBP, siga estas etapas:

  1. Chame o método accounts.locations.list para definir todos os locais de uma Conta do Google.
  2. Selecione o local a ser verificado.
  3. Chame o método GetVoiceOfMerchant da API para confirmar se o local requer verificação.
  4. Se a resposta for positiva, chame fetchVerificationOptions para acessar uma lista de métodos disponíveis para verificar esse local.
  5. Confira se os dados de verificationOption incluem o endereço, o número de telefone e o e-mail corretos.
  6. Depois que o comerciante selecionar a melhor opção de verificação disponível, chame o método locations.verify para iniciar a verificação apropriada. Para confirmar que o processo está em andamento, chame o método locations.verifications.list..
  7. Chame o método locations.verification.complete com o alfinete do comerciante.
  8. Chame o método de API GetVoiceOfMerchant. Se HasVoiceOfMerchant = true, o local foi verificado.

Observação: se a verificação de AUTO estiver disponível para o local, o comerciante não vai precisar fazer nada durante esse processo.

Para mais informações sobre a verificação no GBP, consulte nosso artigo de suporte da Central de Ajuda.

Guia de métodos de verificação para parceiros aprovados