يمكنك استخدام هذا الدليل لدمج 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
لإدارة المعلومات في المتجر لهذا المنتج.
الطلبات المجمّعة
لا تتيح واجهة 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
تنسيق المعرّف الجديد.
على سبيل المثال، يمكنك استخدام طريقة getName()
لاسترداد name
من
وتخزين المخرجات كمتغير بدلاً من إنشاء name
من معرّفات التجّار والموارد بنفسك
التنسيق الجديد لرقم التعريف
في 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.