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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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