การโทรติดต่อทรัพยากรผลิตภัณฑ์

ทรัพยากร products ช่วยมีความยืดหยุ่นและควบคุมแอตทริบิวต์ผลิตภัณฑ์ได้มากกว่า 60 รายการ มีช่องหลายช่องที่จำเป็นและต้องระบุเพื่อให้แสดงบน Google Shopping มีช่องที่ไม่บังคับหลายช่องที่อาจกลายเป็นช่องบังคับตามเงื่อนไขที่แตกต่างกันไป เช่น สถานที่ ประเภทผลิตภัณฑ์ ผลิตภัณฑ์ย่อย และแพ็กเกจผลิตภัณฑ์ โปรดดูรายละเอียดเพิ่มเติมเกี่ยวกับพารามิเตอร์ที่ไม่บังคับกว่า 60 รายการที่กำหนดค่าได้สำหรับผลิตภัณฑ์ได้ที่ข้อกำหนดในการจัดทำข้อมูลผลิตภัณฑ์

ทรัพยากร products ช่วยให้คุณมีผลิตภัณฑ์ครั้งละ insert, get, update และ delete รายการ รวมถึงผลิตภัณฑ์ทั้งหมด list รายการในฐานข้อมูล Merchant Center

คุณใช้ทรัพยากร productstatuses เพื่อตรวจสอบสถานะการอนุมัติหรือไม่อนุมัติของผลิตภัณฑ์ที่เฉพาะเจาะจงสำหรับปลายทางได้ ดูรายละเอียดเพิ่มเติมว่าผลิตภัณฑ์ใดที่อาจมีปัญหาด้านคุณภาพของข้อมูลและปัญหาเหล่านั้นได้ที่คู่มือสถานะผลิตภัณฑ์

ในตัวอย่าง API เราใช้ผลิตภัณฑ์ 3 อย่าง ได้แก่ เสื้อยืด Google 2 ตัวและหมวก Google 1 ชุด เราใช้ชุดข้อมูลผลิตภัณฑ์น้อยที่สุดที่แสดงในตารางด้านล่างเพื่อเรียกทรัพยากรของ products เพื่อแทรก รับ อัปเดต แสดงรายการ และลบแต่ละผลิตภัณฑ์และชุดผลิตภัณฑ์

เราขอแนะนำให้กำหนดค่าข้อมูลการจัดส่งและภาษีที่ระดับบัญชีแทนที่จะกำหนดค่าที่ระดับผลิตภัณฑ์

สำหรับบัญชีย่อยผู้ขายหลายรายของตลาดกลาง ผลิตภัณฑ์ทั้งหมดต้องมีช่อง external_seller_id ดูรายละเอียดเพิ่มเติมได้ที่รหัสผลิตภัณฑ์

id online:en:US:1111111111 online:en:US:2222222222 online:en:US:3333333333
offerId 1111111111 2222222222 3333333333
title เสื้อยืด Google สีดำ เสื้อยืด Google สีเขียว หมวกแก๊ป Google Twill
คำอธิบาย เสื้อยืด Google สีดำ เสื้อยืด Google ผ้าฝ้าย 100% หมวก Google แบบคลาสสิก
รหัสกลุ่มสินค้า google_tee google_tee
ลิงก์ http://my.site.com/blacktee http://my.site.com/greentee http://my.site.com/blackhat
เงื่อนไข ใหม่ ใหม่ ใหม่
price 219.90 THB 219.90 THB 109.90 THB
availability มีสินค้าพร้อมจำหน่าย มีสินค้าพร้อมจำหน่าย มีสินค้าพร้อมจำหน่าย
imageLink https://shop.example.com/store/20160512512/assets/items/images/GGOEGXXX1100.jpg https://shop.example.com/store/20160512512/assets/items/images/GGOEGXXX0906.jpg https://shop.example.com/store/20160512512/assets/items/images/GGOEGHPB071610.jpg
GTIN 9504000059422 9504000059446 9504000059452
MPN 00638NIC 00638ANG กขค
brand Google Google Google
หมวดหมู่ผลิตภัณฑ์ Google เครื่องแต่งกายและเครื่องประดับ > เสื้อผ้า เครื่องแต่งกายและเครื่องประดับ > เสื้อผ้า เสื้อผ้าและเครื่องประดับ > อุปกรณ์เสื้อผ้า > หมวก
สี ดำ green ดำ
ขนาด L M M
age_group สำหรับผู้ใหญ่ สำหรับผู้ใหญ่ สำหรับผู้ใหญ่
gender ชาย ชาย ทุกเพศ
included_destination Shopping Actions, โฆษณา Shopping Shopping Actions, โฆษณา Shopping Shopping Actions

