نظرة عامة على 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. أنشِئ الرابط من خلال استدعاء طريقة Developer Registration (تسجيل المطوّر). ستستخدم هذا الحساب وهؤلاء المستخدمين للتواصل بشأن دمج واجهة برمجة التطبيقات والاستطلاعات والفرص.

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

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

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

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

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

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

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

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

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

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

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

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

التالي
Merchant API terms and conditions