Method: locations.verify

Startet das Überprüfungsverfahren 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)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "emailAddress": string,
  "mailerContact": string,
  "phoneNumber": string,
  "token": {
    object (VerificationToken)
  },
  "trustedPartnerToken": string
  // End of mutually exclusive fields.
}
Felder
method

enum (VerificationMethod)

Erforderlich. Bestätigungsmethode.

languageCode

string

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

context

object (ServiceBusinessContext)

Optional. Zusätzliche Kontextinformationen zur Überprüfung von Dienstleistungsunternehmen. Er ist nur für Standorte erforderlich, deren Unternehmenstyp CUSTOMER_LOCATION_ONLY ist. Für die ADRESSBESTÄTIGUNG wird die Adresse verwendet, um eine Postkarte zu senden. Bei anderen Methoden sollte sie mit der Methode übereinstimmen, die an GetVerificationOptions übergeben wird. Wenn er für andere Arten von Unternehmensstandorten festgelegt wird, wird INVALID_ARGUMENT ausgegeben.

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. Im Folgenden finden Sie eine Liste von Feldern, die sich gegenseitig ausschließen. In einer Antwort wird höchstens eines der Felder festgelegt:
emailAddress

string

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

Eine E-Mail-Adresse wird nur akzeptiert, wenn sie eine der von „locations.fetchVerificationOptions“ bereitgestellten Adressen ist. Wenn für [EmailVerificationData] [google.mybusiness-verifications.v1.VerificationOption.EmailVerificationData] „isUserNameEditable“ auf „true“ gesetzt ist, kann der Client einen anderen Nutzernamen (lokaler Teil) angeben, der jedoch mit dem Domainnamen übereinstimmen muss.

mailerContact

string

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

phoneNumber

string

Optional. Die Eingabe für die Methode PHONE_CALL/SMS. Die Telefonnummer, die angerufen oder an die eine SMS gesendet werden soll. Es muss eine der Telefonnummern in den verfügbaren Optionen sein.

token

object (VerificationToken)

Optional. Die Eingabe für die Methode VETTED_PARTNER ist für ausgewählte Partner verfügbar. Für ein geprüftes Konto ist die Eingabe nicht erforderlich. Token, das mit dem Standort verknüpft ist. Token, das mit dem Standort verknüpft ist.

trustedPartnerToken

string

Die Eingabe für die TRUSTED_PARTNER-Methode. Das Bestätigungstoken, das dem Standort zugeordnet ist.

Ende der sich gegenseitig ausschließenden Felder.

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 unter OAuth 2.0 Overview.

VerificationToken

Von einem geprüften Partner generiertes Token.

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

string

Der Tokenstring.