Method: locations.fetchVerificationOptions

Informa todas las opciones de verificación aptas para una ubicación en un idioma específico.

Solicitud HTTP

POST https://mybusinessverifications.googleapis.com/v1/{location=locations/*}:fetchVerificationOptions

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta

Parámetros
location

string

Obligatorio. Es la ubicación que se debe verificar.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON
{
  "languageCode": string,
  "context": {
    object (ServiceBusinessContext)
  }
}
Campos
languageCode

string

Obligatorio. Es el código de idioma BCP 47 que representa el idioma que se usará para el proceso de verificación. Las opciones disponibles varían según el idioma.

context

object (ServiceBusinessContext)

Opcional. Información de contexto adicional para la verificación de empresas de servicios. Solo se puede aplicar a las ubicaciones cuyo tipo de empresa es CUSTOMER_LOCATION_ONLY. Si especificas una dirección precisa, es posible que se habiliten más opciones. Se arrojará INVALID_ARGUMENT si se establece para otros tipos de empresas de ubicaciones.

Cuerpo de la respuesta

Es el mensaje de respuesta de Verifications.FetchVerificationOptions.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON
{
  "options": [
    {
      object (VerificationOption)
    }
  ]
}
Campos
options[]

object (VerificationOption)

Las opciones de verificación disponibles

Permisos de autorización

Requiere el siguiente permiso de OAuth:

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

Para obtener más información, consulta OAuth 2.0 Overview.

VerificationOption

La opción de verificación representa cómo verificar la ubicación (indicada por el método de verificación) y dónde se enviará la verificación (indicada por los datos de visualización).

Representación JSON
{
  "verificationMethod": enum (VerificationMethod),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "phoneNumber": string,
  "addressData": {
    object (AddressVerificationData)
  },
  "emailData": {
    object (EmailVerificationData)
  },
  "announcement": string
  // End of mutually exclusive fields.
}
Campos
verificationMethod

enum (VerificationMethod)

Es el método para verificar la ubicación.

Uno de los datos de visualización. Los datos deben coincidir con el método. Está vacío si el método correspondiente no tiene datos de visualización. La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
phoneNumber

string

Se establece solo si el método es PHONE_CALL o SMS. Es el número de teléfono al que se enviará el PIN.

addressData

object (AddressVerificationData)

Se establece solo si el método es MAIL.

emailData

object (EmailVerificationData)

Se establece solo si el método es EMAIL.

announcement

string

Se establece solo si el método es VETTED_PARTNER.

Fin de los campos mutuamente excluyentes.

AddressVerificationData

Muestra los datos de las verificaciones por tarjeta postal.

Representación JSON
{
  "business": string,
  "address": {
    object (PostalAddress)
  },
  "expectedDeliveryDaysRegion": integer
}
Campos
business

string

Es el nombre de la empresa del comercio.

address

object (PostalAddress)

Es la dirección a la que se puede enviar una postal.

expectedDeliveryDaysRegion

integer

Es la cantidad prevista de días que se tarda en entregar una postal a la región de la dirección.

EmailVerificationData

Muestra los datos de las verificaciones por correo electrónico.

Representación JSON
{
  "domain": string,
  "user": string,
  "isUserNameEditable": boolean
}
Campos
domain

string

Es el nombre de dominio en la dirección de correo electrónico, p. ej., "gmail.com" en foo@gmail.com.

user

string

Es el nombre de usuario en la dirección de correo electrónico, p. ej., "foo" en foo@gmail.com.

isUserNameEditable

boolean

Indica si el cliente puede proporcionar un nombre de usuario diferente.