Google My Business API

توفّر واجهة برمجة تطبيقات "نشاطي التجاري على Google" واجهة لإدارة معلومات الموقع الجغرافي للنشاط التجاري على Google.

الخدمة: mybusiness.googleapis.com

للاتصال بهذه الخدمة، ننصحك باستخدام مكتبات العملاء التي توفّرها Google. إذا كان تطبيقك يحتاج إلى استخدام مكتباتك الخاصة لاستدعاء هذه الخدمة، فاستخدم المعلومات التالية عند تقديم طلبات واجهة برمجة التطبيقات.

مستند "اقتراحات"

مستند الاستكشاف هو مواصفات يمكن للآلة قراءتها لوصف واجهات برمجة تطبيقات REST واستخدامها. ويتم استخدامه لإنشاء مكتبات للعملاء ومكوّنات IDE وأدوات أخرى تتفاعل مع Google APIs. قد توفّر خدمة واحدة مستندات اكتشاف متعددة. توفّر هذه الخدمة مستندات الاكتشاف التالية:

نقطة نهاية الخدمة

نقطة نهاية الخدمة هي عنوان URL أساسي يحدد عنوان الشبكة لخدمة واجهة برمجة التطبيقات. قد تتضمن خدمة واحدة نقاط نهاية متعددة للخدمة. تحتوي هذه الخدمة على نقطة نهاية الخدمة التالية وجميع معرّفات الموارد المنتظمة (URI) التالية مرتبطة بنقطة نهاية الخدمة هذه:

  • https://mybusiness.googleapis.com

مورد REST: v4.accounts

الطُرق
create
(deprecated)		 POST /v4/accounts
تنشئ حسابًا بالاسم والنوع المحدّدَين ضمن العنصر الرئيسي المحدّد.
deleteNotifications
(deprecated)		 DELETE /v4/{name=accounts/*/notifications}
يمحو إعدادات إشعارات pubsub للحساب.
generateAccountNumber
(deprecated)		 POST /v4/{name=accounts/*}:generateAccountNumber
يتم إنشاء رقم حساب لهذا الحساب.
get
(deprecated)		 GET /v4/{name=accounts/*}
الحصول على الحساب المحدّد
getNotifications
(deprecated)		 GET /v4/{name=accounts/*/notifications}
لعرض إعدادات إشعارات pubsub للحساب.
list
(deprecated)		 GET /v4/accounts
يتم عرض جميع حسابات المستخدم الذي تمت مصادقته.
listRecommendGoogleLocations GET /v4/{name=accounts/*}:recommendGoogleLocations
أدرِج جميع GoogleLocation التي تم اقتراحها لحساب "الملف التجاري" المحدّد.
update
(deprecated)		 PUT /v4/{name=accounts/*}
يعدّل حساب النشاط التجاري المحدّد.
updateNotifications
(deprecated)		 PUT /v4/{name=accounts/*/notifications}

تعمل هذه السياسة على ضبط إعدادات إشعارات pubsub للحساب الذي يُعلِم الملف التجاري عن الموضوع المطلوب إرسال إشعارات pubsub له:

  • مراجعات جديدة للمواقع الجغرافية التي يديرها الحساب

مورد REST: v4.accounts.admins

