Method: accounts.locations.fetchVerificationOptions

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

HTTP-Anfrage

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

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 
{
  "languageCode": string,
  "context": {
    object (ServiceBusinessContext)
  }
}
Felder
languageCode

string

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)

Zusätzliche Kontextinformationen für die Bestätigung von Dienstleistungsunternehmen. Erforderlich für Standorte mit dem Unternehmenstyp CUSTOMER_LOCATION_ONLY Wenn für andere Unternehmenstypen von Standorten festgelegt ist, wird INVALID_ARGUMENT ausgegeben.

Antworttext

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

Antwortnachricht für Verifications.FetchVerificationOptions.

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

object (VerificationOption)

Die verfügbaren Bestätigungsoptionen.

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.

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:
  "phoneData": {
    object (PhoneVerificationData)
  },
  "addressData": {
    object (AddressVerificationData)
  },
  "emailData": {
    object (EmailVerificationData)
  }
  // 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:
phoneData

object (PhoneVerificationData)

Wird nur festgelegt, wenn die Methode PHONE_CALL oder SMS ist.
addressData

object (AddressVerificationData)

Wird nur festgelegt, wenn die Methode MAIL lautet.
emailData

object (EmailVerificationData)

Wird nur festgelegt, wenn die Methode EMAIL ist.

PhoneVerificationData

Displaydaten für Bestätigungen per Telefon, z. B. Telefonanruf oder SMS

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

string

Telefonnummer, an die die PIN gesendet wird

AddressVerificationData

Anzeigedaten für Bestätigungen per Postkarte.

JSON-Darstellung 
{
  "businessName": string,
  "address": {
    object (PostalAddress)
  }
}
Felder
businessName

string

Der Name des Händlers.
address

object (PostalAddress)

Adresse, an die eine Postkarte gesendet werden kann

EmailVerificationData

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

JSON-Darstellung 
{
  "domainName": string,
  "userName": string,
  "isUserNameEditable": boolean
}
Felder
domainName

string

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

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.