L'API Business Profile Performance est maintenant disponible ! Veuillez indiquer un travail de migration.
Consultez le planning d'abandon et les instructions pour migrer vers la nouvelle API v1 depuis l'ancienne API v4, obsolète.
Aidez-nous à améliorer les menus en répondant à cette enquête afin de mieux comprendre quels attributs de lieux, de menus et de plats vous pouvez indiquer à propos des marchands que vous proposez.

Method: locations.verify

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Démarre le processus de validation pour 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'établissement à vérifier.

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 qui sera utilisée pour le processus de validation.

context

object (ServiceBusinessContext)

Facultatif. Informations supplémentaires sur le contexte pour la validation des établissements de services. Obligatoire uniquement pour les établissements dont le type d'activité est CUSTOMER_LOCATION_ONLY. Pour la validation de ADDRESS, l'adresse sera utilisée pour envoyer le courrier. Pour les autres méthodes, il doit être identique à celui transmis à GetVerificationOptions. INVALID_ARGUMENT est renvoyé 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 ce champ 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 [googleVerification.businessBusinessData.] [google.mybusiness-verifications.v1.VerificationOption.EmailVerificationData] a la valeur isUserNameEditable définie sur "true", le client peut spécifier un nom d'utilisateur différent (partie locale), mais doit correspondre au nom de domaine.

mailerContact

string

Facultatif. Valeur saisie pour la méthode ADDRESS. Nom du contact auquel l'e-mail doit être envoyé.

phoneNumber

string

Facultatif. Entrée de la méthode PHONE_CALL/SMS Numéro de téléphone à appeler ou à partir duquel envoyer le SMS. Il doit s'agir de l'un des numéros de téléphone parmi les options éligibles.

token

object (VerificationToken)

Facultatif. Les données saisies pour la méthode VETTED_PARTNER sont disponibles pour certains partenaires. Ces informations ne sont pas nécessaires pour un compte approuvé. Jeton associé à l'établissement. Jeton associé à l'établissement.

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.VerifyLocation.

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 Présentation d'OAuth 2.0.