بدء استخدام Merchant API

فعِّل Merchant API في مشروعك على Cloud لبدء استخدام الميزة.

في ما يلي كيفية استخدام Merchant API:

استخدام مكتبات العملاء

تتألّف واجهة Merchant API من عدّة واجهات برمجة تطبيقات فرعية.

تحتوي كل واجهة برمجة تطبيقات فرعية على عيّنات رموز برمجية و مكتبات عملاء لمساعدتك على البدء.

إذا كنت تستخدم Content API for Shopping، يُرجى الاطّلاع على توافق Content API for Shopping.

إرسال الطلبات

تستخدِم Merchant API أسماء الموارد بدلاً من أرقام التعريف للقيام بعملية التعرّف. يمكن أن يكون مثال على اسم مورد لمنتج هو accounts/123/products/online~en~US~sku123، حيث يكون 123 هو المعرّف الفريد للحساب وonline~en~US~sku123 هو المعرّف الفريد للمنتج.

للعمل على أحد الموارد، أرسِل الطلبات إلى عناوين URL بالتنسيق التالي:

https://merchantapi.googleapis.com/{sub-API}/{version}/{resource name}:{method}

على سبيل المثال، سيؤدي هذا الطلب إلى حذف المستودع الإقليمي:

DELETE https://merchantapi.googleapis.com/inventories/v1beta/accounts/123/products/online~en~US~sku123/regionalInventories/456

لإنشاء مرجع جديد، يمكنك استخدام اسم المرجع للمرجع الرئيسي وعنوان URL التالي.

POST https://merchantapi.googleapis.com/{sub-API}/{version}/{resource name of parent}/{resource}

على سبيل المثال، إليك كيفية إنشاء منطقة جديدة account/123

POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/123/regions

اطّلِع على المستندات المرجعية لواجهة برمجة التطبيقات Merchant API للحصول على مزيد من التفاصيل حول خدمات معيّنة.

استخدام gRPC أو REST

تتيح واجهة Merchant API استخدام gRPC وREST. في ما يلي طريقتان لإجراء طلبات البيانات من Merchant API:

gRPC (يُنصح به) REST
  1. إنشاء نص الطلب كمخزن مؤقت للبروتوكول
  2. أرسِل نص الطلب إلى الخادم باستخدام HTTP/2.
  3. فك ترميز الردّ إلى وحدة تخزين مؤقت للبروتوكول
  4. تفسير النتائج.
  1. أنشئ نص الطلب ككائن JSON.
  2. أرسِل الطلب إلى الخادم باستخدام HTTP 1.1.
  3. فك ترميز الاستجابة ككائن JSON.
  4. تفسير النتائج.

الحصول على مساعدة

للحصول على معلومات حول الحصول على الدعم، يُرجى الاطّلاع على الحصول على مساعدة بشأن Merchant API.

تقديم التعليقات

تمنحنا الفترة التجريبية فرصة لجمع ملاحظاتك والردّ عليها قبل طرح الإصدار العلني. لتقديم الملاحظات، يُرجى إرسال أحد العناصر التالية:

  • ميزات واجهة برمجة التطبيقات: أرسِل نموذج الملاحظات.
  • المستندات: استخدِم تقييمات الإبهام داخل الصفحة وزر إرسال ملاحظات.
  • عيّنات ومكتبات: استخدِم الزر مشكلة جديدة على GitHub.

لتقديم ملاحظات عامة بعد تنفيذ كل مهمة، استخدِم نموذج الملاحظات.

السابق
حالة الإطلاق
التالي
نظرة عامة