My Business Account Management API

توفر واجهة برمجة تطبيقات إدارة حساب نشاطي التجاري واجهة لإدارة الوصول إلى موقع على Google.

ملاحظة: إذا كانت لديك حصة 0 بعد تفعيل واجهة برمجة التطبيقات، يُرجى طلب الدخول إلى واجهة برمجة تطبيقات "الملف التجاري على Google".

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

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

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

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

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

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

  • https://mybusinessaccountmanagement.googleapis.com

مورد REST: v1.accounts

الطُرق
create POST /v1/accounts
تنشئ حسابًا بالاسم والنوع المحدّدَين ضمن العنصر الرئيسي المحدّد.
get GET /v1/{name=accounts/*}
الحصول على الحساب المحدّد
list GET /v1/accounts
يتم عرض جميع حسابات المستخدم الذي تمت مصادقته.
patch PATCH /v1/{account.name=accounts/*}
يعدّل حساب النشاط التجاري المحدّد.

مورد REST: v1.accounts.admins

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

مورد REST: v1.accounts.invitations

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

مورد REST: v1.locations

الطُرق
transfer POST /v1/{name=locations/*}:transfer
لنقل موقع جغرافي من حساب يملكه المستخدم إلى حساب آخر يشرف عليه المستخدم نفسه.

مورد REST: v1.locations.admins

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