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 überprüfenden 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 Bestätigungsprozess verwendet wird.
context

object (ServiceBusinessContext)

Optional. Zusätzliche Kontextinformationen für die Bestätigung von Dienstleistungsunternehmen. Es ist nur für Standorte erforderlich, deren Unternehmenstyp CUSTOMER_LOCATION_ONLY ist. Zur Bestätigung von ADDRESS wird die Adresse zum Versand der Postkarte verwendet. Bei anderen Methoden sollte sie mit der übereinstimmen, die an GetVerificationOptions übergeben wird. Für andere Arten von Unternehmensstandorten wird INVALID_ARGUMENT ausgegeben.
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 sie eine der von locations.fetchVerificationOptions angegebenen Adressen ist. Wenn isUserNameEditable für [EmailVerificationData] [google.mybusiness-verifications.v1.VerificationOption.EmailVerificationData] auf "true" festgelegt ist, kann der Client einen anderen Nutzernamen angeben (lokaler Teil), muss aber mit dem Domainnamen übereinstimmen.
mailerContact

string

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

string

Optional. Eingabe für PHONE_CALL/SMS-Methode Die Telefonnummer, die angerufen oder an die eine SMS gesendet werden soll. Dabei muss es sich um eine der infrage kommenden Optionen handeln.
token

object (VerificationToken)

Optional. Die Eingabe für die Methode VETTED_PARTNER zur Auswahl von partners.. Die Angaben sind 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

Token, das von einem geprüften Partner generiert wurde.

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

string

Der Tokenstring.