Google Business Performance API 的新 API 方法可通过单个 API 请求提取多个 `DailyMetrics`。 请查看弃用时间表和相关说明,并从 v4 reportInsights API 方法迁移至 Google Business Profile Performance API。
[null,null,["最后更新时间 (UTC):2025-08-29。"],[[["\u003cp\u003eProviders can directly verify merchant businesses on their platforms, eliminating the need for redirection to the Business Profile UI.\u003c/p\u003e\n"],["\u003cp\u003eVerification options include postcard, phone call, SMS, and email, and can be fetched using the \u003ccode\u003elocations.fetchVerificationOptions\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eLocation creation involves searching for existing locations or creating new ones, followed by initiating the verification process using the \u003ccode\u003elocations.verify\u003c/code\u003e method.\u003c/p\u003e\n"],["\u003cp\u003eVerification status can be retrieved using the \u003ccode\u003elocations.getVoiceOfMerchantState\u003c/code\u003e and \u003ccode\u003elocations.verifications.list\u003c/code\u003e methods.\u003c/p\u003e\n"],["\u003cp\u003eCompleting verification may require a PIN code and using the \u003ccode\u003elocations.verifications.complete\u003c/code\u003e method.\u003c/p\u003e\n"]]],["Providers can verify merchants' businesses directly on their platform. To verify, first check the location's status using `locations.getVoiceOfMerchantState`. If verification is needed, use `locations.fetchVerificationOptions` to present verification methods. Initiate with `locations.verify`, choosing a method (postcard, phone, SMS, or email). Track requests with `locations.verifications.list` and complete pending ones with `locations.verifications.complete`, providing a PIN. New location creation involves using `googleLocations.search` or creating a new location with a blank ID, followed by the verification process.\n"],null,["# Manage verification\n\nProviders who offer listing management directly on their platform can verify a merchant's\nbusiness within their site. This eliminates the need to redirect the merchant into the\nBusiness Profile UI.\n\nGet current state\n-----------------\n\nUsers can call [`locations.getVoiceOfMerchantState`](/my-business/reference/verifications/rest/v1/locations/getVoiceOfMerchantState)\non a location to retrieve its current status. If the\n`hasVoiceOfMerchant`\nboolean is `true`, then the location is already in good standing and no additional action is required. Otherwise, if the `gain_voice_of_merchant` action in the response contains `verify`, you must complete verification. Follow the instructions below for more information.\n\nFetch verification options\n--------------------------\n\nProviders can use the\n[`locations.fetchVerificationOptions`](/my-business/reference/verifications/rest/v1/locations/fetchVerificationOptions)\nmethod to prompt merchants to choose a preferred contact method from a list of available\n[verification methods](/my-business/reference/verifications/rest/v1/VerificationMethod).\n| **Note:** Verification methods vary due to language and regional differences.\n\nTo fetch the verification options, use the following:\nHTTP \n\n```\nPOST\nhttps://mybusinessverifications.googleapis.com/v1/{locationId}:fetchVerificationOptions\n\n{\n \"languageCode\": \"en\"\n}\n\n```\n\nInitiate the verification process\n---------------------------------\n\nAfter you choose a verification method, initiate the verification process with\n[`locations.verify`](/my-business/reference/verifications/rest/v1/locations/verify).\nAs a result of this call, the location moves to a verified state or an error status is returned.\n| An attempt to verify a new location when a location already exists returns an error and might initiate the [ownership resolution](https://support.google.com/business/answer/4661508) process.\nHTTP \n\n```\nPOST\nhttps://mybusinessverifications.googleapis.com/v1/locations/{locationId}\n:verify\n\n// Use only one of the below verification methods\n\n// For postcard verification:\n{\n \"method\": \"ADDRESS\",\n \"languageCode\": \"en\",\n \"addressInput\": {\n \"mailerContactName\": \"Ann Droyd\"\n }\n}\n\n// For phone verification:\n{\n \"method\": \"PHONE_CALL\",\n \"languageCode\": \"en\",\n \"phoneInput\": {\n \"phoneNumber\": \"800-555-0136\"\n }\n}\n\n// For SMS verification:\n{\n \"method\": \"SMS\",\n \"languageCode\": \"en\",\n \"phoneInput\": {\n \"phoneNumber\": \"800-555-0136\"\n }\n}\n\n// For email verification:\n{\n \"method\": \"EMAIL\",\n \"languageCode\": \"en\",\n \"emailInput\": {\n \"emailAddress\": \"ex@google.com\"\n }\n}\n\n```\n\nRetrieve current verifications\n------------------------------\n\nThe\n[`locations.verifications.list`](/my-business/reference/verifications/rest/v1/locations.verifications/list)\ncall retrieves the history of verification requests along with their status for the location specified in the call.\n\nTo retrieve all verification requests, use the following:\nHTTP \n\n```\nGET\nhttps://mybusinessverifications.googleapis.com/v1/locations/{locationId}\n/verifications\n\n```\n\nComplete a pending verification\n-------------------------------\n\nA PIN code and the\n[`locations.verifications.complete`](/my-business/reference/verifications/rest/v1/locations.verifications/complete)\nmethod is usually required to complete the verification of a business.\n\nTo complete a pending verification, use the following:\nHTTP \n\n```\nPOST\nhttps://mybusinessverifications.googleapis.com/v1/locations/{locationId}\n/verifications/{verificationId}:complete\n\n{\n \"pin\": \"123456\"\n}\n\n```\n\nBest practices for GBP verification using API\n---------------------------------------------\n\n### Location creation\n\nWith the GBP Business Information API, you can embed your platform to provide location creation functionality. When you ask merchants to add a new location, make sure to follow these steps:\n\nCollect location information such as business name, address, category from the merchant.\n\n1. Call the [`googleLocations.search`](https://developers.google.com/my-business/reference/businessinformation/rest/v1/googleLocations/search) endpoint.\n2. Provide location data, such as business name, category, address, phone number and website within the API request.\n\n\u003cbr /\u003e\n\nAlternatively, perform a search for potential matching location by following these steps:\n\n1. Query possible location matches.\n2. Ask the merchant to choose the correct location.\n3. If `requestAdminRightsUrl` exists in the location response, help the merchant request access and ownership for that location on Google Business Profile.\n4. If `requestAdminRightsUrl` doesn't exist, create a new location with the Place ID in the location response.\n5. Verify the new location.\n\n\u003cbr /\u003e\n\n**Note:** If you don't get any possible location matches from your initial query, use a blank Place ID to create a new location. Then, verify that new location.\n\n### Location verification\n\nTo start the verification process using the GBP API, please follow these steps:\n\n\n1. Call the [`accounts.locations.list`](https://developers.google.com/my-business/reference/businessinformation/rest/v1/accounts.locations/list) method to list all locations for a Google Account.\n2. Select a location to verify.\n3. Call the [`GetVoiceOfMerchant`](https://developers.google.com/my-business/content/manage-verification#get-current-state) API method to confirm whether that location requires verification.\n4. If the response returns verify, call [`fetchVerificationOptions`](https://developers.google.com/my-business/content/manage-verification#fetch-options) to get a list of methods available to verify that location.\n5. Double-check that the `verificationOption` data includes the correct address, phone number and email address.\n6. After the mechant selects the best-available verification option, call the [`locations.verify`](https://developers.google.com/my-business/content/manage-verification#initiate-verification) method to initiate the appropriate verification. To confirm that the initiation is in progress, call the [`locations.verifications.list.`](https://developers.google.com/my-business/content/manage-verification#retrieve-current-verifications)\n7. Call the [`locations.verification.complete`](https://developers.google.com/my-business/content/manage-verification#complete-verification) method with the merchant's pin.\n8. Call the [`GetVoiceOfMerchant`](https://developers.google.com/my-business/reference/verifications/rest/v1/locations/getVoiceOfMerchantState) API method. If `HasVoiceOfMerchant = true`, you have successfully verified the location.\n\n\u003cbr /\u003e\n\n**Note:** If `AUTO` verification is available for the location, the merchant need not perform any verification steps\n\nFor further information on GBP verification, please refer to our [help center support article.](https://support.google.com/business/answer/7107242)\n\nGuide to Verification Methods for Vetted Partners\n-------------------------------------------------\n\n| **Note:** If you are unable to view the content in the following paragraph and need to learn more, please request through this [form](https://docs.google.com/forms/d/e/1FAIpQLScnAPJATEMb4OqGBFsOj4Vo9aPG7YoO-XahWV_Gcu9dWB7KjA/viewform)."]]