Method: locations.fetchVerificationOptions

Meldet alle zulässigen Bestätigungsoptionen für einen Standort in einer bestimmten Sprache.

HTTP-Anfrage

POST https://mybusinessverifications.googleapis.com/v1/{location=locations/*}:fetchVerificationOptions

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
location

string

Erforderlich. Der zu bestätigende Standort.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "languageCode": string,
  "context": {
    object (ServiceBusinessContext)
  }
}
Felder
languageCode

string

Erforderlich. Der BCP 47-Sprachcode für die Sprache, die für den Bestätigungsprozess verwendet wird. Die verfügbaren Optionen variieren je nach Sprache.
context

object (ServiceBusinessContext)

Optional. Zusätzliche Kontextinformationen für die Bestätigung von Dienstleistungsunternehmen. Kann nur auf Standorte angewendet werden, deren Unternehmenstyp CUSTOMER_LOCATION_ONLY ist. Durch Angabe einer genauen Adresse könnten weitere Optionen aktiviert werden. Wenn für andere Unternehmenstypen von Standorten festgelegt ist, wird INVALID_ARGUMENT ausgegeben.

Antworttext

Antwortnachricht für Verifications.FetchVerificationOptions.

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

JSON-Darstellung 
{
  "options": [
    {
      object (VerificationOption)
    }
  ]
}
Felder
options[]

object (VerificationOption)

Die verfügbaren Bestätigungsoptionen.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

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

VerificationOption

Die Bestätigungsoption legt fest, wie der Standort bestätigt werden soll (durch die Bestätigungsmethode angegeben) und wohin die Bestätigung gesendet wird (dargestellt durch angezeigte Daten).

JSON-Darstellung 
{
  "verificationMethod": enum (VerificationMethod),

  // Union field DisplayData can be only one of the following:
  "phoneNumber": string,
  "addressData": {
    object (AddressVerificationData)
  },
  "emailData": {
    object (EmailVerificationData)
  },
  "announcement": string
  // End of list of possible types for union field DisplayData.
}
Felder
verificationMethod

enum (VerificationMethod)

Methode zur Bestätigung des Standorts.
Union-Feld DisplayData. Einer der Anzeigedaten. Die Daten müssen der Methode entsprechen. Leer, wenn die entsprechende Methode keine Anzeigedaten hat. Für DisplayData ist nur einer der folgenden Werte zulässig:
phoneNumber

string

Wird nur festgelegt, wenn die Methode PHONE_CALL oder SMS ist. Telefonnummer, an die die PIN gesendet wird
addressData

object (AddressVerificationData)

Wird nur festgelegt, wenn die Methode MAIL lautet.
emailData

object (EmailVerificationData)

Wird nur festgelegt, wenn die Methode EMAIL ist.
announcement

string

Wird nur festgelegt, wenn die Methode VETTED_PARTNER ist.

AddressVerificationData

Anzeigedaten für Bestätigungen per Postkarte.

JSON-Darstellung 
{
  "business": string,
  "address": {
    object (PostalAddress)
  },
  "expectedDeliveryDaysRegion": integer
}
Felder
business

string

Der Name des Händlers.
address

object (PostalAddress)

Adresse, an die eine Postkarte gesendet werden kann
expectedDeliveryDaysRegion

integer

Voraussichtliche Anzahl von Tagen, bis eine Postkarte in der Region der Adresse zugestellt wird

EmailVerificationData

Daten für Bestätigungen per E-Mail anzeigen.

JSON-Darstellung 
{
  "domain": string,
  "user": string,
  "isUserNameEditable": boolean
}
Felder
domain

string

Domainname in der E-Mail-Adresse, z. B. "gmail.com" in foo@gmail.com
user

string

Nutzername in der E-Mail-Adresse, z. B. „foo“ in foo@gmail.com
isUserNameEditable

boolean

Gibt an, ob der Client einen anderen Nutzernamen angeben darf.