My Business Business Information API

توفّر واجهة My Business Business Information API واجهة لإدارة معلومات النشاط التجاري على Google. ملاحظة: إذا كانت لديك حصة تبلغ 0 بعد تفعيل واجهة برمجة التطبيقات، يُرجى طلب الوصول إلى واجهة برمجة التطبيقات GBP API على الرابط https://developers.google.com/my-business/content/prereqs#request-access.

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

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

مستند الاستكشاف

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

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

نقطة نهاية الخدمة هي الجزء الأساسي من عنوان URL الذي يحدّد عنوان الشبكة لخدمة واجهة برمجة التطبيقات. قد يكون للخدمة الواحدة أكثر من نقطة نهاية واحدة. تحتوي هذه الخدمة على نقطة النهاية التالية، وجميع عناوين URI أدناه تكون نسبيّة لهذه النقطة:

  • https://mybusinessbusinessinformation.googleapis.com

مورد REST:‏ v1.accounts.locations

الطُرق
create POST /v1/{parent=accounts/*}/locations
يتم إنشاء موقع جغرافي جديد يملكه المستخدم الذي سجّل الدخول.
list GET /v1/{parent=accounts/*}/locations
يسرد المواقع الجغرافية للحساب المحدّد.

مورد REST:‏ v1.attributes

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

مورد REST:‏ v1.categories

الطُرق
batchGet GET /v1/categories:batchGet
تعرض هذه الطريقة قائمة بفئات العمل التجاري للغة المحدّدة ومعرّفات GConcept.
list GET /v1/categories
تعرض هذه السمة قائمة بفئات العمل التجاري.

مورد REST:‏ v1.chains

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

مورد REST:‏ v1.googleLocations

الطُرق
search POST /v1/googleLocations:search
البحث في جميع المواقع الجغرافية المحتملة التي تتطابق مع الطلب المحدّد

مورد REST:‏ v1.locations

الطُرق
delete DELETE /v1/{name=locations/*}
لحذف موقع جغرافي
get GET /v1/{name=locations/*}
تعرض هذه السمة الموقع الجغرافي المحدّد الذي ضبطه التاجر مؤخرًا.
getAttributes GET /v1/{name=locations/*/attributes}
تسترد هذه السمة سمات الموقع الجغرافي كما حدّدها التاجر آخر مرة.
getGoogleUpdated GET /v1/{name=locations/*}:getGoogleUpdated
تعرض هذه السمة الموقع الجغرافي المحدّد كما يظهر على "خرائط Google" و"بحث Google".
patch PATCH /v1/{location.name=locations/*}
يتم تعديل الموقع الجغرافي المحدّد.
updateAttributes PATCH /v1/{attributes.name=locations/*/attributes}
تعديل السمات لموقع جغرافي معيّن

مورد REST:‏ v1.locations.attributes

الطُرق
getGoogleUpdated GET /v1/{name=locations/*/attributes}:getGoogleUpdated
تسترد هذه الطريقة سمات موقع جغرافي معيّن كما تظهر مباشرةً على "خرائط Google" و"بحث Google".

مورد REST:‏ v1alpha.accounts.locations

الطُرق
create POST /v1alpha/{parent=accounts/*}/locations
يتم إنشاء موقع جغرافي جديد يملكه المستخدم الذي سجّل الدخول.
list GET /v1alpha/{parent=accounts/*}/locations
يسرد المواقع الجغرافية للحساب المحدّد.

مورد REST:‏ v1alpha.attributes

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

مورد REST:‏ v1alpha.categories

الطُرق
batchGet GET /v1alpha/categories:batchGet
تعرض هذه الطريقة قائمة بفئات العمل التجاري للغة المحدّدة ومعرّفات GConcept.
list GET /v1alpha/categories
تعرض هذه السمة قائمة بفئات العمل التجاري.

مورد REST:‏ v1alpha.chains

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

مورد REST:‏ v1alpha.googleLocations

الطُرق
search POST /v1alpha/googleLocations:search
البحث في جميع المواقع الجغرافية المحتملة التي تتطابق مع الطلب المحدّد

مورد REST:‏ v1alpha.locations

الطُرق
delete DELETE /v1alpha/{name=locations/*}
لحذف موقع جغرافي
get GET /v1alpha/{name=locations/*}
تعرض هذه السمة الموقع الجغرافي المحدّد الذي ضبطه التاجر مؤخرًا.
getAttributes GET /v1alpha/{name=locations/*/attributes}
تسترد هذه السمة سمات الموقع الجغرافي كما حدّدها التاجر آخر مرة.
getExtended GET /v1alpha/{name=locations/*}:getExtended
تعرض هذه السمة الموقع الجغرافي المحدّد مع بيانات وصفية موسّعة.
getGoogleUpdated GET /v1alpha/{name=locations/*}:getGoogleUpdated
تعرض هذه السمة الموقع الجغرافي المحدّد كما يظهر على "خرائط Google" و"بحث Google".
patch PATCH /v1alpha/{location.name=locations/*}
يتم تعديل الموقع الجغرافي المحدّد.
updateAttributes PATCH /v1alpha/{attributes.name=locations/*/attributes}
تعديل السمات لموقع جغرافي معيّن

مورد REST:‏ v1alpha.locations.attributes

الطُرق
getExtended GET /v1alpha/{name=locations/*/attributes}:getExtended
تعرض هذه السمة السمات المحدّدة مع بيانات وصفية موسّعة.
getGoogleUpdated GET /v1alpha/{name=locations/*/attributes}:getGoogleUpdated
تسترد هذه الطريقة سمات موقع جغرافي معيّن كما تظهر مباشرةً على "خرائط Google" و"بحث Google".