Method: accounts.locations.fetchVerificationOptions

Indique toutes les options de validation éligibles pour un établissement dans une langue spécifique.

Requête HTTP

POST https://mybusiness.googleapis.com/v4/{name=accounts/*/locations/*}:fetchVerificationOptions

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
name

string

Nom de ressource de l'établissement à valider.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON
{
  "languageCode": string,
  "context": {
    object (ServiceBusinessContext)
  }
}
Champs
languageCode

string

Code de langue BCP 47 représentant la langue à utiliser pour la procédure de validation. Les options disponibles varient selon les langues.

context

object (ServiceBusinessContext)

Informations contextuelles supplémentaires pour la validation des entreprises de services Obligatoire pour les établissements dont le type d'activité est CUSTOMER_LOCATION_ONLY. INVALID_ARGUMENT sera généré s'il est défini pour d'autres types d'activité dans les zones géographiques.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Message de réponse pour Verifications.FetchVerificationOptions.

Représentation JSON
{
  "options": [
    {
      object (VerificationOption)
    }
  ]
}
Champs
options[]

object (VerificationOption)

Options de validation disponibles

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

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

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.

VerificationOption

L'option de validation indique comment valider l'établissement (indiqué par la méthode de validation) et où la validation sera envoyée (indiqué par les données d'affichage).

Représentation JSON
{
  "verificationMethod": enum (VerificationMethod),

  // Union field DisplayData can be only one of the following:
  "phoneData": {
    object (PhoneVerificationData)
  },
  "addressData": {
    object (AddressVerificationData)
  },
  "emailData": {
    object (EmailVerificationData)
  }
  // End of list of possible types for union field DisplayData.
}
Champs
verificationMethod

enum (VerificationMethod)

Méthode de validation de l'établissement.

Champ d'union DisplayData. Une des données d'affichage. Les données doivent correspondre à la méthode. Ce champ est vide si la méthode correspondante ne comporte aucune donnée d'affichage. DisplayData ne peut être qu'un des éléments suivants :
phoneData

object (PhoneVerificationData)

À définir uniquement si la méthode est PHONE_CALL ou SMS.

addressData

object (AddressVerificationData)

À définir uniquement si la méthode est MAIL.

emailData

object (EmailVerificationData)

À définir uniquement si la méthode est EMAIL.

PhoneVerificationData

Afficher les données pour les vérifications par téléphone (ex. : appel téléphonique, SMS.

Représentation JSON
{
  "phoneNumber": string
}
Champs
phoneNumber

string

Numéro de téléphone auquel le code sera envoyé.

AddressVerificationData

Affichez les données de validation par courrier.

Représentation JSON
{
  "businessName": string,
  "address": {
    object (PostalAddress)
  }
}
Champs
businessName

string

Nom de l'entreprise du marchand.

address

object (PostalAddress)

Adresse à laquelle le courrier peut être envoyé.

EmailVerificationData

Permet d'afficher les données des validations par e-mail.

Représentation JSON
{
  "domainName": string,
  "userName": string,
  "isUserNameEditable": boolean
}
Champs
domainName

string

Nom de domaine dans l'adresse e-mail. Ex. : "gmail.com" à l'adresse foo@gmail.com

userName

string

Nom d'utilisateur dans l'adresse e-mail. Ex. : "foo" à l'adresse foo@gmail.com

isUserNameEditable

boolean

Indique si le client est autorisé à fournir un autre nom d'utilisateur.