Google Business Performance API 的
NEW API 方法可擷取單一 API 要求中的多個「DailyMetrics」。
請詳閱
淘汰時間表和從 v4 reportInsights API 方法遷移至 Google Business Profile Performance API 的操作說明。
REST Resource: accounts.locations.verifications
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
資源:驗證
欄位 |
name |
string
驗證的資源名稱。
|
method |
enum (VerificationMethod )
驗證方式。
|
state |
enum (VerificationState )
驗證狀態。
|
createTime |
string (Timestamp format)
要求驗證的時間戳記。 RFC3339 世界標準時間「Zulu」的時間戳記格式,解析度為奈秒,且最多 9 個小數位數。範例:"2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z" 。
|
VerificationMethod
列舉 |
VERIFICATION_METHOD_UNSPECIFIED |
預設值會導致錯誤。 |
ADDRESS |
將附有驗證 PIN 碼的明信片寄到特定郵寄地址。PIN 碼的用途是向 Google 完成驗證。 |
EMAIL |
將內含驗證 PIN 碼的電子郵件傳送至特定電子郵件地址。PIN 碼的用途是向 Google 完成驗證。 |
PHONE_CALL |
只需將驗證 PIN 碼傳送到特定電話號碼,即可撥打電話。PIN 碼的用途是向 Google 完成驗證。 |
SMS |
傳送內含驗證 PIN 碼的簡訊到特定電話號碼。PIN 碼的用途是向 Google 完成驗證。 |
AUTO |
無需其他使用者操作,即可驗證該地點。部分地區可能無法使用這個選項。 |
VerificationState
列舉 |
VERIFICATION_STATE_UNSPECIFIED |
預設值會導致錯誤。 |
PENDING |
尚未完成驗證。 |
COMPLETED |
驗證已完成。 |
FAILED |
驗證失敗。 |
方法 |
|
完成PENDING 驗證。 |
|
依建立時間排序,列出營業地點驗證作業。 |
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-25 (世界標準時間)。
[null,null,["上次更新時間:2025-07-25 (世界標準時間)。"],[[["\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. |"]]