REST Resource: accounts.productInputs

ทรัพยากร: ProductInput

แหล่งข้อมูลนี้แสดงข้อมูลอินพุตที่คุณส่งสำหรับผลิตภัณฑ์ ไม่ใช่ผลิตภัณฑ์ที่ประมวลผลแล้วซึ่งคุณเห็นใน Merchant Center, โฆษณา Shopping หรือแพลตฟอร์มของ Google ระบบจะรวมอินพุตผลิตภัณฑ์ กฎ และข้อมูลแหล่งข้อมูลเสริมเพื่อสร้าง Product ที่ประมวลผลแล้ว

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

แอตทริบิวต์ที่ต้องระบุ ได้แก่ feedLabel, contentLanguage และ offerId

หลังจากแทรก อัปเดต หรือลบข้อมูลผลิตภัณฑ์แล้ว ระบบอาจใช้เวลา 2-3 นาทีจึงจะเรียกข้อมูลผลิตภัณฑ์ที่ประมวลผลแล้วได้

ช่องทั้งหมดในอินพุตผลิตภัณฑ์และข้อความย่อยของผลิตภัณฑ์ต้องตรงกับชื่อภาษาอังกฤษของแอตทริบิวต์ที่เกี่ยวข้องในข้อกำหนดเฉพาะของประเภทธุรกิจ โดยมีข้อยกเว้นบางประการ

การแสดง JSON 
{
  "name": string,
  "product": string,
  "channel": enum (ChannelEnum),
  "offerId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "versionNumber": string
}
ช่อง
name

string

ตัวระบุ ชื่อของอินพุตผลิตภัณฑ์ รูปแบบ: "{productinput.name=accounts/{account}/productInputs/{productinput}}" โดยที่ส่วนสุดท้าย productinput ประกอบด้วย 4 ส่วน ได้แก่ channel~contentLanguage~feedLabel~offerId ตัวอย่างชื่ออินพุตผลิตภัณฑ์คือ "accounts/123/productInputs/online~en~US~sku123"
product

string

เอาต์พุตเท่านั้น ชื่อของผลิตภัณฑ์แปรรูป รูปแบบ: "{product.name=accounts/{account}/products/{product}}"
channel

enum (ChannelEnum)

ต้องระบุ เปลี่ยนแปลงไม่ได้ ช่องทางของผลิตภัณฑ์
offerId

string

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

string

ต้องระบุ เปลี่ยนแปลงไม่ได้ รหัสภาษา ISO 639-1 แบบ 2 ตัวอักษรของผลิตภัณฑ์
feedLabel

string

ต้องระบุ เปลี่ยนแปลงไม่ได้ ป้ายกำกับฟีดของผลิตภัณฑ์
attributes

object (Attributes)

ไม่บังคับ รายการแอตทริบิวต์ผลิตภัณฑ์
customAttributes[]

object (CustomAttribute)

ไม่บังคับ รายการแอตทริบิวต์ที่กำหนดเอง (ผู้ขายระบุ) นอกจากนี้ยังใช้ส่งแอตทริบิวต์ใดก็ได้ของข้อกำหนดเฉพาะของข้อมูลในรูปแบบทั่วไป (เช่น { "name": "size type", "value": "regular" }) ซึ่งมีประโยชน์สำหรับการส่งแอตทริบิวต์ที่ API ไม่ได้แสดงอย่างชัดเจน เช่น แอตทริบิวต์เพิ่มเติมที่ใช้สำหรับ "ซื้อใน Google" จำนวนอักขระสูงสุดที่อนุญาตสำหรับแอตทริบิวต์ที่กำหนดเองแต่ละรายการคือ 10240 (แสดงผลรวมของอักขระสำหรับชื่อและค่า) คุณตั้งค่าแอตทริบิวต์ที่กำหนดเองได้สูงสุด 2, 500 รายการต่อผลิตภัณฑ์ โดยมีขนาดรวมไม่เกิน 102.4 KB ระบบจะแทนที่ขีดล่างในชื่อแอตทริบิวต์ที่กำหนดเองด้วยเว้นวรรคเมื่อแทรก
versionNumber

string (int64 format)

ไม่บังคับ แสดงเวอร์ชันที่มีอยู่ (ความใหม่) ของผลิตภัณฑ์ ซึ่งสามารถใช้เพื่อรักษาลำดับที่ถูกต้องเมื่อมีการอัปเดตหลายรายการพร้อมกัน

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

รองรับเฉพาะการแทรกลงในแหล่งข้อมูลหลัก

หากมีการป้องกันการดําเนินการ ระบบจะแสดงข้อยกเว้นที่ยกเลิก

เมธอด

delete

 ลบข้อมูลผลิตภัณฑ์ที่ป้อนออกจากบัญชี Merchant Center

insert

 อัปโหลดอินพุตผลิตภัณฑ์ไปยังบัญชี Merchant Center