products.insert

หากต้องการแทรกผลิตภัณฑ์รายการเดียว ให้ใช้ URL คำขอต่อไปนี้ โดยระบุรหัสผู้ขายและเนื้อหา JSON ตัวอย่าง ส่วนแทรกจะสร้างผลิตภัณฑ์ใหม่ หากค่าที่มีอยู่สำหรับแอตทริบิวต์ channel, contentLanguage, offerId และ feedLabel ของผลิตภัณฑ์ที่ระบุ เมธอดจะอัปเดตรายการนั้นและแทนที่ข้อมูลทั้งหมดจากการเรียก API ก่อนหน้าสำหรับผลิตภัณฑ์ที่ระบุ

ระบบจะลบผลิตภัณฑ์ที่ยกเว้นจากปลายทางทั้งหมดนานกว่า 7 วันโดยอัตโนมัติ

ตัวอย่างที่แสดงมีคำว่า "Black Google Tee" ใหม่ลงในผลิตภัณฑ์ที่มีจำหน่าย

POST https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products

ตัวอย่างการเรียกเนื้อหาคำขอสำหรับ products.insert:

{
 "kind": "content#product",
 "offerId": "1111111111",
 "title": "Google Tee Black",
 "description": "The Black Google Tee is available in unisex sizing.",
 "link": "http://my.site.com/blacktee/",
 "imageLink": "https://shop.example.com/.../images/GGOEGXXX1100.jpg",
 "contentLanguage": "en",
 "targetCountry": "US",
 "feedLabel": "US",
 "channel": "online",
 "ageGroup": "adult",
 "availability": "in stock",
 "availabilityDate": "2019-01-25T13:00:00-08:00",
 "brand": "Google",
 "color": "black",
 "condition": "new",
 "gender": "male",
 "googleProductCategory": "1604",
 "gtin": "608802531656",
 "itemGroupId": "google_tee",
 "mpn": "608802531656",
 "price": {
  "value": "21.99",
  "currency": "USD"
 },
 "sizes": [
  "Large"
 ]
}

ผลิตภัณฑ์ยังตั้งค่าแอตทริบิวต์ที่กำหนดเองไว้ภายในเนื้อหา JSON ได้ด้วย เช่น เราอาจตั้งค่า purchase_quantity_limit สำหรับผลิตภัณฑ์รายการเดียวเพื่อจำกัดจำนวนสินค้าที่ลูกค้าสั่งซื้อได้ ดังนี้

"customAttributes": [
 {
   "name": "purchase_quantity_limit",
   "value": "4"
 }
]

โปรดทราบว่าแอตทริบิวต์ที่กำหนดเอง purchase_quantity_limit จะกำหนดขีดจำกัดการซื้อต่อคำสั่งซื้อของลูกค้า 1 รายการให้กับคำจำกัดความผลิตภัณฑ์และยังรองรับโดยฟีด ขณะนี้แอตทริบิวต์ยังอยู่ในเวอร์ชันเบต้าจนกว่า API จะรองรับอย่างเต็มรูปแบบ ผู้ขายเพิ่มแอตทริบิวต์ที่กำหนดเองเพิ่มเติมได้ แต่ API จะไม่ทำให้มีการประมวลผลที่เจาะจงใดๆ

