หน้านี้ได้รับการแปลโดย Cloud Translation API

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

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

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

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

ในตัวอย่าง API เราใช้ผลิตภัณฑ์ 3 อย่าง ได้แก่ เสื้อยืด Google 2 ตัว และ ขีดจำกัดของ Google เราใช้ชุดข้อมูลผลิตภัณฑ์เพียงเล็กน้อยที่แสดงในตารางด้านล่างเพื่อ เรียกใช้ทรัพยากร 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/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	00638ABC
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 วันคือ โดยอัตโนมัติ

ตัวอย่างที่แสดงได้แทรก "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 กำหนดขีดจำกัดการซื้อ ต่อคำสั่งซื้อของลูกค้า ไปจนถึงคำจำกัดความของผลิตภัณฑ์ และยังรองรับฟีดด้วย ขณะนี้แอตทริบิวต์ยังอยู่ในรุ่นเบต้าจนกว่า 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 ID) สำหรับผลิตภัณฑ์ที่คุณต้องการได้รับ:

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.insert ซึ่งต้องใช้ ต้องระบุข้อมูลในช่องที่เกี่ยวข้องทั้งหมด products.update กำหนดให้คุณต้องระบุเพียง ระบุฟิลด์ที่คุณต้องการเปลี่ยนแปลง

หากต้องการเพิ่มหรือแก้ไขแอตทริบิวต์ ให้ระบุฟิลด์ด้วยค่าใหม่ใน JSON เนื้อความ ตัวอย่างที่แสดงจะอัปเดต title และ description ของ "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 ของ "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 กับตัวอย่างคำขอ HTTP URL, รหัสผู้ขาย และรหัสผลิตภัณฑ์ (ในรูปแบบรหัส 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"
   ]
  }
 ]
}

รหัสผลิตภัณฑ์

โหมดกลุ่ม