تقدّم هذه الصفحة مقدمة عن Merchant API وتوضّح كيفية استخدامها لأتمتة مختلف مهام سير العمل المتعلقة بإدارة الحسابات والمنتجات والمستودعات في Merchant Center.
يمكنك استخدام Merchant API للوصول إلى المزيد من العملاء وعرض منتجاتك على جميع خدمات Google. يمكنك استخدام Merchant API لإدارة حسابات كبيرة أو معقّدة على Merchant Center. تشمل بعض حالات الاستخدام النموذجية ما يلي:
- إدارة الحسابات آليًا
- إدارة المنتجات آليًا
- إدارة المستودع الآلية
- إعداد التقارير المخصّصة
تتيح لك Merchant API إنشاء مصادر بيانات متعدّدة وإدارتها، ما يتيح تنظيم المعلومات بشكل أفضل حول المنتجات والعروض الترويجية والمراجعات. باستخدام Merchant API، يمكنك إدارة المنتجات بطريقة تتكامل مع طرق تحميل بيانات المنتجات الأخرى، مثل الملفات والخلاصة التلقائية. تتيح لك واجهة برمجة التطبيقات Merchant أيضًا تنفيذ طلبات فردية متعددة بالتوازي.
Merchant API هي إعادة تصميم Content API for Shopping. وتتضمّن هذه الواجهة عدة واجهات برمجة تطبيقات فرعية.
الميزات الجديدة في Merchant API
في ما يلي بعض الأسباب التي تستدعي الترقية إلى Merchant API:
إدارة أفضل لبيانات المستودعات من خلال تقديم الطرق الجديدة التالية:
تتيح هذه الميزة إدارة مصادر البيانات التكميلية من خلال إنشاء مصادر البيانات التكميلية واسترجاعها، ومن خلال ربط مصادر البيانات التكميلية بمصادر البيانات الأساسية.
تتيح هذه السمة تلقّي إشعارات بشأن التغييرات التي تطرأ على بيانات منتجاتك، ما يلغي الحاجة إلى إجراء عمليات جلب دورية من خلال إرسال إشعار إليك عند تغيُّر حالة المنتج.
تضيف هذه السمة
accounts.autofeedSettings
المورد وطُرق استرداد إعدادات التغذية التلقائية وتعديلها.تم طرح ميزة تحميل مراجعات المنتجات ومراجعات التجّار.
تم تبسيط مورد
accounts.products
من خلال تقديم موردaccounts.productInputs
.يتيح تعديل بيانات المنتجات بالتزامن مع طرق أخرى لتحميل البيانات، مثل الملفات.
جدول
NonProductPerformanceView
جديد لبيانات الأداء غير المتعلّقة بالمنتجات، مثل المعلومات حول الزيارات الواردة إلى الموقع الإلكتروني لأحد بائعي التجزئة.تصميم نموذجي يتضمّن تحسينات معزولة ومتكرّرة على الميزات
تحسين المواءمة مع اقتراحات تحسين واجهة برمجة التطبيقات من Google
تم تعديل المستندات وعيّنات التعليمات البرمجية.
تحسين الدعم والتواصل مع المطوّرين من خلال تسجيل المطوّرين
لمزيد من المعلومات، يُرجى الاطّلاع على الميزات الجديدة التي تمّ تقديمها في الإصدار التجريبي من Merchant API.
قبل البدء
لتنفيذ طلب من خلال Merchant API، يجب أن يتوفّر لديك ما يلي:
حساب على Merchant Center: هذا هو الحساب الذي ستجري فيه عمليات البحث والتعديل وتحميل البيانات. تأكَّد من أنّ لديك الأذونات اللازمة لإدارة المنتجات والمستودعات في هذا الحساب.
مشروع على Google Cloud: يُستخدَم المشروع للحصول على إذن بالوصول إلى واجهة برمجة التطبيقات الخاصة بحسابك.
اربط حسابك على Merchant Center بمشروع Google Cloud من خلال استدعاء طريقة تسجيل المطوّرين. سيتلقّى مستخدمو الحساب المرتبط رسائل من واجهة برمجة التطبيقات، بما في ذلك إشعارات الخدمة الإلزامية واستطلاعات المطوّرين والفرص.
المصادقة باستخدام Merchant API
يمكنك استخدام الخيارات التالية للمصادقة:
- يمكنك إنشاء معرّف عميل وسر عميل OAuth 2.0 لتطبيقك. ويمكنك بعد ذلك استخدام المعرّف والسر لإنشاء بيانات اعتماد OAuth 2.0 اللازمة في طلبات البيانات من واجهة برمجة التطبيقات إلى حساب Merchant Center.
- يمكنك إنشاء حساب خدمة وتنزيل مفتاحه الخاص لإجراء طلبات البيانات من واجهة برمجة التطبيقات.
معرّفات الحسابات والمنتجات
تستخدِم Merchant API أسماء الموارد بدلاً من المعرّفات لتحديد الهوية. يمكن أن يكون اسم المورد الخاص بالمنتج على سبيل المثال
accounts/123456/products/online~en~US~sku123
، حيث 123456
هو المعرّف الفريد للحساب وonline~en~US~sku123
هو المعرّف الفريد للمنتج.
تنسيق عنوان URL الخاص بالطلب
لإجراء عمليات على أحد الموارد، أرسِل طلبات إلى عناوين URL بالتنسيق التالي:
https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME}:{METHOD}
يتم حذف الجزء :{METHOD}
للطرق العادية، مثل list وget.
على سبيل المثال، يؤدي الطلب التالي إلى حذف المستودع الإقليمي:
DELETE https://merchantapi.googleapis.com/inventories/v1beta/accounts/123456/products/online~en~US~sku123/regionalInventories/456
لإنشاء مرجع، يمكنك استخدام اسم المرجع الخاص بالمرجع الرئيسي وعنوان URL التالي:
POST https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME_OF_PARENT}/{RESOURCE}
على سبيل المثال، يوضّح الطلب التالي كيفية
إنشاء منطقة
لـ accounts/123456
:
POST https://merchantapi.googleapis.com/accounts/v1beta/accounts/123456/regions?regionId=WA HTTP/1.1
{
"displayName": "Washington",
"name": "Washington",
"postalCodeArea": {
"postalCodes": [
{
"begin": "98039",
"end": "98118"
}
],
"regionCode": "US"
}
}
لمزيد من التفاصيل حول خدمات معيّنة، يُرجى الاطّلاع على المستندات المرجعية الخاصة بواجهة Merchant API.
بدء استخدام Merchant API
للتعرّف بسرعة على طريقة عمل Merchant API وتجربة تحميل منتج نموذجي، يمكنك الاطّلاع على بدء استخدام Merchant API.
استخدام gRPC أو REST
تتيح Merchant API استخدام gRPC وREST. في ما يلي الطريقتان لإجراء طلبات بيانات من واجهة Merchant API:
gRPC (مستحسن) | REST |
---|---|
|
|
استخدام مكتبات البرامج النموذجية وعيّنات الرموز البرمجية
تتضمّن كل واجهة برمجة تطبيقات فرعية مكتبات برامج لمساعدتك في البدء. يمكن أن تساعدك عيّنات الرموز في البدء بكتابة الرموز بلغات Java وPHP وPython. لمزيد من المعلومات، يُرجى الاطّلاع على أمثلة على Merchant API.
الحصول على مساعدة
للحصول على معلومات حول كيفية الحصول على الدعم، يُرجى الاطّلاع على الحصول على المساعدة بشأن Merchant API.
تقديم التعليقات
تتيح لنا الفترة التجريبية جمع ملاحظاتك ومعالجتها قبل طرح الإصدار المتاح للجميع. لتقديم ملاحظات، يُرجى إرسال أحد الخيارات التالية:
- ميزات واجهة برمجة التطبيقات: إرسال نموذج الملاحظات
- المستندات: استخدِم تقييمات الإعجاب وعدم الإعجاب داخل الصفحة وزر إرسال ملاحظات.
- العيّنات والمكتبات: إنشاء مشكلة في مستودع GitHub لعيّنات الرموز
لتقديم ملاحظات عامة بعد تنفيذ كل مهمة، استخدِم نموذج الملاحظات.
الخطوات التالية
للحصول على معلومات حول التوافق مع الإصدارات السابقة، يُرجى الاطّلاع على توافق Content API في Shopping.
لمعرفة المزيد عن الميزات الرئيسية في Merchant API، راجِع الأدلة في قائمة التنقّل اليمنى.
للحصول على معلومات حول المراجع والخدمات المتاحة، يُرجى الاطّلاع على المستندات المرجعية.