การเรียกใช้ที่ประสบความสำเร็จจะแสดงโค้ด HTTP 200 และเนื้อหาการตอบกลับที่มีทรัพยากรผลิตภัณฑ์ที่แทรกไว้ซึ่งมีการเติมข้อมูล id, offerId, contentLanguage, feedLabel และ channel เท่านั้น:

{
 "kind": "content#product",
 "id": "online:en:US:1111111111",
 "offerId": "1111111111",
 "contentLanguage": "en",
 "targetCountry": "US",
 "feedLabel": "US",
 "channel": "online"
}

products.get

หากต้องการข้อมูลเกี่ยวกับผลิตภัณฑ์ที่เฉพาะเจาะจงในฐานข้อมูล Merchant Center ให้ใช้ products.get อาจใช้เวลาสักครู่ก่อนที่ผลิตภัณฑ์ที่แทรกใหม่จะพร้อมใช้งานผ่านการโทรนี้

ใช้ URL และพารามิเตอร์คำขอ HTTP ต่อไปนี้ รหัสผู้ขาย และรหัสผลิตภัณฑ์ (รูปแบบรหัส REST) สำหรับผลิตภัณฑ์ที่คุณต้องการ

GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}

การเรียกใช้ที่ประสบความสำเร็จจะแสดงผล HTTP 200 และ "ทรัพยากรผลิตภัณฑ์" ในเนื้อหาการตอบสนอง ตัวอย่างข้อมูลผลิตภัณฑ์ที่ดึงมาจากผลิตภัณฑ์ที่มีรหัส online:en:US:1111111111 มีดังนี้

{
 "kind": "content#product",
 "id": "online:en:US:1111111111",
 "offerId": "1111111111",
 "source": "api",
 "title": "Google Tee Black",
 "description": "The Black Google Tee is available in unisex sizing.",
 "link": "http://my.site.com/blacktee/",
 "imageLink": "https://shop.example.com/.../images/GGOEGXXX1100.jpg",
 "contentLanguage": "en",
 "targetCountry": "US",
 "feedLabel": "US",
 "channel": "online",
 "ageGroup": "adult",
 "availability": "in stock",
 "availabilityDate": "2019-01-25T13:00:00-08:00",
 "brand": "Google",
 "color": "black",
 "condition": "new",
 "gender": "male",
 "googleProductCategory": "1604",
 "gtin": "608802531656",
 "itemGroupId": "google_tee",
 "mpn": "608802531656",
 "price": {
  "value": "21.99",
  "currency": "USD"
 },
 "sizes": [
  "Large"
 ]
}

products.update

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

หากต้องการเพิ่มหรือแก้ไขแอตทริบิวต์ ให้ระบุช่องด้วยค่าใหม่ในเนื้อหา JSON ตัวอย่างที่แสดงจะอัปเดต title และ description ของ "Black Google Tee" ที่มีอยู่ด้วยข้อมูลผลิตภัณฑ์ที่ให้ไว้ในส่วนเนื้อหาของคำขอ โดยจะไม่เปลี่ยนแปลงช่องอื่นๆ ทั้งหมด

PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}

ตัวอย่างการเรียกเนื้อหาคำขอสำหรับ products.update:

{
 "title": "Google Tee Black Limited Edition",
 "description": "The Limited Edition Tee is available in unisex sizing and features a retail fit."
}

เฉพาะช่องระดับบนสุดจะอัปเดตผ่านคำขอ products.update ได้ หากต้องการอัปเดตช่องที่ซ้อนกัน คุณจะต้องระบุออบเจ็กต์ระดับบนสุดทั้งหมด

