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

تفعيل Merchant API في مشروع على السحابة الإلكترونية لبدء استخدامها

إليك كيفية استخدام 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}

ملاحظة: يتم حذف الجزء :{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 (يُنصح به)	راحة
إنشاء نص الطلب كمخزن مؤقت للبروتوكول أرسِل نص الطلب إلى الخادم باستخدام HTTP/2. إلغاء تكرار الاستجابة للمخزن المؤقت للبروتوكولات. تفسير النتائج.	إنشاء نص الطلب ككائن JSON. أرسِل الطلب إلى الخادم باستخدام HTTP 1.1. فك ترميز الاستجابة ككائن JSON. تفسير النتائج.

ملاحظة: في حال استخدام مكتبة عملاء، تكون آلية النقل التلقائية هي gRPC. في معظم الحالات، لا تحتاج إلى اتخاذ أي إجراء سوى استدعاء نقاط نهاية Merchant API لاستخدام gRPC.

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

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

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

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

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

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