Method: locations.verify

Lance le processus de validation d'un établissement.

Requête HTTP

POST https://mybusinessverifications.googleapis.com/v1/{name=locations/*}:verify

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
name

string

Obligatoire. Nom de ressource de l'emplacement à valider.

Corps de la requête

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

Représentation 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.
}
Champs
method

enum (VerificationMethod)

Obligatoire. Méthode de validation.
languageCode

string

Facultatif. Code de langue BCP 47 représentant la langue à utiliser pour le processus de validation.
context

object (ServiceBusinessContext)

Facultatif. Informations contextuelles supplémentaires pour la validation des entreprises de services. Il n'est obligatoire que pour les établissements dont le type d'activité est "CUSTOMER_LOCATION_ONLY". Pour la validation de l'adresse ADDRESS, celle-ci sera utilisée pour l'envoi du courrier. Pour les autres méthodes, elle doit être identique à celle transmise à GetVerificationOptions. Un élément INVALID_ARGUMENT est généré s'il est défini pour d'autres types d'établissements.
Champ d'union RequestData. Données d'entrée utilisateur pour une méthode spécifique, en plus des données d'affichage. Les données doivent correspondre à la méthode demandée. Laissez-le vide si aucune donnée n'est nécessaire. RequestData ne peut être qu'un des éléments suivants :
emailAddress

string

Facultatif. Valeur saisie pour la méthode EMAIL. Adresse e-mail à laquelle le code secret doit être envoyé.

Une adresse e-mail n'est acceptée que si elle fait partie des adresses fournies par locations.fetchVerificationOptions. Si isUserNameEditable de [EmailVerificationData] [google.mybusiness-verifications.v1.VerificationOption.EmailVerificationData] est défini sur "true", le client peut indiquer un nom d'utilisateur différent (local-part), mais il doit correspondre au nom de domaine.
mailerContact

string

Facultatif. Valeur saisie pour la méthode ADDRESS. Nom du contact auquel le message doit être envoyé.
phoneNumber

string

Facultatif. Valeur saisie pour la méthode PHONE_CALL/SMS. Numéro de téléphone à appeler ou auquel un SMS doit être envoyé. Il doit s'agir de l'un des numéros de téléphone figurant dans les options éligibles.
token

object (VerificationToken)

Facultatif. Les données saisies pour la méthode VETTED_PARTNER sont disponibles pour sélectionner les partners.. Cette saisie n'est pas nécessaire pour un compte approuvé. Jeton associé à l'établissement. Jeton associé à l'établissement.

Corps de la réponse

Message de réponse pour Verifications.VerifyLocation.

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

Représentation JSON 
{
  "verification": {
    object (Verification)
  }
}
Champs
verification

object (Verification)

Demande de validation créée.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

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

VerificationToken

Jeton généré par un partenaire approuvé.

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

string

Chaîne du jeton.