- คำขอ HTTP
- พารามิเตอร์เส้นทาง
- พารามิเตอร์การค้นหา
- เนื้อความของคำขอ
- เนื้อหาการตอบกลับ
- ขอบเขตการให้สิทธิ์
- ลองใช้งาน
อัปโหลดข้อมูลผลิตภัณฑ์ที่แสดงไปยังบัญชี Merchant Center หากมีอินพุตที่มี contentLanguage, offerId และ dataSource เดียวกันอยู่แล้ว วิธีนี้จะแทนที่รายการนั้น
หลังจากแทรก อัปเดต หรือลบผลิตภัณฑ์ที่ป้อนแล้ว อาจใช้เวลาหลายนาทีจึงจะดึงข้อมูลผลิตภัณฑ์ที่ประมวลผลแล้วได้
คำขอ HTTP
POST https://merchantapi.googleapis.com/products/v1beta/{parent=accounts/*}/productInputs:insert
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์เส้นทาง
พารามิเตอร์ | |
---|---|
parent |
ต้องระบุ บัญชีที่จะแทรกผลิตภัณฑ์นี้ รูปแบบ: accounts/{account} |
พารามิเตอร์การค้นหา
พารามิเตอร์ | |
---|---|
dataSource |
ต้องระบุ ชื่อแหล่งข้อมูลผลิตภัณฑ์หลักหรือเสริม หากมีผลิตภัณฑ์อยู่แล้วและแหล่งข้อมูลที่ให้ไว้แตกต่างกัน ระบบจะย้ายผลิตภัณฑ์ไปยังแหล่งข้อมูลใหม่ รูปแบบ: |
เนื้อหาของคำขอ
เนื้อความของคำขอมีอินสแตนซ์ของ ProductInput
เนื้อหาการตอบกลับ
แหล่งข้อมูลนี้แสดงข้อมูลที่คุณป้อนสำหรับผลิตภัณฑ์ ไม่ใช่ผลิตภัณฑ์ที่ประมวลผลแล้วที่คุณเห็นใน Merchant Center, โฆษณา Shopping หรือแพลตฟอร์มต่างๆ ของ Google ระบบจะรวมอินพุตผลิตภัณฑ์ กฎ และข้อมูลแหล่งข้อมูลเสริมเพื่อสร้าง [product][google.shopping.content.bundles.Products.Product] ที่ประมวลผลแล้ว
แอตทริบิวต์อินพุตผลิตภัณฑ์ที่จำเป็นเพื่อให้ผ่านการตรวจสอบความถูกต้องของข้อมูลมีการกำหนดไว้ในข้อกำหนดในการจัดทำข้อมูลผลิตภัณฑ์เป็นหลัก
คุณต้องระบุแอตทริบิวต์ต่อไปนี้ [feedLabel][google.shopping.content.bundles.Products.feed_label], [contentLanguage][google.shopping.content.bundles.Products.content_language] และ [offerId][google.shopping.content.bundles.Products.offer_id]
หลังจากแทรก อัปเดต หรือลบผลิตภัณฑ์ที่ป้อนแล้ว อาจใช้เวลาหลายนาทีจึงจะดึงข้อมูลผลิตภัณฑ์ที่ประมวลผลแล้วได้
ช่องทั้งหมดในอินพุตผลิตภัณฑ์และข้อความย่อยตรงกับชื่อภาษาอังกฤษของแอตทริบิวต์ที่เกี่ยวข้องในข้อมูลจำเพาะแนวตั้งโดยมีข้อยกเว้นบางประการ
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
การแสดง JSON |
---|
{ "name": string, "product": string, "channel": enum ( |
ช่อง | |
---|---|
name |
ตัวระบุ ชื่อของอินพุตผลิตภัณฑ์ รูปแบบ: |
product |
เอาต์พุตเท่านั้น ชื่อของผลิตภัณฑ์ที่ประมวลผล รูปแบบ: |
channel |
ต้องระบุ เปลี่ยนแปลงไม่ได้ ช่องทางของผลิตภัณฑ์ |
offerId |
ต้องระบุ เปลี่ยนแปลงไม่ได้ ตัวระบุที่ไม่ซ้ำกันสำหรับผลิตภัณฑ์ ซึ่งจะเหมือนกันสำหรับผลิตภัณฑ์ที่ป้อนและผลิตภัณฑ์ที่ได้รับการประมวลผล การเว้นวรรคที่นำหน้าและต่อท้ายจะถูกตัดออก และแทนที่ด้วยช่องว่างหลายช่องด้วยช่องว่างเดี่ยวๆ เมื่อส่ง ดูรายละเอียดได้ในข้อกำหนดในการจัดทำข้อมูลผลิตภัณฑ์ |
contentLanguage |
ต้องระบุ เปลี่ยนแปลงไม่ได้ รหัสภาษา ISO 639-1 แบบ 2 ตัวอักษรสำหรับผลิตภัณฑ์ |
feedLabel |
ต้องระบุ เปลี่ยนแปลงไม่ได้ ป้ายกำกับฟีดของผลิตภัณฑ์ |
attributes |
ไม่บังคับ รายการแอตทริบิวต์ผลิตภัณฑ์ |
customAttributes[] |
ไม่บังคับ รายการแอตทริบิวต์ที่กำหนดเอง (ระบุโดยผู้ขาย) นอกจากนี้ ยังใช้สำหรับการส่งแอตทริบิวต์ของข้อกำหนดในการจัดทำข้อมูลในรูปแบบทั่วไป (เช่น |
versionNumber |
ไม่บังคับ แสดงถึงผลิตภัณฑ์เวอร์ชันที่มีอยู่ (ความใหม่) ซึ่งใช้เพื่อรักษาลำดับที่เหมาะสมเมื่ออัปเดตหลายรายการพร้อมกัน หากตั้งค่าไว้ ระบบจะป้องกันการแทรกเมื่อหมายเลขเวอร์ชันต่ำกว่าหมายเลขเวอร์ชันปัจจุบันของผลิตภัณฑ์ที่มีอยู่ การแทรกอีกครั้ง (เช่น การรีเฟรชผลิตภัณฑ์หลังผ่านไป 30 วัน) จะดำเนินการด้วย รองรับเฉพาะการแทรกลงในแหล่งข้อมูลหลัก หากมีการป้องกันการดำเนินการ ข้อยกเว้นที่ล้มเลิกจะถูกยกเลิก |
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth ต่อไปนี้
https://www.googleapis.com/auth/content
สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0