Method: accounts.locations.verify

Startet den Bestätigungsprozess für einen Standort.

HTTP-Anfrage

POST https://mybusiness.googleapis.com/v4/{name=accounts/*/locations/*}:verify

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
name

string

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:
  "emailInput": {
    object (EmailInput)
  },
  "addressInput": {
    object (AddressInput)
  },
  "phoneInput": {
    object (PhoneInput)
  }
  // End of list of possible types for union field RequestData.
}
Felder
method

enum (VerificationMethod)

Bestätigungsmethode.
languageCode

string

Der BCP 47-Sprachcode für die Sprache, die für den Bestätigungsprozess verwendet wird.
context

object (ServiceBusinessContext)

Zusätzliche Kontextinformationen für die Bestätigung von Dienstleistungsunternehmen. Erforderlich für Standorte mit dem Unternehmenstyp CUSTOMER_LOCATION_ONLY Zur Bestätigung von ADDRESS wird die Adresse zum Versand der Postkarte verwendet. Bei anderen Methoden sollte sie mit der übereinstimmen, die an „locations.fetchVerificationOptions“ ü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:
emailInput

object (EmailInput)

Die Eingabe für die EMAIL-Methode.
addressInput

object (AddressInput)

Die Eingabe für die Methode ADDRESS.
phoneInput

object (PhoneInput)

Die Eingabe für die Methode PHONE_CALL/SMS

Antworttext

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

Antwortnachricht für Verifications.VerifyLocation

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

object (Verification)

Die erstellte Bestätigungsanfrage.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

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

EmailInput

Eingabe für EMAIL-Bestätigung.

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

string

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. Ist „isUserNameEditable“ für EmailVerificationData auf „true“ gesetzt, kann der Client einen anderen Nutzernamen (lokaler Teil) angeben, muss aber mit dem Domainnamen übereinstimmen.

AddressInput

Eingabe für Adressbestätigung.

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

string

Name der Kontaktperson, an die die E-Mail gesendet werden soll

PhoneInput

Eingabe für PHONE_CALL/SMS-Bestätigung

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

string

Die Telefonnummer, an die angerufen oder eine SMS gesendet werden soll. Dabei muss es sich um eine der infrage kommenden Optionen handeln.