ใช้ฟีดเสริมร่วมกับ 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 รายการได้ ข้อมูลสำหรับผลิตภัณฑ์หลายรายการโดยใช้การเรียก 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"
    }
  ]
}