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

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

يمكنك استخدام Merchant API للوصول إلى المزيد من العملاء وعرض منتجاتك على جميع خدمات Google. يمكنك استخدام Merchant API لإدارة حسابات Merchant Center الكبيرة أو المعقّدة. تشمل بعض حالات الاستخدام الشائعة ما يلي:

  • إدارة الحسابات المبرمَجة
  • إدارة المنتجات تلقائيًا
  • إدارة المستودع الإعلاني تلقائيًا
  • إعداد التقارير المخصّصة

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

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

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

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

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

لمزيد من المعلومات، يُرجى الاطّلاع على الميزات الجديدة التي تمّ تقديمها في Merchant API الإصدار التجريبي.

قبل البدء

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

  • حساب 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
  1. أنشئ نص الطلب كوحدة تخزين بروتوكول.
  2. أرسِل نص الطلب إلى الخادم باستخدام HTTP/2.
  3. فك ترميز الردّ إلى وحدة تخزين مؤقت للبروتوكول
  4. تفسير النتائج.
  1. أنشئ نص الطلب ككائن JSON.
  2. أرسِل الطلب إلى الخادم باستخدام HTTP 1.1.
  3. فك ترميز الاستجابة ككائن JSON.
  4. تفسير النتائج.

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

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

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

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

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

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

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

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

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

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

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

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

التالي
تصميم