ใช้ฟีดเสริมร่วมกับ 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 เมื่อไม่มีฟีดเสริม ซึ่งจะลบข้อมูลผลิตภัณฑ์ทั้งหมดที่มีอยู่ทั้งหมดและแทนที่ด้วยช่องที่คุณส่งในเนื้อหาคำขอ

คำเตือน: หากไม่รวม feedId เป็นพารามิเตอร์การค้นหาในคำขอ เมธอดจะทํางานเหมือนการเรียก 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",
}

หมายเหตุ: โดยค่าเริ่มต้น หากฟีดเสริมหลายรายการแก้ไขแอตทริบิวต์ผลิตภัณฑ์เดียวกัน ระบบจะใช้ค่าจากฟีดเสริมที่สร้างขึ้นล่าสุด (ไม่ใช่ฟีดที่อัปเดตล่าสุด) เป็นแอตทริบิวต์สุดท้ายของผลิตภัณฑ์ เช่น หากระบุค่าในช่องราคาผ่านฟีดเสริม 3 รายการ ค่าจากฟีดที่สร้างล่าสุดจะมีความสำคัญเหนือกว่า คุณปรับแต่งวิธีผสานรวมข้อมูลจากฟีดหลายรายการได้โดยกำหนดกฎฟีดใน Merchant Center

products.delete

เมธอด products.delete จะนำข้อมูลเสริมทั้งหมดที่ก่อนหน้านี้เพิ่มโดยการเรียก products.insert รายการที่ใช้ฟีดเสริมที่ระบุออก การเรียกวิธีนี้สำหรับฟีดเสริมจะไม่ส่งผลต่อข้อมูลผลิตภัณฑ์เดิมที่เพิ่มก่อนที่จะมีการเรียก Product.insert ของฟีดเสริม กระบวนการนี้เหมือนกับการนำเลเยอร์ข้อมูลของฟีดหนึ่งๆ ออก ข้อมูลที่เพิ่มผ่านฟีดอื่นๆ จะไม่ได้รับผลกระทบ และผลิตภัณฑ์จะเปลี่ยนกลับไปอยู่ในสถานะก่อนหน้าก่อนที่จะมีการเพิ่มเลเยอร์ฟีดเสริม กรณีนี้ต่างจากการเรียก products.delete เมื่อไม่มีฟีดเสริม ซึ่งจะลบทั้งผลิตภัณฑ์และข้อมูลของผลิตภัณฑ์ทั้งหมด

คำเตือน: หากไม่ได้ระบุ feedId เป็นพารามิเตอร์การค้นหาในคำขอ ระบบจะลบผลิตภัณฑ์ดังกล่าวและนำออกจากบัญชี

ใช้ 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รับข้อมูลฟีดเสริมของผลิตภัณฑ์หลายรายการได้โดยใช้การเรียก API ครั้งเดียวเพื่อลดจำนวนการเรียก API ที่เกิดขึ้น

คำเตือน: อย่าแทรกและลบข้อมูลฟีดเสริมสำหรับผลิตภัณฑ์รายการเดียวในการเรียก custombatch ครั้งเดียว ระบบไม่รับรองลำดับการดำเนินการใน custombatch การโทรแบบคู่จึงอาจยกเลิกไปเองหรืออาจทำให้เกิดลักษณะการทำงานที่ไม่คาดคิด

ใช้ 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"
    }
  ]
}