الطُرق
create
(deprecated)		 POST /v4/{parent=accounts/*}/admins
لدعوة المستخدم المحدَّد ليصبح مشرفًا للحساب المحدّد.
delete
(deprecated)		 DELETE /v4/{name=accounts/*/admins/*}
تتم إزالة المشرف المحدَّد من الحساب المحدَّد.
list
(deprecated)		 GET /v4/{parent=accounts/*}/admins
تعرض قائمة المشرفين على الحساب المحدّد.
patch
(deprecated)		 PATCH /v4/{name=accounts/*/admins/*}
يحدّث هذا الإعداد المشرف من أجل مشرف الحساب المحدّد.

مورد REST: v4.accounts.invitations

الطُرق
accept
(deprecated)		 POST /v4/{name=accounts/*/invitations/*}:accept
يتم قبول الدعوة المحددة.
decline
(deprecated)		 POST /v4/{name=accounts/*/invitations/*}:decline
يتم رفض الدعوة المحددة.
list
(deprecated)		 GET /v4/{parent=accounts/*}/invitations
يسرد الدعوات التي في انتظار المراجعة للحساب المحدّد.

مورد REST: v4.accounts.locations

الطُرق
associate POST /v4/{name=accounts/*/locations/*}:associate
لربط موقع جغرافي بمعرّف مكان.
batchGet POST /v4/{name=accounts/*}/locations:batchGet
الحصول على جميع المواقع الجغرافية المحدّدة في الحساب المعيّن
batchGetReviews POST /v4/{name=accounts/*}/locations:batchGetReviews
تعرض قائمة المراجعات المقسّمة على صفحات لجميع المواقع الجغرافية المحدّدة.
clearAssociation POST /v4/{name=accounts/*/locations/*}:clearAssociation
يؤدي ذلك إلى محو ارتباط بين موقع جغرافي ومعرّف المكان المرتبط به.
create POST /v4/{parent=accounts/*}/locations
تنشئ location جديدة تعود ملكيتها إلى الحساب المحدّد، وتعرضها.
delete DELETE /v4/{name=accounts/*/locations/*}
يؤدي هذا الإجراء إلى حذف موقع جغرافي.
fetchVerificationOptions POST /v4/{name=accounts/*/locations/*}:fetchVerificationOptions
يتم الإبلاغ عن جميع خيارات إثبات الملكية المؤهّلة لموقع جغرافي معيّن بلغة معيّنة.
findMatches POST /v4/{name=accounts/*/locations/*}:findMatches
للبحث عن جميع المواقع الجغرافية المحتملة التي تتطابق مع الموقع الجغرافي المحدّد
get GET /v4/{name=accounts/*/locations/*}
الحصول على الموقع الجغرافي المحدّد
getFoodMenus GET /v4/{name=accounts/*/locations/*/foodMenus}
لعرض قوائم الطعام في موقع جغرافي معيّن.
getGoogleUpdated GET /v4/{name=accounts/*/locations/*}:googleUpdated
يمكن الحصول على النسخة المحدَّثة من Google للموقع الجغرافي المحدّد.
getHealthProviderAttributes GET /v4/{name=accounts/*/locations/*/healthProviderAttributes}
لعرض سمات مقدّمي الرعاية الصحية لموقع جغرافي محدّد.
getServiceList GET /v4/{name=accounts/*/locations/*/serviceList}
احصل على قائمة الخدمات المحدّدة لأحد المواقع الجغرافية.
list GET /v4/{parent=accounts/*}/locations
يسرد المواقع الجغرافية للحساب المحدّد.
patch PATCH /v4/{name=accounts/*/locations/*}
يعدّل الموقع الجغرافي المحدَّد.
reportInsights POST /v4/{name=accounts/*}/locations:reportInsights
تعرض تقريرًا يحتوي على إحصاءات حول مقياس واحد أو أكثر حسب الموقع الجغرافي.
transfer
(deprecated)		 POST /v4/{name=accounts/*/locations/*}:transfer
لنقل موقع جغرافي من حساب يملكه المستخدم إلى حساب آخر يشرف عليه المستخدم نفسه.
updateFoodMenus PATCH /v4/{foodMenus.name=accounts/*/locations/*/foodMenus}
تعديل قوائم الطعام في موقع جغرافي محدّد
updateHealthProviderAttributes PATCH /v4/{healthProviderAttributes.name=accounts/*/locations/*/healthProviderAttributes}
يتم تعديل سمات مقدّمي الرعاية الصحية لموقع جغرافي محدّد.
updateServiceList PATCH /v4/{serviceList.name=accounts/*/locations/*/serviceList}
لتعديل قائمة الخدمات المحدّدة لموقع جغرافي
verify POST /v4/{name=accounts/*/locations/*}:verify
لبدء عملية إثبات ملكية الموقع الجغرافي.

مورد REST: v4.accounts.locations.admins

الطُرق
create
(deprecated)		 POST /v4/{parent=accounts/*/locations/*}/admins
دعوة المستخدم المحدَّد ليصبح مشرفًا للموقع الجغرافي المحدَّد.
delete
(deprecated)		 DELETE /v4/{name=accounts/*/locations/*/admins/*}
إزالة المشرف المحدَّد كمدير للموقع الجغرافي المحدّد
list
(deprecated)		 GET /v4/{parent=accounts/*/locations/*}/admins
تتضمّن قائمة بجميع المشرفين في الموقع الجغرافي المحدَّد.
patch
(deprecated)		 PATCH /v4/{name=accounts/*/locations/*/admins/*}
يحدّث هذا الإعداد المشرف من أجل مشرف الموقع الجغرافي المحدّد.

مورد REST: v4.accounts.locations.followers

الطُرق
getMetadata GET /v4/{name=accounts/*/locations/*/followers/metadata}
احصل على إعدادات المتابعين لموقع جغرافي.

مورد REST: v4.accounts.locations.insuranceNetworks

الطُرق
list GET /v4/{parent=accounts/*/locations/*}/insuranceNetworks
تعرض قائمة بجميع شبكات التأمين المتوافقة مع Google.

مورد REST: v4.accounts.locations.localPosts

الطُرق
create POST /v4/{parent=accounts/*/locations/*}/localPosts
إنشاء مشاركة محلية جديدة مرتبطة بالموقع الجغرافي المحدّد، وعرضها
delete DELETE /v4/{name=accounts/*/locations/*/localPosts/*}
حذف مشاركة محلية.
get GET /v4/{name=accounts/*/locations/*/localPosts/*}
يمكن الحصول على المشاركة المحلية المحددة.
list GET /v4/{parent=accounts/*/locations/*}/localPosts
تعرض قائمة بالمشاركات المحلية المرتبطة بموقع جغرافي.
patch PATCH /v4/{name=accounts/*/locations/*/localPosts/*}
يؤدي هذا الخيار إلى تعديل المشاركة المحلية المحدّدة وعرض المشاركة المحلية المعدَّلة.
reportInsights POST /v4/{name=accounts/*/locations/*}/localPosts:reportInsights
تعرض إحصاءات لمجموعة من المشاركات المحلية المرتبطة ببطاقة بيانات واحدة.

مورد REST: v4.accounts.locations.media

الطُرق
create POST /v4/{parent=accounts/*/locations/*}/media
يتم إنشاء عنصر وسائط جديد للموقع الجغرافي.
delete DELETE /v4/{name=accounts/*/locations/*/media/*}
يؤدي هذا الإجراء إلى حذف عنصر الوسائط المحدَّد.
get GET /v4/{name=accounts/*/locations/*/media/*}
تعرض البيانات الوصفية لعنصر الوسائط المطلوب.
list GET /v4/{parent=accounts/*/locations/*}/media
تعرض قائمة بملفات الوسائط المرتبطة بموقع جغرافي.
patch PATCH /v4/{name=accounts/*/locations/*/media/*}
يعدّل هذا الفلتر البيانات الوصفية لعنصر الوسائط المحدَّد.
startUpload POST /v4/{parent=accounts/*/locations/*}/media:startUpload
يؤدي ذلك إلى إنشاء MediaItemDataRef لتحميل عنصر الوسائط.

مرجع REST: v4.accounts.locations.media.customers

الطُرق
get GET /v4/{name=accounts/*/locations/*/media/customers/*}
تعرض البيانات الوصفية لعنصر وسائط العميل المطلوب.
list GET /v4/{parent=accounts/*/locations/*}/media/customers
تعرض قائمة بوسائط مرتبطة بموقع جغرافي ساهم به العملاء.

مرجع REST: v4.accounts.locations.questions

الطُرق
create POST /v4/{parent=accounts/*/locations/*}/questions
لإضافة سؤال للموقع الجغرافي المحدّد
delete DELETE /v4/{name=accounts/*/locations/*/questions/*}
يؤدي هذا الخيار إلى حذف سؤال محدّد كتبه المستخدم الحالي.
list GET /v4/{parent=accounts/*/locations/*}/questions
تعرض قائمة الأسئلة المقسّمة على صفحات وبعض إجاباتها لموقع جغرافي محدّد.
patch PATCH /v4/{name=accounts/*/locations/*/questions/*}
تعدِّل سؤالاً معيّنًا كتبه المستخدم الحالي.

مرجع REST: v4.accounts.locations.questions.answers

الطُرق
delete DELETE /v4/{parent=accounts/*/locations/*/questions/*}/answers:delete
لحذف الإجابة التي كتبها المستخدم الحالي على سؤال.
list GET /v4/{parent=accounts/*/locations/*/questions/*}/answers
لعرض قائمة مقسّمة على صفحات للإجابات لسؤال محدّد.
upsert POST /v4/{parent=accounts/*/locations/*/questions/*}/answers:upsert
لإنشاء إجابة أو تعديل الإجابة الحالية التي كتبها المستخدم عن السؤال المحدّد.

مورد REST: v4.accounts.locations.reviews

الطُرق
deleteReply DELETE /v4/{name=accounts/*/locations/*/reviews/*}/reply
لحذف الرد على المراجعة المحدّدة.
get GET /v4/{name=accounts/*/locations/*/reviews/*}
تعرض المراجعة المحدّدة.
list GET /v4/{parent=accounts/*/locations/*}/reviews
تعرض قائمة المراجعات المقسّمة على صفحات للموقع الجغرافي المحدّد.
updateReply PUT /v4/{name=accounts/*/locations/*/reviews/*}/reply
لتعديل الردّ على المراجعة المحدّدة.

مورد REST: v4.accounts.locations.verifications

الطُرق
complete POST /v4/{name=accounts/*/locations/*/verifications/*}:complete
يتم إكمال عملية PENDING لإثبات الهوية.
list GET /v4/{parent=accounts/*/locations/*}/verifications
اسرد عمليات إثبات ملكية الموقع الجغرافي، مرتبة حسب وقت الإنشاء.

مورد REST: v4.attributes

الطُرق
list GET /v4/attributes
تعرض قائمة بالسمات المتاحة التي ستكون متاحة لموقع جغرافي يتضمّن الفئة الأساسية والبلد المحدّدَين.

مورد REST: v4.categories

الطُرق
batchGet GET /v4/categories:batchGet
تعرض قائمة بفئات النشاط التجاري للغة المتوفرة وأرقام تعريف GConcept.
list GET /v4/categories
تعرض قائمة بفئات الأنشطة التجارية.

مورد REST: v4.chains

الطُرق
get GET /v4/{name=chains/*}
الحصول على السلسلة المحددة.
search GET /v4/chains:search
يتم البحث في السلسلة استنادًا إلى اسم السلسلة.

مورد REST: v4.googleLocations

الطُرق
report POST /v4/{name=googleLocations/*}:report
الإبلاغ عن GoogleLocation
search POST /v4/googleLocations:search
ابحث في جميع المواقع الجغرافية المحتملة المطابقة للطلب المحدّد.

الخدمة: mybusiness.googleapis.com

للاتصال بهذه الخدمة، ننصحك باستخدام مكتبات العملاء التي توفّرها Google. إذا كان تطبيقك يحتاج إلى استخدام مكتباتك الخاصة لاستدعاء هذه الخدمة، فاستخدم المعلومات التالية عند تقديم طلبات واجهة برمجة التطبيقات.

مستند "اقتراحات"

مستند الاستكشاف هو مواصفات يمكن للآلة قراءتها لوصف واجهات برمجة تطبيقات REST واستخدامها. ويتم استخدامه لإنشاء مكتبات للعملاء ومكوّنات IDE وأدوات أخرى تتفاعل مع Google APIs. قد توفّر خدمة واحدة مستندات اكتشاف متعددة. توفّر هذه الخدمة مستندات الاكتشاف التالية:

نقطة نهاية الخدمة

نقطة نهاية الخدمة هي عنوان URL أساسي يحدد عنوان الشبكة لخدمة واجهة برمجة التطبيقات. قد تتضمن خدمة واحدة نقاط نهاية متعددة للخدمة. تحتوي هذه الخدمة على نقطة نهاية الخدمة التالية وجميع معرّفات الموارد المنتظمة (URI) التالية مرتبطة بنقطة نهاية الخدمة هذه:

  • https://mybusiness.googleapis.com

مورد REST: v1.media

الطُرق
upload POST /v1/media/{resourceName=**}
POST /upload/v1/media/{resourceName=**}
يتم تحميل الوسائط.