ทรัพยากร 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/ |
https://shop.example.com/ |
https://shop.example.com/ |
GTIN | 9504000059422 | 9504000059446 | 9504000059452 |
MPN | 00638NIC | 00638ANG | กขค |
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 วันโดยอัตโนมัติ
ตัวอย่างที่แสดงมีคำว่า "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"
]
}
]
}