Google Business Performance API یک روش API جدید دارد که امکان واکشی چندین «DailyMetrics» را در یک درخواست API فراهم می‌کند. زمان‌بندی منسوخ شدن و دستورالعمل‌های انتقال از روش API reportInsights v4 به API عملکرد نمایه کسب‌وکار Google را مرور کنید.
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
ارائه‌دهندگانی که مدیریت فهرست را مستقیماً در پلتفرم خود ارائه می‌کنند، می‌توانند کسب‌وکار یک تاجر را در سایت خود تأیید کنند. این کار نیاز به تغییر مسیر تاجر به رابط کاربری نمایه کسب‌وکار را از بین می‌برد.
وضعیت فعلی را دریافت کنید
کاربران می توانند locations.getVoiceOfMerchantState در یک مکان برای بازیابی وضعیت فعلی آن فراخوانی کنند. اگر بولی hasVoiceOfMerchanttrue باشد، مکان در حال حاضر در وضعیت خوبی قرار دارد و نیازی به اقدام اضافی نیست. در غیر این صورت، اگر اقدام gain_voice_of_merchant در پاسخ حاوی verify باشد، باید تأیید را کامل کنید. برای اطلاعات بیشتر دستورالعمل های زیر را دنبال کنید.
برای واکشی گزینه های تأیید، از موارد زیر استفاده کنید:
HTTP
POST
https://mybusinessverifications.googleapis.com/v1/{locationId}:fetchVerificationOptions
{
"languageCode": "en"
}
فرآیند تأیید را آغاز کنید
پس از انتخاب روش تأیید، فرآیند تأیید را با locations.verify آغاز کنید. در نتیجه این تماس، مکان به حالت تأیید شده منتقل می شود یا وضعیت خطا برگردانده می شود.
HTTP
POST
https://mybusinessverifications.googleapis.com/v1/locations/{locationId}
:verify
// Use only one of the below verification methods
// For postcard verification:
{
"method": "ADDRESS",
"languageCode": "en",
"addressInput": {
"mailerContactName": "Ann Droyd"
}
}
// For phone verification:
{
"method": "PHONE_CALL",
"languageCode": "en",
"phoneInput": {
"phoneNumber": "800-555-0136"
}
}
// For SMS verification:
{
"method": "SMS",
"languageCode": "en",
"phoneInput": {
"phoneNumber": "800-555-0136"
}
}
// For email verification:
{
"method": "EMAIL",
"languageCode": "en",
"emailInput": {
"emailAddress": "ex@google.com"
}
}
بازیابی تأییدیه های فعلی
تماس locations.verifications.list تاریخچه درخواست‌های راستی‌آزمایی را به همراه وضعیت آنها برای مکان مشخص‌شده در تماس بازیابی می‌کند.
برای بازیابی تمام درخواست های تأیید، از موارد زیر استفاده کنید:
HTTP
GET
https://mybusinessverifications.googleapis.com/v1/locations/{locationId}
/verifications
برای تکمیل تأیید صحت معلق، از موارد زیر استفاده کنید:
HTTP
POST
https://mybusinessverifications.googleapis.com/v1/locations/{locationId}
/verifications/{verificationId}:complete
{
"pin": "123456"
}
بهترین روش‌ها برای تأیید GBP با استفاده از API
ایجاد مکان
با استفاده از GBP Business Information API، می‌توانید پلتفرم خود را برای ارائه عملکرد ایجاد موقعیت مکانی جاسازی کنید. وقتی از بازرگانان می‌خواهید مکان جدیدی اضافه کنند، حتماً این مراحل را دنبال کنید:
اطلاعات مکان مانند نام کسب و کار، آدرس، دسته بندی را از تاجر جمع آوری کنید.
داده‌های مکان، مانند نام کسب‌وکار، دسته، آدرس، شماره تلفن و وب‌سایت را در درخواست API ارائه دهید.
از طرف دیگر، با دنبال کردن این مراحل، جستجوی مکان مطابق بالقوه را انجام دهید:
منطبقات مکان ممکن را جستجو کنید.
از تاجر بخواهید مکان صحیح را انتخاب کند.
اگر requestAdminRightsUrl در پاسخ موقعیت مکانی وجود دارد، به تاجر کمک کنید تا در نمایه کسب و کار Google درخواست دسترسی و مالکیت آن مکان را داشته باشد.
اگر requestAdminRightsUrl وجود ندارد، یک مکان جدید با شناسه مکان در پاسخ مکان ایجاد کنید.
مکان جدید را تأیید کنید.
توجه: اگر هیچ منطبق احتمالی موقعیت مکانی را از درخواست اولیه خود دریافت نکردید، از یک شناسه مکان خالی برای ایجاد یک مکان جدید استفاده کنید. سپس، آن مکان جدید را تأیید کنید.
تأیید موقعیت مکانی
برای شروع فرآیند تأیید با استفاده از GBP API، لطفاً این مراحل را دنبال کنید:
برای تأیید اینکه آیا آن مکان به تأیید نیاز دارد یا خیر، با متد GetVoiceOfMerchant API تماس بگیرید.
اگر پاسخ تأیید را برمی‌گرداند، با fetchVerificationOptions تماس بگیرید تا فهرستی از روش‌های موجود برای تأیید آن مکان را دریافت کنید.
دوبار بررسی کنید که داده‌های verificationOption شامل آدرس، شماره تلفن و آدرس ایمیل صحیح باشد.
پس از اینکه فروشنده بهترین گزینه تأیید در دسترس را انتخاب کرد، با متد locations.verify تماس بگیرید تا تأیید مناسب را آغاز کنید. برای تأیید اینکه شروع در حال انجام است، با locations.verifications.list.
تاریخ آخرین بهروزرسانی 2025-09-03 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-09-03 بهوقت ساعت هماهنگ جهانی."],[[["\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)"]]