ตัวอย่างที่แสดงจะอัปเดตออบเจ็กต์ salePrice ระดับบนสุด รวมถึงช่องที่ฝังของผลิตภัณฑ์ที่มีอยู่ ด้วยข้อมูลผลิตภัณฑ์ที่ให้ไว้ในเนื้อหาคำขอ โดยปล่อยช่องอื่นๆ ไว้ตามเดิม

PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}
{
 "salePrice": {
  "value": "17.99",
  "currency": "USD"
 }
}

คุณระบุ updateMask เพื่อเลือกช่องบางช่องเพื่ออัปเดตโดยไม่เปลี่ยนแปลงช่องอื่นๆ ที่รวมอยู่ในเนื้อหาคำขอได้ พารามิเตอร์สตริงคำค้นหานี้ควรเป็นรายการช่องที่คั่นด้วยคอมมาที่คุณต้องการแก้ไข updateMask มีประโยชน์เมื่อคุณต้องการยืนยันว่าจะมีการอัปเดตเฉพาะช่องที่มีชื่อเท่านั้น การไม่ระบุ updateMask เทียบเท่ากับการทำเครื่องหมายช่องทั้งหมดในคำขอให้อัปเดตดังที่แสดงในตัวอย่างด้านบน

ตัวอย่างที่แสดงจะอัปเดตเฉพาะ description และ availability ของ "Black Google Tee" ที่มีอยู่พร้อมข้อมูลผลิตภัณฑ์ที่เกี่ยวข้องซึ่งระบุไว้ในเนื้อหาคำขอเท่านั้น โดยช่องอื่นๆ ทั้งหมดรวมถึงช่อง title จะไม่ได้รับผลกระทบใดๆ

PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}?updateMask=description,availability

ตัวอย่างการเรียกเนื้อหาคำขอสำหรับ products.update:

{
 "title": "Google Tee Black",
 "description": "This Limited Edition is out of print.",
 "availability": "out of stock"
}

หากมีการระบุช่องในรายการ updateMask แต่ไม่อยู่ในเนื้อหาของคำขอ ระบบจะลบช่องนั้นออกจากทรัพยากร Product หากมี

ตัวอย่างที่แสดงจะใช้ updateMask เพื่อนำค่าของช่อง salePrice ออก

PATCH https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}?updateMask=salePrice

เนื้อหาคำขอตัวอย่างไม่ควรรวมช่อง salePrice เพื่อลบออก คุณอาจไม่ได้ระบุเนื้อความหรือเนื้อความเปล่าเลยก็ได้ ช่องอื่นๆ จะยังคงไม่เปลี่ยนแปลงหากไม่ปรากฏใน updateMask

หากต้องการใช้ updateMask ภายในคำขอ products.custombatch คุณควรระบุ updateMask ในเนื้อหาของคำขอ

ตัวอย่างที่แสดงจะอัปเดต price และ availability ของ "Black Google Tee" ที่มีอยู่โดยใช้ products.custombatch พร้อมข้อมูลผลิตภัณฑ์ที่ให้ไว้ในรายการแบบกลุ่ม โดยคงช่องอื่นๆ ทั้งหมด รวมถึง title และ description ไว้

POST https://shoppingcontent.googleapis.com/content/v2.1/products/batch
{
  "entries": [{
    "batchId": 1,
    "merchantId": "MERCHANT_ID",
    "productId": "online:en:US:1111111111",
    "method": "update",
    "product": {
      "title": "Google Tee Black",
      "description": "The Black Google Tee is available in unisex sizing.",
      "availability": "in stock",
      "price": {
        "value": "19.99",
        "currency": "USD"
      }
    },
    "updateMask": "availability,price"
  }]
}

products.delete

หากต้องการลบผลิตภัณฑ์รายการเดียว ให้ใช้ products.delete กับตัวอย่าง URL คำขอ HTTP, รหัสผู้ขาย และรหัสผลิตภัณฑ์ (ในรูปแบบรหัส REST เช่น online:en:US:1111111111) สำหรับผลิตภัณฑ์ที่คุณต้องการลบ ดังนี้

