فعِّل 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 |
|---|---|
|
|
الحصول على مساعدة
للحصول على معلومات عن الحصول على الدعم، يُرجى الاطّلاع على مقالة الحصول على مساعدة بشأن Merchant API.
تقديم التعليقات
تمنحنا الفترة التجريبية فرصة لجمع ملاحظاتك والردّ عليها قبل طرح الإصدار العلني. لإرسال الملاحظات، يُرجى إرسال أحد العناصر التالية:
- ميزات واجهة برمجة التطبيقات: أرسِل نموذج الملاحظات.
- المستندات: استخدِم تقييمات الإبهام داخل الصفحة وزر إرسال ملاحظات.
- عيّنات ومكتبات: استخدِم الزر مشكلة جديدة على GitHub.
لتقديم ملاحظات عامة بعد تنفيذ كل مهمة، استخدِم نموذج الملاحظات.