แหล่งข้อมูล products
ช่วยให้มีความยืดหยุ่นและควบคุมแอตทริบิวต์ผลิตภัณฑ์ได้มากกว่า 60 รายการ มีช่องมากมายที่จำเป็นต้องใส่และต้องใส่เพื่อให้ได้รับอนุมัติให้แสดงใน Google Shopping
มีช่องที่ไม่บังคับจำนวนมากที่อาจต้องใช้ในเงื่อนไขต่างๆ เช่น สถานที่ตั้ง ประเภทผลิตภัณฑ์ ผลิตภัณฑ์ย่อย และแพ็กเกจผลิตภัณฑ์ สำหรับรายละเอียดเพิ่มเติมเกี่ยวกับพารามิเตอร์ที่ไม่บังคับกว่า 60 รายการที่กำหนดค่าสำหรับผลิตภัณฑ์ได้ โปรดดูข้อกำหนดในการจัดทำข้อมูลผลิตภัณฑ์
ทรัพยากร products
ช่วยให้คุณinsert
, get
, update
และ delete
ผลิตภัณฑ์ได้ครั้งละ 1 รายการ รวมถึง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 Tee สีดำ | ทีกรีน Google | ขีดจำกัดสิ่งทอของ Google |
คำอธิบาย | Google Tee สีดำ | เสื้อยืด Google ผ้าฝ้าย 100% | ขีดจำกัดของ Google แบบคลาสสิก |
รหัสกลุ่มสินค้า | google_tee | google_tee | |
ลิงก์ | http://my.site.com/blacktee | http://my.site.com/greentee | http://my.site.com/blackhat |
เงื่อนไข | ใหม่ | ใหม่ | ใหม่ |
ราคา | 219.90 THB | 219.90 THB | 109.90 THB |
availability | มีสินค้าพร้อมจำหน่าย | มีสินค้าพร้อมจำหน่าย | มีสินค้าพร้อมจำหน่าย |
imageLink | https://shop.example.com/ |
https://shop.example.com/ |
https://shop.example.com/ |
GTIN | 9504000059422 | 9504000059446 | 9504000059452 |
MPN | 00638NIC | 00638ANG | 00638ABC |
brand | |||
หมวดหมู่ผลิตภัณฑ์ 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 วันโดยอัตโนมัติ
ตัวอย่างที่แสดงจะแทรก "เสื้อยืดสีดำของ Google" ใหม่ลงในผลิตภัณฑ์ที่มีจำหน่าย
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
กำหนดขีดจำกัดการซื้อต่อคำสั่งซื้อของลูกค้าเป็นคำจำกัดความของผลิตภัณฑ์ และรองรับโดยฟีดด้วย ขณะนี้แอตทริบิวต์ยังอยู่ในเวอร์ชันเบต้าจนกว่า 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
ทั้งนี้ อาจใช้เวลา 2-3 นาทีเพื่อให้ผลิตภัณฑ์ที่แทรกใหม่พร้อมใช้งานผ่านการเรียกนี้
ใช้ 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 คำขอต่อไปนี้ด้วยวิธีการแพตช์ โดยระบุรหัสผู้ขาย รหัสผลิตภัณฑ์ และเนื้อหา 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 สำหรับผลิตภัณฑ์ในคีย์ "ทรัพยากร"
ระบบจะแสดงผลิตภัณฑ์ตัวอย่าง 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"
]
}
]
}