تتضمّن واجهة برمجة التطبيقات لأداء الأعمال في Google طريقة واجهة برمجة تطبيقات جديدة تتيح جلب عدة "مقاييس يومية" في طلب واحد لواجهة برمجة التطبيقات. يُرجى مراجعة الجدول الزمني للإيقاف وتعليمات نقل البيانات من طريقة v4 reportInsights API إلى واجهة برمجة التطبيقات الخاصة بأداء "الملف التجاري على Google".
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يمكن لمقدّمي الخدمات الذين يوفّرون خدمة إدارة بطاقات البيانات مباشرةً على منصاتهم إثبات ملكية النشاط التجاري الخاص بالتاجر من خلال موقعهم الإلكتروني. وهذا يغني عن الحاجة إلى إعادة توجيه التاجر إلى واجهة مستخدم "الملف التجاري".
الحصول على الحالة الحالية
يمكن للمستخدمين الاتصال بالرقم locations.getVoiceOfMerchantState
في موقع جغرافي معيّن لاسترداد حالته الحالية. إذا كانت قيمة
hasVoiceOfMerchant
القيمة المنطقية هي true، يعني ذلك أنّ الموقع الجغرافي في وضع جيد ولا يلزم اتّخاذ أي إجراء إضافي. بخلاف ذلك، إذا كان الإجراء gain_voice_of_merchant في الردّ يتضمّن verify، عليك إكمال عملية التحقّق. اتّبِع التعليمات أدناه للحصول على مزيد من المعلومات.
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"
}
}
POST
https://mybusinessverifications.googleapis.com/v1/locations/{locationId}
/verifications/{verificationId}:complete
{
"pin": "123456"
}
أفضل الممارسات المتعلّقة بإثبات ملكية "الملف التجاري على Google" باستخدام واجهة برمجة التطبيقات
إنشاء موقع جغرافي
باستخدام GBP Business Information API، يمكنك تضمين منصتك لتوفير وظيفة إنشاء المواقع الجغرافية. عندما تطلب من التجّار إضافة موقع جغرافي جديد، احرص على اتّباع الخطوات التالية:
جمع معلومات الموقع الجغرافي، مثل اسم النشاط التجاري والعنوان والفئة من التاجر
قدِّم بيانات الموقع الجغرافي، مثل اسم النشاط التجاري والفئة والعنوان ورقم الهاتف والموقع الإلكتروني ضمن طلب واجهة برمجة التطبيقات.
بدلاً من ذلك، يمكنك البحث عن موقع جغرافي مطابق محتمل باتّباع الخطوات التالية:
طلب البحث عن المواقع الجغرافية المحتملة المطابقة
اطلب من التاجر اختيار الموقع الجغرافي الصحيح.
إذا كان requestAdminRightsUrl متوفّرًا في ردّ الموقع الجغرافي، ساعد التاجر في طلب الوصول إلى هذا الموقع الجغرافي وامتلاكه على "الملف التجاري على Google".
إذا لم يكن requestAdminRightsUrl متوفّرًا، أنشئ موقعًا جغرافيًا جديدًا باستخدام معرّف المكان في ردّ الموقع الجغرافي.
أكِّد الموقع الجغرافي الجديد.
ملاحظة: إذا لم تحصل على أي نتائج مطابقة محتملة للموقع الجغرافي من طلب البحث الأوّلي، استخدِم معرّف مكان فارغًا لإنشاء موقع جغرافي جديد. بعد ذلك، عليك تأكيد الموقع الجغرافي الجديد.
إثبات ملكية الموقع الجغرافي
لبدء عملية إثبات الملكية باستخدام واجهة برمجة التطبيقات الخاصة بـ "نشاطي التجاري على Google"، يُرجى اتّباع الخطوات التالية:
استخدِم طريقة GetVoiceOfMerchant في واجهة برمجة التطبيقات للتأكّد ممّا إذا كان الموقع الجغرافي يتطلّب إثبات الملكية.
إذا عرضت الاستجابة verify، اتّصِل بالرقم 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)"]]
