ใช้ฟีดเสริมร่วมกับ 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 service โดยที่ productId คือ REST ID ของผลิตภัณฑ์ ซึ่งแสดงเป็น channel:contentLanguage:feedLabel:offerId:

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

ไม่จำเป็นต้องมีเนื้อหาคำขอสำหรับการเรียกเมธอดฟีดเสริม products.delete

products.custombatch

เมธอด custombatch ช่วยให้คุณinsertหรือdeleteข้อมูลฟีดเสริม สำหรับผลิตภัณฑ์หลายรายการได้โดยใช้การเรียก API เดียวเพื่อลดจำนวนการเรียก API ที่ดำเนินการ

ใช้ 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 สำหรับผลิตภัณฑ์ที่มีอยู่ 2 รายการ คุณสามารถใช้คำขอต่อไปนี้เพื่อเรียกใช้เมธอด 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

หากต้องการนำการอัปเดตทั้งหมดที่ทำกับผลิตภัณฑ์ 2 รายการผ่านฟีดเสริมที่ระบุออก คุณสามารถใช้คำขอต่อไปนี้เพื่อทำการ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"
    }
  ]
}