Method: accounts.productInputs.insert

อัปโหลดข้อมูลผลิตภัณฑ์ที่แสดงไปยังบัญชี Merchant Center หากมีอินพุตที่มี contentLanguage, offerId และ dataSource เดียวกันอยู่แล้ว วิธีนี้จะแทนที่รายการนั้น

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

คำขอ HTTP

POST https://merchantapi.googleapis.com/products/v1beta/{parent=accounts/*}/productInputs:insert

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
parent

string

ต้องระบุ บัญชีที่จะแทรกผลิตภัณฑ์นี้ รูปแบบ: accounts/{account}

พารามิเตอร์การค้นหา

พารามิเตอร์
dataSource

string

ต้องระบุ ชื่อแหล่งข้อมูลผลิตภัณฑ์หลักหรือเสริม หากมีผลิตภัณฑ์อยู่แล้วและแหล่งข้อมูลที่ให้ไว้แตกต่างกัน ระบบจะย้ายผลิตภัณฑ์ไปยังแหล่งข้อมูลใหม่ รูปแบบ: accounts/{account}/dataSources/{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 (ChannelEnum),
  "offerId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "versionNumber": string
}
ช่อง
name

string

ตัวระบุ ชื่อของอินพุตผลิตภัณฑ์ รูปแบบ: "{productinput.name=accounts/{account}/productInputs/{productinput}}"
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.4kB ระบบจะแทนที่ขีดล่างในชื่อแอตทริบิวต์ที่กำหนดเองด้วยการเว้นวรรคเมื่อมีการแทรก
versionNumber

string (int64 format)

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

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

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

หากมีการป้องกันการดำเนินการ ข้อยกเว้นที่ล้มเลิกจะถูกยกเลิก

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/content

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0