استخدام الخلاصات التكميلية مع Content API

يمكنك استخدام الخلاصات التكميلية لإجراء تعديلات جزئية على بيانات المنتجات من خلال إضافة feedId كمعلَمة طلب بحث عند إجراء طلبات إلى الطرق products.insert و products.delete و products.custombatch.insert و و products.custombatch.delete.

على سبيل المثال، يمكنك إجراء طلب طريقة products.insert لخلاصة تكميلية إلى عنوان URL التالي:

POST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products?feedId=feedId

products.insert

تضيف طريقة products.insert في الخلاصة التكميلية حقول المنتجات التي ترسلها في نص الطلب، وتستبدل تلك الحقول إذا كانت متوفّرة. عند استخدام خلاصة تكميلية، لا تغيّر هذه الطريقة جميع حقول المنتجات الأخرى، ما لم يتم تضمين الحقول في طلب سابق للخلاصة نفسها. في حين أنّ البيانات التي تتم إضافتها من خلال خلاصات أخرى لا تتأثر، فإنّ كل طلب يستبدل الطلبات السابقة للخلاصة نفسها. ويعني ذلك أنّه إذا أضفت حقلًا أو عدّلته من خلال طلب خلاصة تكميلية، ثم لم تضمّنه في طلب لاحق، ستتم إزالة بيانات الحقل المحذوف من الخلاصة. يختلف هذا السلوك عن استدعاء products.insert بدون خلاصة تكميلية، ما يؤدي إلى حذف جميع بيانات المنتجات الحالية واستبدالها بالحقول التي ترسلها في نص الطلب.

استخدِم عنوان URL التالي لإجراء طلب إلى خدمة Product.insert في الخلاصة التكميلية:

POST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products?feedId=feedId

يجب تضمين الحقول offerId وfeedLabel وchannel وcontentLanguage في نص الطلب. وجميع الحقول الأخرى اختيارية.

مثال

لتغيير مدى توفّر منتج من "متوفّر" إلى "غير متوفّر"، يمكنك استخدام نص الطلب التالي لإجراء طلب طريقة Product.insert في الخلاصات التكميلية:

{
 "offerId": "1111111111",
 "contentLanguage": "en",
 "feedLabel": "US",
 "channel": "online",
 "availability": "out of stock",
}

products.delete

تزيل طريقة products.delete جميع البيانات التكميلية التي تمت إضافتها سابقًا من خلال طلبات products.insert باستخدام الخلاصة التكميلية المحدّدة. لا يؤثر استدعاء هذه الطريقة لخلاصة تكميلية في بيانات المنتج الأصلية التي تمت إضافتها قبل إجراء طلبات Product.insert في الخلاصة التكميلية. يمكنك اعتبار ذلك بمثابة إزالة طبقة من البيانات لخلاصة معيّنة، ولا تتأثر البيانات التي تمت إضافتها من خلال خلاصات أخرى، ويعود المنتج فعليًا إلى حالته السابقة قبل إضافة طبقة الخلاصة التكميلية. يختلف ذلك عن استدعاء products.delete بدون خلاصة تكميلية، ما يؤدي إلى حذف المنتج بالكامل وجميع بياناته.

استخدِم عنوان URL التالي لإجراء طلب إلى خدمة الخلاصة التكميلية products.delete ، حيث يكون productId هو المعرّف بتنسيق REST للمنتج، ويتم تمثيله على النحو التالي: channel:contentLanguage:feedLabel:offerId:

DELETE https://shoppingcontent.googleapis.com/content/v2.1/merchantId/products/productId?feedId=feedId

لا يلزم توفير نص طلب لطلبات طريقة products.delete في الخلاصات التكميلية.

products.custombatch

تتيح لك طرق custombatch insert بيانات الخلاصة التكميلية أو delete لمنتجات متعددة باستخدام طلب واجهة برمجة تطبيقات واحد لتقليل عدد طلبات واجهة برمجة التطبيقات التي يتم إجراؤها.

استخدِم عنوان URL الخاص بالطلب التالي لإجراء طلب custombatch:

https://shoppingcontent.googleapis.com/content/v2.1/products/batch

بالنسبة إلى جميع طلبات custombatch في الخلاصة التكميلية، يجب تضمين المَعلمات batchId وmerchantID وmethod وfeedId في نص الطلب.

products.custombatch:insert

عند إجراء طلبات خلاصة تكميلية إلى طريقة products.custombatch:insert، يجب تضمين offerId وfeedLabel وchannel وcontentLanguage في نص الطلب، بالإضافة إلى المَعلمات المطلوبة batchId وmerchantID وmethod. وجميع حقول المنتجات الأخرى اختيارية.

مثال

لتعديل قيمة price لمنتجَين حاليَين، يمكنك استخدام الطلب التالي لإجراء طلب طريقة products.custombatch:insert :

{
  "entries": [
    {
      "batchId": 1111,
      "merchantId": 1234567,
      "method": "insert",
      "feedId": "7654321",
      "product": {
         "offerId": "1111111111",
         "contentLanguage": "en",
         "targetCountry": "US",
         "feedLabel": "US",
         "channel": "online",
         "price": {
          "value": "30.99",
          "currency": "USD"
         }
      }
    },
    {
      "batchId": 1112,
      "merchantId": 1234567,
      "method": "insert",
      "feedId": "7654321",
      "product": {
         "offerId": "2222222222",
         "contentLanguage": "en",
         "targetCountry": "US",
         "feedLabel": "US",
         "channel": "online",
         "price": {
          "value": "33.99",
          "currency": "USD"
         },
      },
    }
}

products.custombatch:delete

لإزالة جميع التعديلات التي تم إجراؤها على منتجَين من خلال خلاصة تكميلية محدّدة، يمكنك استخدام الطلب التالي لإجراء طلب طريقة products.custombatch:delete:

{
  "entries": [
    {
      "batchId": 1115,
      "merchantId": 1234567,
      "method": "delete",
      "feedId": "7654321",
      "productId": "online:en:US:1111111111"
    },
    {
      "batchId": 1116,
      "merchantId": 1234567,
      "method": "delete",
      "feedId": "7654321",
      "productId": "online:en:US:2222222222"
    }
  ]
}