Google Business Performance API에는 단일 API 요청으로 여러 'DailyMetrics'를 가져올 수 있는 새로운 API 메서드가 있습니다. v4 reportInsights API 메서드에서 Google Business Profile Performance API로 이전하려면 지원 중단 일정 및 안내를 검토하세요.
자사의 플랫폼에서 직접 등록정보 관리 기능을 제공하는 업체는 자체 사이트 내에서 판매자의 비즈니스를 인증할 수 있습니다. 따라서 판매자를 비즈니스 프로필 UI로 리디렉션할 필요가 없습니다.
현재 상태 가져오기
사용자는 위치에 대해 locations.getVoiceOfMerchantState를
호출하여 해당 위치의 현재 상태를 가져올 수 있습니다. hasVoiceOfMerchant
불리언이 true면
위치가 이미 양호한 상태이므로 추가 조치가 필요하지 않습니다. 그렇지 않고 응답의 gain_voice_of_merchant 작업에 verify가 포함된 경우에는 인증을 완료해야 합니다. 자세한 내용을 보려면 다음 안내를 따르세요.
[null,null,["최종 업데이트: 2025-08-29(UTC)"],[[["\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,["Providers 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\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\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\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\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\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\nLocation 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\nLocation 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)"]]