Gerenciar a verificação

Os provedores que oferecem gerenciamento de fichas de empresa diretamente na plataforma deles podem verificar os dados empresas em seu site. Isso elimina a necessidade de redirecionar o comerciante para a Interface do Perfil da Empresa.

Obter o estado atual

Os usuários podem ligar para locations.getVoiceOfMerchantState em um local para recuperar o status atual. Se o hasVoiceOfMerchant o booleano é true, então a localização já está em situação regular e nenhuma ação adicional é necessária. Caso contrário, 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 locations.fetchVerificationOptions para solicitar que os comerciantes escolham uma forma de contato preferida em uma lista de métodos de verificação.

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, a localização 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 locations.verifications.list chamada recupera o histórico de solicitações de verificação, juntamente com seu status para o 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 locations.verifications.complete método geralmente é necessário para concluir a verificação de uma empresa.

Para concluir uma verificação pendente, faça 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 uma nova unidade, siga estas etapas:

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

  1. Chame o endpoint googleLocations.search.
  2. Forneça os dados do 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 acesso e 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 uma nova unidade. Em seguida, verifique essa nova unidade.

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 listar todos os locais de uma Conta do Google.
  2. Selecione um local para verificar.
  3. Chame o método GetVoiceOfMerchant da API para confirmar se a unidade requer verificação.
  4. Se a resposta retornar "verificar", 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 início 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, a unidade foi verificada.

Observação:se a verificação de AUTO estiver disponível para a unidade, o comerciante não vai precisar seguir nenhuma etapa de verificação.

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