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 que será usado para o processo de verificação.
context

object (ServiceBusinessContext)

Opcional. Mais informações de contexto para a verificação de empresas de serviços Só é necessário para os locais cujo tipo de empresa é CUSTOMER_LOCATION_ONLY. Para a verificação de ADDRESS, o endereço será usado para enviar cartão-postal. Para outros métodos, ele deve ser o mesmo que é transmitido para GetVerificationOptions. INVALID_ARGUMENT será gerada se estiver definida para outros tipos de local da empresa.
Campo de união RequestData. Dados de entrada do usuário para métodos específicos, 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 é enviado.

Um endereço de e-mail é aceito somente se for um dos endereços fornecidos por locations.fetchVerificationOptions. Se [EmailVerificationData] [google.mybusiness-verifications.v1.VerificationOption.EmailVerificationData] tiver isUserNameEditable definido como verdadeiro, o cliente poderá 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 de contato para onde o e-mail será enviado.
phoneNumber

string

Opcional. A entrada para o método PHONE_CALL/SMS. O número de telefone para o qual você quer receber uma chamada ou enviar um SMS. Precisa ser um dos números de telefone nas opções qualificadas.
token

object (VerificationToken)

Opcional. A entrada para o método VETTED_PARTNER é possível selecionar parceiros. A entrada não é necessária para uma conta verificada. Token associado ao local. Token associado ao local.

Corpo da resposta

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

A 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 o seguinte escopo OAuth:

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

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