يمكنك استخدام custombatch من أجل insert أو get أو delete منتجات متعددة دفعة واحدة.
الوقت في طلب بيانات واحد من واجهة برمجة التطبيقات.
استخدِم عنوان URL للطلب التالي لإجراء طلب بواجهات برمجة تطبيقات الدُفعات المخصَّصة:
POST https://shoppingcontent.googleapis.com/content/v2.1/products/batch
يحتوي نص الطلب على مَعلمات محدَّدة: batchId وmerchantID
وmethod.
لا تستخدِم productId إلا إذا كنت بصدد تنفيذ طلب الحصول أو الحذف. productId
غير مطلوب عند إدخال طلب بيانات من واجهة برمجة التطبيقات في custombatch.
custombatch:insert
يتم استخدام عنوان URL للطلب التالي لإنشاء products.custombatch method=insert
POST https://shoppingcontent.googleapis.com/content/v2.1/products/batch
لإدراج المنتجَين الجديدَين، حدِّد السمة batchId لكل منتج،
merchantId من التاجر المفوّض لإجراء طلب بيانات من واجهة برمجة التطبيقات والطريقة
insert
في المثال التالي، قيمتا batchId هما 1111 و1112.
على التوالي، وهي معرّفات فريدة لكل منتج تشير السمة merchantId:
1234567 إلى التاجر المصرّح له بإجراء طلب بيانات من واجهة برمجة التطبيقات، وهي السمة
هي get أو delete أو insert.
تنشئ السمة insert منتجًا جديدًا. إذا كانت هناك قيم للسمات
channel وcontentLanguage وofferId وfeedLabel لقيمة معيّنة
المنتج، تعمل هذه الطريقة على تعديل الإدخال واستبدال جميع البيانات من واجهة برمجة التطبيقات السابقة.
في مكالمات المنتج.
في ما يلي نموذج نص JSON يتضمّن insert قميصَين في Merchant Center
قاعدة بيانات باستخدام استدعاء واجهة برمجة تطبيقات واحد:
{
"entries": [
{
"batchId": 1111,
"merchantId": 1234567,
"method": "insert",
"product": {
"kind": "content#product",
"offerId": "1111111111",
"title": "Google Tee Black",
"description": "The Black Google Tee is available in unisex sizing and
features a retail fit.",
"link": "http://my.site.com/blacktee/",
"imageLink": "https://shop.example.com/.../images/GGOEGXXX1100.jpg",
"contentLanguage": "en",
"targetCountry": "US",
"feedLabel": "US",
"channel": "online",
"ageGroup": "adult",
"availability": "in stock",
"availabilityDate": "2019-01-25T13:00:00-08:00",
"brand": "Google",
"color": "black",
"condition": "new",
"gender": "male",
"googleProductCategory": "1604",
"gtin": "608802531656",
"itemGroupId": "google_tee",
"mpn": "608802531656",
"price": {
"value": "21.99",
"currency": "USD"
},
"sizes": [
"Large"
],
"includedDestination": [
"Shopping"
]
}
},
{
"batchId": 1112,
"merchantId": 1234567,
"method": "insert",
"product": {
"kind": "content#product",
"offerId": "2222222222",
"title": "Google Tee Green",
"description": "100% cotton jersey fabric sets this Google t-shirt above
the crowd. Features the google logo across the chest. Unisex sizing.",
"link": "http://my.site.com/greentee/",
"imageLink": "https://shop.example.com/.../images/GGOEGXXX0906.jpg",
"contentLanguage": "en",
"targetCountry": "US",
"feedLabel": "US",
"channel": "online",
"ageGroup": "adult",
"availability": "in stock",
"availabilityDate": "2019-01-25T13:00:00-08:00",
"brand": "Google",
"color": "green",
"condition": "new",
"gender": "male",
"googleProductCategory": "1604",
"gtin": "608802531649",
"itemGroupId": "google_tee",
"mpn": "608802531649",
"price": {
"value": "21.99",
"currency": "USD"
},
"sizes": [
"Medium"
],
"includedDestination": [
"Shopping"
]
}
}
]
}
عند تنفيذ طلب بيانات ناجح من واجهة برمجة التطبيقات، يتم عرض رمز HTTP 200 واستجابة JSON
بما في ذلك المنتجات التي تم إدراجها. تمثّل هذه السمة تنسيق JSON للعرض.
يشبه ما يلي:
{
"kind": "content#productsCustomBatchResponse",
"entries": [
{
"kind": "content#productsCustomBatchResponseEntry",
"batchId": 1111,
"product": {
"kind": "content#product",
"id": "online:en:US:1111111111",
"offerId": "1111111111",
"title": "Google Tee Black",
"description": "The Black Google Tee is available in unisex sizing and
features a retail fit.",
"link": "http://my.site.com/blacktee/",
"imageLink": "https://shop.example.com/.../images/GGOEGXXX1100.jpg",
"contentLanguage": "en",
"targetCountry": "US",
"feedLabel": "US",
"channel": "online",
"ageGroup": "adult",
"availability": "in stock",
"availabilityDate": "2019-01-25T13:00:00-08:00",
"brand": "Google",
"color": "black",
"condition": "new",
"gender": "male",
"googleProductCategory": "1604",
"gtin": "608802531656",
"itemGroupId": "google_tee",
"mpn": "608802531656",
"price": {
"value": "21.99",
"currency": "USD"
},
"sizes": [
"Large"
],
"includedDestination": [
"Shopping"
]
}
},
{
"kind": "content#productsCustomBatchResponseEntry",
"batchId": 1112,
"product": {
"kind": "content#product",
"id": "online:en:US:2222222222",
"offerId": "2222222222",
"title": "Google Tee Green",
"description": "100% cotton jersey fabric sets this Google t-shirt above
the crowd. Features the google logo across the chest. Unisex sizing.",
"link": "http://my.site.com/greentee/",
"imageLink": "https://shop.example.com/.../images/GGOEGXXX0906.jpg",
"contentLanguage": "en",
"targetCountry": "US",
"feedLabel": "US",
"channel": "online",
"ageGroup": "adult",
"availability": "in stock",
"availabilityDate": "2019-01-25T13:00:00-08:00",
"brand": "Google",
"color": "green",
"condition": "new",
"gender": "male",
"googleProductCategory": "1604",
"gtin": "608802531649",
"itemGroupId": "google_tee",
"mpn": "608802531649",
"price": {
"value": "21.99",
"currency": "USD"
},
"sizes": [
"Medium"
],
"includedDestination": [
"Shopping"
]
}
}
]
}
custombatch:get
يجري عنوان URL الخاص بالطلب التالي مكالمة باستخدام products.custombatch مع
method=get:
POST https://shoppingcontent.googleapis.com/content/v2.1/products/batch
للحصول على منتج، حدِّد سمة batchId الفريدة للمنتج.
لطلب بيانات من واجهة برمجة التطبيقات، فإن merchantId للتاجر المفوّض لإجراء
طلب بيانات من واجهة برمجة التطبيقات والطريقة get وproductId للمنتج الذي يتم استرداده
في ما يلي نموذج لنص طلب JSON لاسترداد المنتجَين.
تم إدراجها باستخدام مثال custombatch:insert السابق، المحدد
باستخدام قيم productId. تكون قيمة batchId فريدة لكل عنصر في القائمة:
{
"entries": [
{
"batchId": 1113,
"merchantId": 1234567,
"method": "get",
"productId": "online:en:US:1111111111"
},
{
"batchId": 1114,
"merchantId": 1234567,
"method": "get",
"productId": "online:en:US:2222222222"
}
]
}
تعرض هذه الاستدعاء رمز HTTP 200 ونص الاستجابة التالي:
{
"kind": "content#productsCustomBatchResponse",
"entries": [
{
"kind": "content#productsCustomBatchResponseEntry",
"batchId": 1113,
"product": {
"kind": "content#product",
"id": "online:en:US:1111111111",
"offerId": "1111111111",
"title": "Google Tee Black",
"description": "The Black Google Tee is available in unisex sizing and features a retail fit.",
"link": "http://my.site.com/blacktee/",
"imageLink": "https://shop.example.com/.../images/GGOEGXXX1100.jpg",
"contentLanguage": "en",
"targetCountry": "US",
"feedLabel": "US",
"channel": "online",
"ageGroup": "adult",
"availability": "in stock",
"availabilityDate": "2019-01-25T13:00:00-08:00",
"brand": "Google",
"color": "black",
"condition": "new",
"gender": "male",
"googleProductCategory": "1604",
"gtin": "608802531656",
"itemGroupId": "google_tee",
"mpn": "608802531656",
"price": {
"value": "21.99",
"currency": "USD"
},
"sizes": [
"Large"
],
"includedDestination": [
"Shopping"
]
}
},
{
"kind": "content#productsCustomBatchResponseEntry",
"batchId": 1114,
"product": {
"kind": "content#product",
"id": "online:en:US:2222222222",
"offerId": "2222222222",
"title": "Google Tee Green",
"description": "100% cotton jersey fabric sets this Google t-shirt above the crowd.
Features the google logo across the chest. Unisex sizing.",
"link": "http://my.site.com/greentee/",
"imageLink": "https://shop.example.com/.../images/GGOEGXXX0906.jpg",
"contentLanguage": "en",
"targetCountry": "US",
"feedLabel": "US",
"channel": "online",
"ageGroup": "adult",
"availability": "in stock",
"availabilityDate": "2019-01-25T13:00:00-08:00",
"brand": "Google",
"color": "green",
"condition": "new",
"gender": "male",
"googleProductCategory": "1604",
"gtin": "608802531649",
"itemGroupId": "google_tee",
"mpn": "608802531649",
"price": {
"value": "21.99",
"currency": "USD"
},
"sizes": [
"Medium"
],
"includedDestination": [
"Shopping"
]
}
}
]
}
custombatch:delete
يتم استخدام عنوان URL للطلب التالي لإنشاء products.custombatch مع
method=delete:
POST https://shoppingcontent.googleapis.com/content/v2.1/products/batch
لحذف منتج، حدِّد السمة batchId التي تقتصر على سمة
المنتج ضمن طلب بيانات من واجهة برمجة التطبيقات، وهو merchantId للتاجر المفوّض
إجراء طلب بيانات من واجهة برمجة التطبيقات، والطريقة delete، وproductId للمنتج
حذف البيانات.
{
"entries": [
{
"batchId": 1115,
"merchantId": 1234567,
"method": "delete",
"productId": "online:en:US:1111111111"
},
{
"batchId": 1116,
"merchantId": 1234567,
"method": "delete",
"productId": "online:en:US:2222222222"
}
]
}
تعرض هذه المكالمة الرمز HTTP 200 والقيم batchId للرمز المحذوف.
العناصر:
{
"kind": "content#productsCustomBatchResponse",
"entries": [
{
"kind": "content#productsCustomBatchResponseEntry",
"batchId": 1115
},
{
"kind": "content#productsCustomBatchResponseEntry",
"batchId": 1116
}
]
}