نظرة عامة على Merchant API

يمكنك استخدام Merchant API لإجراء ما يلي:

• إدارة طريقة ظهور نشاطك التجاري ومنتجاتك على Google
• يمكنك الوصول آليًا إلى البيانات والإحصاءات والميزات الفريدة.
• يمكنك تطوير نشاطك التجاري والوصول إلى المزيد من العملاء على Google.

يمكن أن تدير Merchant API حسابات كبيرة أو معقّدة على Merchant Center. تشمل حالات الاستخدام النموذجية ما يلي:

• إدارة الحسابات آليًا
• إدارة المنتجات آليًا
• نظام إدارة المخزون الآلي
• إدارة التقارير الآلية حول الأداء وإحصاءات السوق

تتيح لك واجهة Merchant API إنشاء مصادر بيانات متعدّدة وإدارتها، ما يتيح تنظيم المعلومات بشكل أفضل حول المنتجات والعروض الترويجية والمراجعات. باستخدام Merchant API، يمكنك إدارة المنتجات بطريقة تكمل طُرق تحميل بيانات المنتجات الأخرى، مثل الملفات والخلاصة المبرمَجة. تتيح لك Merchant API أيضًا تنفيذ طلبات فردية متعددة في الوقت نفسه.

إنّ Merchant API هي إعادة تصميم Content API for Shopping. وتتضمّن هذه الواجهة عدة واجهات برمجة تطبيقات فرعية.

ملاحظة: يتحمّل بائعو التجزئة مسؤولية الالتزام بسياسات إعلانات Shopping والبيانات المجانية. تحتفظ Google Shopping بالحق في فرض هذه السياسات واتّخاذ الإجراءات اللازمة إذا عثرنا على محتوى أو سلوك يخالفها.

الميزات الجديدة في Merchant API

في ما يلي بعض الأسباب التي تستدعي الترقية إلى Merchant API:

• إدارة أفضل لبيانات المستودعات من خلال تقديم الطرق الجديدة التالية:

  • accounts.products.localInventories.delete
  • accounts.products.localInventories.list
  • accounts.products.regionalInventories.delete
  • accounts.products.regionalInventories.list

• تتيح هذه الإضافة إدارة مصادر البيانات التكميلية من خلال إنشاء مصادر البيانات التكميلية واسترجاعها، ومن خلال ربط مصادر البيانات التكميلية بمصادر البيانات الأساسية.

• تتيح هذه السمة تلقّي إشعارات بشأن التغييرات التي تطرأ على بيانات منتجاتك، ما يغنيك عن إجراء عمليات جلب دورية من خلال إعلامك عند تغيُّر حالة أحد المنتجات.

• تضيف هذه السمة accounts.autofeedSettings المورد والطرق اللازمة لاسترداد إعدادات الخلاصة المبرمَجة وتعديلها.

• تم طرح ميزة تحميل مراجعات المنتجات ومراجعات التجّار.

• تعرِّف هذه السمة على المرجع accounts.productInputs لتبسيط المرجع accounts.products.

• تتيح تعديل بيانات المنتجات بالتزامن مع طرق تحميل البيانات الأخرى، مثل الملفات.

• جدول NonProductPerformanceView جديد لبيانات الأداء غير المتعلّقة بالمنتجات، مثل معلومات حول الزيارات الواردة إلى الموقع الإلكتروني لبائع التجزئة

• تصميم معياري يتضمّن تحسينات معزولة وأكثر تكرارًا على الميزات

• تعديلات على المستندات وعيّنات التعليمات البرمجية

• تحسين المواءمة مع مقترحات تحسين واجهة برمجة التطبيقات من Google

• تحسين الدعم والتواصل مع المطوّرين من خلال تسجيل المطوّرين

قبل البدء

لتنفيذ طلب بيانات من واجهة برمجة التطبيقات من خلال Merchant API، يجب أن يتوفّر لديك ما يلي:

• حساب على Merchant Center: هذا هو الحساب الذي ستجري فيه عمليات البحث والتعديل وتحميل البيانات. تأكَّد من أنّ لديك الأذونات اللازمة لإدارة المنتجات والمستودعات في هذا الحساب.

