Method: locations.verify

Startet den Bestätigungsprozess für einen Standort.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
name

string

Erforderlich. Ressourcenname des zu bestätigenden Standorts.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "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.
}
Felder
method

enum (VerificationMethod)

Erforderlich. Bestätigungsmethode.
languageCode

string

Optional. Der BCP 47-Sprachcode für die Sprache, die für den Überprüfungsprozess verwendet werden soll.
context

object (ServiceBusinessContext)

Optional. Zusätzliche Kontextinformationen für die Überprüfung von Dienstleistungsunternehmen Sie ist nur für Standorte mit dem Unternehmenstyp CUSTOMER_LOCATION_ONLY erforderlich. Für die Adressbestätigung wird die Adresse zum Versenden der Postkarte verwendet. Bei anderen Methoden sollte sie mit der Methode übereinstimmen, die an GetVerificationOptions übergeben wird. INVALID_ARGUMENT wird ausgegeben, wenn es für andere Arten von Unternehmensstandorten festgelegt ist.
Union-Feld RequestData. Nutzereingabedaten für eine bestimmte Methode zusätzlich zu den Anzeigedaten Die Daten müssen mit der angeforderten Methode übereinstimmen. Lassen Sie das Feld leer, wenn keine Daten benötigt werden. Für RequestData ist nur einer der folgenden Werte zulässig:
emailAddress

string

Optional. Die Eingabe für die EMAIL-Methode. E-Mail-Adresse, an die die PIN gesendet werden soll.

Eine E-Mail-Adresse wird nur akzeptiert, wenn es sich um eine der von „locations.fetchVerificationOptions“ angegebenen Adressen handelt. Wenn die [EmailVerificationData] Ist für [google.mybusiness-verifications.v1.VerificationOption.EmailVerificationData] der Wert "isUserNameEditable" auf "true" festgelegt, kann der Client einen anderen Nutzernamen angeben (lokaler Teil), aber er muss mit dem Domainnamen übereinstimmen.
mailerContact

string

Optional. Die Eingabe für die Methode ADDRESS. Name des Ansprechpartners, an den die E-Mail gesendet werden soll.
phoneNumber

string

Optional. Eingabe für die Methode PHONE_CALL/SMS: Die Telefonnummer, die angerufen oder an die als SMS gesendet werden soll. Dabei muss es sich um eine der Telefonnummern handeln, die unter den entsprechenden Optionen aufgeführt sind.
token

object (VerificationToken)

Optional. Die Eingabe für die Methode VETTED_PARTNER, die zur Auswahl von partners. Die Eingabe ist für ein überprüftes Konto nicht erforderlich. Token, das mit dem Standort verknüpft ist. Token, das mit dem Standort verknüpft ist.

Antworttext

Antwortnachricht für Verifications.VerifyLocation

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "verification": {
    object (Verification)
  }
}
Felder
verification

object (Verification)

Die erstellte Bestätigungsanfrage.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

VerificationToken

Von einem geprüften Partner generierte Token.

JSON-Darstellung 
{
  "tokenString": string
}
Felder
tokenString

string

Der Tokenstring.