Google Business Performance API has a
NEW API method that allows fetching multiple `DailyMetrics` in a single API request. Review the
deprecation schedule and instructions to migrate over from v4 reportInsights API method to Google Business Profile Performance API.
REST Resource: accounts.locations.verifications
Stay organized with collections
Save and categorize content based on your preferences.
Resource: Verification
A verification represents a verification attempt on a location.
| 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 |
|
|
Completes a PENDING verification. |
|
|
List verifications of a location, ordered by create time. |
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-10-16 UTC.
[null,null,["Last updated 2024-10-16 UTC."],[[["\u003cp\u003eA verification in Google My Business represents an attempt to verify a location using various methods like address, email, phone, or SMS.\u003c/p\u003e\n"],["\u003cp\u003eVerification resources contain details like the method used, the verification state (pending, completed, or failed), and a timestamp indicating when the verification was initiated.\u003c/p\u003e\n"],["\u003cp\u003eBusinesses 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.\u003c/p\u003e\n"],["\u003cp\u003eDifferent verification methods are available, including postcard mailing, email, phone call, SMS, or automatic verification if eligible.\u003c/p\u003e\n"]]],["A verification tracks an attempt to verify a location, represented by a name, method, state, and creation timestamp. Verification methods include `ADDRESS` (postcard), `EMAIL`, `PHONE_CALL`, `SMS`, and `AUTO`. Verification states can be `PENDING`, `COMPLETED`, or `FAILED`. Key actions involve completing a pending verification and listing verifications for a location ordered by their creation date.\n"],null,["# REST Resource: accounts.locations.verifications\n\n- [Resource: Verification](#Verification)\n - [JSON representation](#Verification.SCHEMA_REPRESENTATION)\n- [VerificationMethod](#VerificationMethod)\n- [VerificationState](#VerificationState)\n- [Methods](#METHODS_SUMMARY)\n\nResource: Verification\n----------------------\n\nA verification represents a verification attempt on a location.\n\n| JSON representation ||\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| ``` { \"name\": string, \"method\": enum (/my-business/reference/rest/v4/accounts.locations.verifications#VerificationMethod), \"state\": enum (/my-business/reference/rest/v4/accounts.locations.verifications#VerificationState), \"createTime\": string } ``` |\n\n| Fields ||\n|--------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Resource name of the verification. |\n| `method` | `enum (`[VerificationMethod](/my-business/reference/rest/v4/accounts.locations.verifications#VerificationMethod)`)` The method of the verification. |\n| `state` | `enum (`[VerificationState](/my-business/reference/rest/v4/accounts.locations.verifications#VerificationState)`)` The state of the verification. |\n| `createTime` | `string (`[Timestamp](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.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\"`. |\n\nVerificationMethod\n------------------\n\nSpecifies the processes used by Google to verify a location.\n\n| Enums ||\n|-----------------------------------|------------------------------------------------------------------------------------------------------------------------------|\n| `VERIFICATION_METHOD_UNSPECIFIED` | Default value, will result in errors. |\n| `ADDRESS` | Send a postcard with a verification PIN to a specific mailing address. The PIN is used to complete verification with Google. |\n| `EMAIL` | Send an email with a verification PIN to a specific email address. The PIN is used to complete verification with Google. |\n| `PHONE_CALL` | Make a phone call with a verification PIN to a specific phone number. The PIN is used to complete verification with Google. |\n| `SMS` | Send an SMS with a verification PIN to a specific phone number. The PIN is used to complete verification with Google. |\n| `AUTO` | Verify the location without additional user action. This option may not be available for all locations. |\n\nVerificationState\n-----------------\n\nAll possible verification states.\n\n| Enums ||\n|----------------------------------|---------------------------------------|\n| `VERIFICATION_STATE_UNSPECIFIED` | Default value, will result in errors. |\n| `PENDING` | The verification is pending. |\n| `COMPLETED` | The verification is completed. |\n| `FAILED` | The verification is failed. |\n\n| Methods ------- ||\n|------------------------------------------------------------------------------------------|-----------------------------------------------------------|\n| ### [complete](/my-business/reference/rest/v4/accounts.locations.verifications/complete) | Completes a `PENDING` verification. |\n| ### [list](/my-business/reference/rest/v4/accounts.locations.verifications/list) | List verifications of a location, ordered by create time. |"]]