Method: accounts.locations.fetchVerificationOptions

Meldet alle infrage kommenden 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 bestätigenden 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 Überprüfungsprozess verwendet werden soll. Die verfügbaren Optionen variieren je nach Sprache.
context

object (ServiceBusinessContext)

Zusätzliche Kontextinformationen für die Überprüfung von Dienstleistungsunternehmen Erforderlich für die Standorte mit dem Unternehmenstyp CUSTOMER_LOCATION_ONLY. INVALID_ARGUMENT wird ausgegeben, wenn es für andere Unternehmenstypen von Standorten festgelegt ist.

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 gibt an, wie der Standort bestätigt werden soll (wird durch die Bestätigungsmethode angegeben) und wohin die Bestätigung gesendet wird (angezeigt durch die angezeigten 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 zum Bestätigen des Standorts.
Union-Feld DisplayData. Eine der Anzeigedaten. Die Daten müssen mit der Methode übereinstimmen. Das Feld ist leer, wenn für die entsprechende Methode keine Anzeigedaten verfügbar sind. Für DisplayData ist nur einer der folgenden Werte zulässig:
phoneData

object (PhoneVerificationData)

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

object (AddressVerificationData)

Wird nur festgelegt, wenn die Methode MAIL lautet.
emailData

object (EmailVerificationData)

Wird nur festgelegt, wenn die Methode EMAIL lautet.

PhoneVerificationData

Anzeigedaten für telefonische Bestätigungen, z.B. Telefonanruf, SMS.

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

string

Telefonnummer, an die die PIN gesendet wird.

AddressVerificationData

Daten für die Bestätigung per Postkarte anzeigen.

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

string

Name des Unternehmens 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.