Method: locations.verify

Inicia o processo de verificação de um local.

Solicitação HTTP

POST https://mybusinessverifications.googleapis.com/v1/{name=locations/*}:verify

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
name

string

Obrigatório. Nome de recurso do local a ser verificado.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON 
{
  "method": enum (VerificationMethod),
  "languageCode": string,
  "context": {
    object (ServiceBusinessContext)
  },

  // Union field RequestData can be only one of the following:
  "emailAddress": string,
  "mailerContact": string,
  "phoneNumber": string,
  "token": {
    object (VerificationToken)
  }
  // End of list of possible types for union field RequestData.
}
Campos
method

enum (VerificationMethod)

Obrigatório. Método de verificação.
languageCode

string

Opcional. O código BCP 47 que representa o idioma a ser usado no processo de verificação.
context

object (ServiceBusinessContext)

Opcional. Informações de contexto extra para a verificação de empresas de serviços. Ele só é necessário para os locais cujo tipo de empresa é CUSTOMER_LOCATION_ apenas. Para a verificação de ADDRESS, o endereço será usado para enviar o cartão-postal. Para outros métodos, ele precisa ser o mesmo que é transmitido para GetVerifyOptions. INVALID_ ARGUMENT será gerado se estiver definido para outros tipos de locais da empresa.
Campo de união RequestData. Dados de entrada do usuário para um método específico, além dos dados de exibição. Os dados precisam corresponder ao método solicitado. Deixe em branco se nenhum dado for necessário. RequestData pode ser apenas de um dos tipos a seguir:
emailAddress

string

Opcional. A entrada para o método EMAIL. Endereço de e-mail para envio do PIN.

Um endereço de e-mail só é aceito se for um dos endereços fornecidos por locations.fetchVerificationOptions. Se [Email VerificationData] [google.mybusiness-verifications.v1.VerificationOption.EmailVerificationData] tiver o isUserNameEditable definido como verdadeiro, o cliente poderá especificar um nome de usuário diferente (local-part), mas precisará corresponder ao nome de domínio.
mailerContact

string

Opcional. A entrada para o método ADDRESS. Nome do contato para o qual o e-mail será enviado.
phoneNumber

string

Opcional. Entrada para o método PHONE_CALL/SMS. O número de telefone que receberá a chamada ou o envio de SMS. Precisa ser um dos números de telefone nas opções qualificadas.
token

object (VerificationToken)

Opcional. A entrada do método VETTED_PARTNER disponível para partners. selecionados. A informação não é necessária para uma conta verificada. Token associado ao local. Token associado ao local.

Corpo da resposta

Mensagem de resposta para Verifications.VerifyLocation.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "verification": {
    object (Verification)
  }
}
Campos
verification

object (Verification)

A solicitação de verificação criada.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/business.manage

Para mais informações, consulte a Visão geral do OAuth 2.0.

VerificationToken

Token gerado por um parceiro verificado.

Representação JSON 
{
  "tokenString": string
}
Campos
tokenString

string

A string do token.