Method: accounts.locations.fetchVerificationOptions

Reports all eligible verification options for a location in a specific language.

HTTP request

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

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
name

string

Resource name of the location to verify.

Request body

The request body contains data with the following structure:

JSON representation
{
  "languageCode": string,
  "context": {
    object (ServiceBusinessContext)
  }
}
Fields
languageCode

string

The BCP 47 language code representing the language that is to be used for the verification process. Available options vary by language.

context

object (ServiceBusinessContext)

Extra context information for the verification of service businesses. Required for the locations whose business type is CUSTOMER_LOCATION_ONLY. INVALID_ARGUMENT will be thrown if it is set for other business types of locations.

Response body

If successful, the response body contains data with the following structure:

Response message for Verifications.FetchVerificationOptions.

JSON representation
{
  "options": [
    {
      object (VerificationOption)
    }
  ]
}
Fields
options[]

object (VerificationOption)

The available verification options.

Authorization Scopes

Requires one of the following OAuth scopes:

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

For more information, see the OAuth 2.0 Overview.

VerificationOption

The verification option represents how to verify the location (indicated by verification method) and where the verification will be sent to (indicated by display data).

JSON representation
{
  "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.
}
Fields
verificationMethod

enum (VerificationMethod)

Method to verify the location.

Union field DisplayData. One of the display data. The data must match the method. Empty if the corresponding method doesn't have any display data. DisplayData can be only one of the following:
phoneData

object (PhoneVerificationData)

Set only if the method is PHONE_CALL or SMS.

addressData

object (AddressVerificationData)

Set only if the method is MAIL.

emailData

object (EmailVerificationData)

Set only if the method is EMAIL.

PhoneVerificationData

Display Data for verifications through phone, e.g. phone call, sms.

JSON representation
{
  "phoneNumber": string
}
Fields
phoneNumber

string

Phone number that the PIN will be sent to.

AddressVerificationData

Display data for verifications through postcard.

JSON representation
{
  "businessName": string,
  "address": {
    object (PostalAddress)
  }
}
Fields
businessName

string

Merchant's business name.

address

object (PostalAddress)

Address that a postcard can be sent to.

EmailVerificationData

Display data for verifications through email.

JSON representation
{
  "domainName": string,
  "userName": string,
  "isUserNameEditable": boolean
}
Fields
domainName

string

Domain name in the email address. e.g. "gmail.com" in foo@gmail.com

userName

string

User name in the email address. e.g. "foo" in foo@gmail.com

isUserNameEditable

boolean

Whether client is allowed to provide a different user name.