ใช้ฟีดเสริมร่วมกับ 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"
    }
  ]
}