التوافق مع Content API for Shopping

يمكنك استخدام هذا الدليل لدمج Merchant API مع تنفيذ Content API for Shopping الحالي.

البدء

راجِع تصميم Merchant API للحصول على تفاصيل حول Merchant API وواجهات برمجة التطبيقات الفرعية الخاصة بها

لبدء استخدام Merchant API، عليك تغيير عناوين URL الخاصة بطلباتك إلى ما يلي: التنسيق:

https://merchantapi.googleapis.com/{sub-API}/{version}/{resource name}/{service}:{method}…

يمكنك الاطّلاع على دليل البدء السريع مرجع Merchant API للحصول على مزيد من المعلومات

دعم gRPC

تتيح واجهة Merchant API استخدام gRPC وREST. يمكنك استخدام gRPC لواجهة Merchant API وREST لواجهة Content API for Shopping في الوقت نفسه. الوقت.

تتطلّب مكتبات عملاء Merchant API. gRPC.

راجع استخدام gRPC لمزيد من المعلومات المعلومات.

التوافق

يصف هذا الدليل التغييرات العامة التي تنطبق على Merchant API بالكامل. عرض الأدلة التالية حول التغييرات في ميزات محددة:

• نقل الحسابات لإدارة الحسابات
• نقل إعدادات الشحن
• إدارة المنتجات
• نقل إدارة مصادر البيانات
• نقل بيانات إدارة المستودعات
• نقل بيانات إدارة العروض الترويجية
• نقل بيانات إدارة إعداد التقارير
• نقل إدارة مصادر الإحالات الناجحة
• نقل بيانات إدارة الشراكات في الخلاصات المحلية

تم تصميم Merchant API لتعمل إلى جانب Content API for Shopping الحالي. الإصدار 2.1.

على سبيل المثال، يمكنك استخدام واجهة Merchant Inventories API إلى جانب واجهة برمجة التطبيقات الحالية مستودعات الإصدار 2.1 من Content API for Shopping تنفيذ products. إِنْتَ Content API for Shopping لتحميل محلي جديد المنتج (التي تبيعها) في متجر محلي)، ثم استخدام واجهة برمجة التطبيقات Merchant Inventories API LocalInventory لإدارة المعلومات في المتجر لهذا المنتج.

ملاحظة: لا يمكننا ضمان التوافق الكامل مع الإصدارات القديمة للميزات المشابهة. بين Content API for Shopping وMerchant API بسبب التحسين التصميم. على سبيل المثال، أسماء الحقول أو طريقة التوفّر. بالنسبة إلى المورد نفسه في Content API for Shopping Merchant API:

الطلبات المجمّعة

لا تتيح واجهة Merchant API استخدام طريقة customBatch الواردة في Content API في Shopping: بدلاً من ذلك، راجِع إرسال الدفعة بشكل مجمّع. الطلبات. في حال استخدام customBatch إلى هذه الميزة في Merchant API، يُرجى إعلامنا بالسبب في ذلك ملاحظاتك

المعرفات

للتوافق مع مبادئ تحسين واجهات برمجة التطبيقات من Google، تم إجراء بعض التغييرات على معرّفات موارد واجهة برمجة التطبيقات للتاجر.

سيحل الاسم محل المعرّف

تستخدم كل موارد Merchant API الحقل name كمعرّف فريد.

إليك مثال على كيفية استخدام حقل name في المكالمات:

POST https://merchantapi.googleapis.com/inventories/v1beta/{parent}/regionalInventories:insert

يتم عرض حقل name الجديد هذا كمعرّف مورد لجميع عمليات القراءة كتابة الاتصالات في Merchant API.

تستخدم القيمة المعروضة في حقول name تنسيق المعرّف الجديد.

ملاحظة مهمة: ننصحك باستخدام القيمة من الحقل name مباشرةً في بدلاً من تحليل أو إنشاء اسم مورد يدويًا لتجنب المشاكل.

على سبيل المثال، يمكنك استخدام طريقة getName() لاسترداد name من وتخزين المخرجات كمتغير بدلاً من إنشاء name من معرّفات التجّار والموارد بنفسك

التنسيق الجديد لرقم التعريف

ملاحظة: ستعرض واجهة Merchant API معرّفات بدون قيمة channel حتى تشرين الثاني (نوفمبر) 13 فبراير 2023 وبعد 13 تشرين الثاني (نوفمبر)، ستعرض جميع الطلبات معرّف المورد الكامل. إِنْتَ يجب استخدام معرّف المورد الكامل، بما في ذلك channel، في مكالماتك بحلول 1 شباط (فبراير)، 2024.

في Merchant API، تستخدم معرّفات الموارد التنسيق التالي: channel~language~feedLabel~offerId

استخدمت موارد Content API القيمة : بدلاً من ~ بين كل قيمة في رقم التعريف: channel:language:feedLabel:offerId

تعرض كل طلبات البيانات من واجهة Merchant API التنسيق الجديد مع ~ بين قيم رقم التعريف ننصحك بتخزين التنسيق الجديد من الردّ واستخدامه في في المستقبل.

الحقول الرئيسية للموارد الفرعية

في Merchant API، تحتوي كل الموارد الفرعية على الحقل parent. يمكنك استخدام الحقل parent لتحديد name للمورد الذي سيتم إدراج العنصر الثانوي فيه، بدلاً من تمرير المورد الأصلي بأكمله. يمكنك أيضًا استخدام parent. مع list طريقة لإدراج الموارد الفرعية لهذه parent.

على سبيل المثال، لإدراج المنتجات المتوفرة داخل المتجر لمنتج معيّن، يجب تحديد name للمنتج في parent الحقل الخاص list . في هذه الحالة، تكون السمة product المحدّدة هي parent LocalInventory تم إرجاع موارد.

الأنواع

في ما يلي بعض الأنواع الشائعة التي تتم مشاركتها بين واجهات برمجة التطبيقات الفرعية الخاصة بـ Merchant API.

السعر

في ما يلي التغييرات التي طرأت على Price في حزمة Merchant Common:

	Content API	واجهة برمجة تطبيقات التاجر
حقل المبلغ	value:string	amountMicros:int64
حقل العملة	currency:string	currencyCode:string

إنّ مبلغ Price مسجَّل الآن بالمايكرو، حيث يتم قياس مليون ميكرو ثانية. أي قيمة تعادل الوحدة القياسية لعملتك.

في Content API for Shopping، كان Price رقمًا عشريًا في شكل السلسلة.

تمّ تغيير اسم حقل المبلغ من value إلى amountMicros.

تمّ تغيير اسم حقل العملة من currency إلى currencyCode. تشير رسالة الأشكال البيانية بتنسيق ISO 4217.