DELETE https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products/{productId}

การตอบกลับที่สำเร็จจะแสดงผล HTTP Status 204 ที่ไม่มีเนื้อหาการตอบสนอง

products.list

products.list แสดงผลิตภัณฑ์ทั้งหมดที่ผู้ขายมีในฐานข้อมูล Merchant Center ใช้ URL คำขอต่อไปนี้

GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantId}/products

การเรียกที่สำเร็จจะแสดงผลข้อมูล HTTP 200 และ JSON สำหรับผลิตภัณฑ์ในคีย์ "resources"

โดยจะส่งคืนผลิตภัณฑ์ 3 ตัวอย่างต่อไปนี้

{
 "kind": "content#productsListResponse",
 "resources": [
  {
   "kind": "content#product",
   "id": "online:en:US:1111111111",
   "offerId": "1111111111",
   "source": "api",
   "title": "Google Tee Black",
   "description": "The Black Google Tee is available in unisex sizing.",
   "link": "http://my.site.com/blacktee/",
   "imageLink": "https://shop.example.com/.../images/GGOEGXXX1100.jpg",
   "contentLanguage": "en",
   "targetCountry": "US",
   "feedLabel": "US",
   "channel": "online",
   "ageGroup": "adult",
   "availability": "in stock",
   "availabilityDate": "2019-01-25T13:00:00-08:00",
   "brand": "Google",
   "color": "black",
   "condition": "new",
   "gender": "male",
   "googleProductCategory": "1604",
   "gtin": "608802531656",
   "itemGroupId": "google_tee",
   "mpn": "608802531656",
   "price": {
    "value": "21.99",
    "currency": "USD"
   },
   "sizes": [
    "Large"
   ]
  },
  {
   "kind": "content#product",
   "id": "online:en:US:2222222222",
   "offerId": "2222222222",
   "source": "api",
   "title": "Google Tee Green",
   "description": "100% cotton jersey fabric sets this Google t-shirt above the crowd.
    Features the google logo across the chest. Unisex sizing.",
   "link": "http://my.site.com/greentee/",
   "imageLink": "https://shop.example.com/.../images/GGOEGXXX0906.jpg",
   "contentLanguage": "en",
   "targetCountry": "US",
   "feedLabel": "US",
   "channel": "online",
   "ageGroup": "adult",
   "availability": "in stock",
   "availabilityDate": "2019-01-25T13:00:00-08:00",
   "brand": "Google",
   "color": "green",
   "condition": "new",
   "gender": "male",
   "googleProductCategory": "1604",
   "gtin": "608802531649",
   "itemGroupId": "google_tee",
   "mpn": "608802531649",
   "price": {
    "value": "21.99",
    "currency": "USD"
   },
   "sizes": [
    "Medium"
   ]
  },
  {
   "kind": "content#product",
   "id": "online:en:US:3333333333",
   "offerId": "3333333333",
   "source": "api",
   "title": "Google Twill Cap",
   "description": "Classic urban styling distinguishes this Google cap.
    Retains its shape, even when not being worn.",
   "link": "http://my.site.com/blackhat/",
   "imageLink": "https://shop.example.com/.../images/GGOEGHPB071610.jpg",
   "contentLanguage": "en",
   "targetCountry": "US",
   "feedLabel": "US",
   "channel": "online",
   "ageGroup": "adult",
   "availability": "in stock",
   "availabilityDate": "2019-01-07T13:00:00-08:00",
   "brand": "Google",
   "color": "black",
   "condition": "new",
   "gender": "male",
   "googleProductCategory": "173",
   "gtin": "689355417246",
   "mpn": "689355417246",
   "price": {
    "value": "10.99",
    "currency": "USD"
   },
   "sizes": [
    "Medium"
   ]
  }
 ]
}