Method: accounts.locations.verify

Inicia o processo de verificação de uma unidade.

Solicitação HTTP

POST https://mybusiness.googleapis.com/v4/{name=accounts/*/locations/*}:verify

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

Parâmetros de caminho

Parâmetros
name

string

Nome do 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:
  "emailInput": {
    object (EmailInput)
  },
  "addressInput": {
    object (AddressInput)
  },
  "phoneInput": {
    object (PhoneInput)
  }
  // End of list of possible types for union field RequestData.
}
Campos
method

enum (VerificationMethod)

Método de verificação.
languageCode

string

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

object (ServiceBusinessContext)

Informações de contexto extras para a verificação de empresas de serviços. Obrigatório para os locais cujo tipo de empresa é CUSTOMER_LOCATION_ONLY. Para a verificação de ENDEREÇO, o endereço será usado para enviar um cartão-postal. Para outros métodos, ele precisa ser o mesmo que é transmitido para locations.fetchVerificationOptions. INVALID_ARGUMENT será gerado se for definido para outros tipos de locais de empresas.
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 não for necessário. RequestData pode ser apenas de um dos tipos a seguir:
emailInput

object (EmailInput)

A entrada para o método EMAIL.
addressInput

object (AddressInput)

A entrada para o método ADDRESS.
phoneInput

object (PhoneInput)

A entrada para o método PHONE_CALL/SMS

Corpo da resposta

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

Mensagem de resposta para Verifications.VerifyLocation.

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

object (Verification)

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

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

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

EmailInput

Entrada para verificação de E-MAIL.

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

string

Endereço de e-mail para onde o PIN será enviado.

Um endereço de e-mail só será aceito se for um dos endereços informados por locations.fetchverificationOptions. Se o EmailVerificationData tiver isUserNameEditable definido como verdadeiro, o cliente poderá especificar um nome de usuário diferente (parte local), mas ele precisa corresponder ao nome de domínio.

AddressInput

Entrada para verificação de ENDEREÇO.

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

string

Nome do contato para quem o e-mail será enviado.

PhoneInput

Entrada para a verificação PHONE_CALL/SMS.

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

string

O número de telefone que vai receber a chamada ou a mensagem de texto. Ele precisa ser um dos números de telefone nas opções qualificadas.