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

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

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

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

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

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

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

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

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

قبل البدء

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

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

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

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

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

المصادقة باستخدام 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 (مستحسن) راحة
  1. أنشئ نص الطلب كـ Protocol Buffers.
  2. أرسِل نص الطلب إلى الخادم باستخدام HTTP/2.
  3. ألغِ تسلسل الردّ إلى Protocol Buffers.
  4. فسِّر النتائج.
  1. أنشئ نص الطلب كعنصر JSON.
  2. أرسِله إلى الخادم باستخدام HTTP 1.1.
  3. ألغِ تسلسل الردّ كعنصر JSON.
  4. فسِّر النتائج.

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

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

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

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

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

لتقديم ملاحظات، أرسِل أحد الخيارَين التاليَين:

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

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

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

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

السابق
Latest updates
التالي
Design