REST Resource: accounts.locations.verifications

  • A verification in Google My Business represents an attempt to verify a location using various methods like address, email, phone, or SMS.

  • Verification resources contain details like the method used, the verification state (pending, completed, or failed), and a timestamp indicating when the verification was initiated.

  • Businesses can utilize the Google My Business API to manage verifications, including completing pending verifications and retrieving a list of past verifications for a specific location.

  • Different verification methods are available, including postcard mailing, email, phone call, SMS, or automatic verification if eligible.

Resource: Verification

A verification represents a verification attempt on a location.

JSON representation 
{
  "name": string,
  "method": enum (VerificationMethod),
  "state": enum (VerificationState),
  "createTime": string
}
Fields
name

string

Resource name of the verification.
method

enum (VerificationMethod)

The method of the verification.
state

enum (VerificationState)

The state of the verification.
createTime

string (Timestamp format)

The timestamp when the verification is requested.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

VerificationMethod

Specifies the processes used by Google to verify a location.

Enums
VERIFICATION_METHOD_UNSPECIFIED Default value, will result in errors.
ADDRESS Send a postcard with a verification PIN to a specific mailing address. The PIN is used to complete verification with Google.
EMAIL Send an email with a verification PIN to a specific email address. The PIN is used to complete verification with Google.
PHONE_CALL Make a phone call with a verification PIN to a specific phone number. The PIN is used to complete verification with Google.
SMS Send an SMS with a verification PIN to a specific phone number. The PIN is used to complete verification with Google.
AUTO Verify the location without additional user action. This option may not be available for all locations.

VerificationState

All possible verification states.

Enums
VERIFICATION_STATE_UNSPECIFIED Default value, will result in errors.
PENDING The verification is pending.
COMPLETED The verification is completed.
FAILED The verification is failed.

Methods

complete

 Completes a PENDING verification.

list

 List verifications of a location, ordered by create time.