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

context

object (ServiceBusinessContext)

Opcional. Outras informações de contexto para a verificação das empresas de serviços. Ela só é obrigatória para 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 Get VerificationOptions. 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:
emailAddress

string

Opcional. A entrada para o método EMAIL. 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 parâmetro [Email VerificationData] [google.mybusiness-verifications.v1.VerificationOption.Email VerificationData] tem isUserNameEditable definido como "true", o cliente pode especificar um nome de usuário diferente (parte local), mas precisa corresponder ao nome de domínio.

mailerContact

string

Opcional. A entrada para o método ADDRESS. Nome do contato para onde o e-mail deve ser enviado.

phoneNumber

string

Opcional. A entrada para o método PHONE_CALL/SMS O número de telefone que deve ser chamado ou para o qual o SMS deve ser enviado. Precisa ser um dos números de telefone nas opções qualificadas.

token

object (VerificationToken)

Opcional. A entrada para o método VETTED_PARTNER disponível para selecionar parceiros. A entrada 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.