A API Q&A foi lançada. A migração é obrigatória. Consulte nossa programação da descontinuação para ver mais informações sobre endpoints obsoletos.
A v1.1 da API Notifications foi lançada. Consulte o registro de alterações para mais detalhes. Você também pode se inscrever na nossa lista de e-mails para receber atualizações.

Gerenciar a verificação

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

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"
}