استخدام الخلاصات التكميلية مع 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 هي رقم تعريف RST المنتج، ممثلة على النحو التالي: 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"
    }
  ]
}