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 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)

Outras informações de contexto para a verificação das empresas de serviços. Obrigatório para os locais cujo tipo de empresa é CUSTOMER_LOCATION_ONLY. Para a verificação de ADDRESS, o endereço será usado para enviar o cartão-postal. Para outros métodos, ele precisa ser igual ao transmitido para locations.fetchverificationOptions. INVALID_MCC será lançado se estiver definido para outros tipos de locais comerciais.

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 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 deve ser enviado.

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

AddressInput

Entrada para verificação de ADDRESS.

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

string

Nome do contato para onde o e-mail deve ser enviado.

PhoneInput

Entrada para verificação PHONE_CALL/SMS.

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

string

O número de telefone para ligar ou receber um SMS. Precisa ser um dos números de telefone nas opções qualificadas.