• مشروع على Google Cloud: استخدِم المشروع للوصول إلى واجهة برمجة التطبيقات في حسابك.

• رابط من حسابك على Merchant Center إلى مشروع على السحابة الإلكترونية في Google Cloud. أنشئ الرابط من خلال استدعاء طريقة "تسجيل المطوّر". ستستخدم هذا الحساب وهؤلاء المستخدمين للتواصل بشأن عملية دمج واجهة برمجة التطبيقات والاستطلاعات والفرص المتاحة.

ملاحظة: إذا كنت شريكًا وليس لديك حساب على Merchant Center، عليك إنشاء حساب تاجر وإعداده، بما في ذلك إضافة مستخدم واحد على الأقل لديه دور مطوّر واجهة برمجة التطبيقات، وهو الشخص المسؤول بشكل أساسي عن عملية الدمج.

• اربط حسابك على Merchant Center بمشروع Google Cloud من خلال التسجيل كمطوّر. سيتلقّى المستخدمون الذين لديهم دور مطوّر واجهة برمجة التطبيقات الرسائل المتعلقة بواجهة برمجة التطبيقات، بما في ذلك الإشعارات الإلزامية عن الخدمة والاستطلاعات المخصصة للمطوّرين والفرص المتاحة لهم.

ملاحظة: إذا كنت شريكًا وليس لديك حساب على Merchant Center، عليك إنشاء حساب تاجر وإعداده، بما في ذلك إضافة مستخدم واحد على الأقل لديه دور مطوّر واجهة برمجة التطبيقات أثناء عملية التسجيل وهو المسؤول الأساسي عن عملية الدمج.

المصادقة باستخدام Merchant API

يمكنك استخدام الخيارات التالية للمصادقة:

• يمكنك إنشاء معرّف عميل وكلمة سر لبروتوكول OAuth 2.0 لتطبيقك. ويمكنك بعد ذلك استخدام المعرّف وكلمة السر لإنشاء بيانات اعتماد OAuth 2.0 المطلوبة في طلبات البيانات من واجهة برمجة التطبيقات إلى حساب Merchant Center.
• يمكنك إنشاء حساب خدمة وتنزيل مفتاحه الخاص لإجراء طلبات البيانات من واجهة برمجة التطبيقات.

معرّفات الحسابات والمنتجات

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

تنسيق عنوان URL الخاص بالطلب

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

https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME}:{METHOD}

يتم حذف الجزء :{METHOD} للطرق العادية مثل list وget.

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

DELETE https://merchantapi.googleapis.com/inventories/v1/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/v1/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
أنشئ نص الطلب كـ Protocol Buffers. أرسِل نص الطلب إلى الخادم باستخدام HTTP/2. إلغاء تسلسل الردّ إلى مخزن مؤقت للبروتوكول تفسير النتائج.	أنشئ نص الطلب كعنصر JSON. أرسِلها إلى الخادم باستخدام HTTP 1.1. إلغاء تسلسل الردّ كعنصر JSON تفسير النتائج.

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

استخدام مكتبات العملاء ونماذج الرموز البرمجية

تتضمّن كل واجهة برمجة تطبيقات فرعية مكتبات برامج لمساعدتك في بدء الاستخدام. يمكن أن تساعدك عيّنات الرموز البرمجية في البدء بكتابة الرموز بلغات Java وPHP وPython. لمزيد من المعلومات، يُرجى الاطّلاع على أمثلة على Merchant API.

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

للحصول على معلومات حول كيفية تلقّي الدعم، اطّلِع على الحصول على المساعدة بشأن Merchant API.

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

لتقديم ملاحظات، يُرجى إرسال أحد الخيارات التالية:

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

الخطوات التالية

• للحصول على معلومات حول التوافق مع الأنظمة القديمة، يُرجى الاطّلاع على توافق Content API for Shopping.

• لمعرفة المزيد حول الميزات الرئيسية في Merchant API، اطّلِع على الأدلة في قائمة التنقّل اليمنى.

• للحصول على معلومات حول المراجع والخدمات المتاحة، يُرجى الاطّلاع على المستندات المرجعية.