Method: accounts.locations.verify

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

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 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:
  "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 BCP 47 que representa o idioma a ser usado no processo de verificação.
context

object (ServiceBusinessContext)

Informações de contexto extra para a verificação de empresas de serviços. Obrigatório para os locais cujo tipo de empresa é CUSTOMER_LOCATION_SOMENTE. Para a verificação de ADDRESS, o endereço será usado para enviar o cartão-postal. Para outros métodos, ele deve ser igual ao transmitido para locations.fetchVerificationOptions. 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:
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 de 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 EMAIL.

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

string

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 isUserNameEditable estiver definido como "EmailVerificationData", o cliente poderá especificar um nome de usuário diferente (parte local), mas precisará corresponder ao nome de domínio.

AddressInput

Entrada para verificação de ADDRESS.

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

string

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

PhoneInput

Entrada para verificação por PHONE_CALL/SMS.

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

string

O número de telefone que deve receber a ligação ou receber um SMS. Precisa ser um dos números de telefone nas opções qualificadas.