Atenção: a v4.7 da API foi lançada. Consulte o registro de alterações. As postagens relacionadas à COVID-19 ainda estão permitidas temporariamente para redes.

Gerenciar a verificação

Os provedores que oferecem gerenciamento de fichas 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 Google Meu Negócio.

A imagem a seguir mostra uma visão geral do processo de verificação:

Figura 1: diagrama de raias da verificação de local do Google Meu Negócio

Ver o estado de verificação atual

Os usuários podem chamar accounts.locations.get em um local para ver o status atual. Se o booleano location.LocationState.isVerified for true, o local já está verificado. Se não for, siga as instruções nas seções a seguir para verificá-lo.

Buscar opções de verificação

Os provedores podem usar a plataforma do método accounts.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://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}
:fetchVerificationOptions

{
  "languageCode": "en"
}

Iniciar o processo de verificação

Depois que um método de verificação é escolhido, accounts.locations.verify é usado para iniciar o processo de verificação. Como resultado dessa chamada, o local passa para um estado verificado, ou um status de erro é retornado.

HTTP
POST
https://mybusiness.googleapis.com/v4/accounts/{accountId}/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 accounts.locations.verifications recupera o estado de verificação atual e o histórico do local especificado na chamada.

Para recuperar as verificações atuais, use o seguinte:

HTTP
GET
https://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}
/verifications

Concluir uma verificação pendente

Às vezes, um código PIN e o método accounts.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://mybusiness.googleapis.com/v4/accounts/{accountId}/locations/{locationId}
/verifications/{verificationId}:complete

{
  "pin": "123456"
}