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 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:
  "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 Überprüfungsprozess verwendet werden soll.
context

object (ServiceBusinessContext)

Zusätzliche Kontextinformationen für die Überprüfung von Dienstleistungsunternehmen Erforderlich für die Standorte mit dem Unternehmenstyp CUSTOMER_LOCATION_ONLY. Für die Adressbestätigung wird die Adresse zum Versenden der Postkarte verwendet. Bei anderen Methoden sollte sie mit der Methode übereinstimmen, die an locations.fetchVerificationOptions ü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:
emailInput

object (EmailInput)

Die Eingabe für die EMAIL-Methode.
addressInput

object (AddressInput)

Die Eingabe für die Methode ADDRESS.
phoneInput

object (PhoneInput)

Eingabe für die PHONE_CALL-/SMS-Methode

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 die Bestätigung per EMAIL.

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 es sich um eine der von „locations.fetchVerificationOptions“ angegebenen Adressen handelt. Wenn „isUserNameEditable“ für EmailVerificationData auf „true“ gesetzt ist, kann der Client einen anderen Nutzernamen (local-part) angeben, der aber mit dem Domainnamen übereinstimmen muss.

AddressInput

Eingabe für ADDRESS-Bestätigung.

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

string

Name des Ansprechpartners, an den die E-Mail gesendet werden soll.

PhoneInput

Eingabe für Bestätigung per PHONE_CALL/SMS.

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

string

Die Telefonnummer, die angerufen oder an die SMS gesendet werden soll. Dabei muss es sich um eine der Telefonnummern handeln, die unter den entsprechenden Optionen aufgeführt sind.