PlaylistImages: insert

เพิ่มรูปภาพลงในเพลย์ลิสต์

วิธีนี้รองรับการอัปโหลดสื่อ ไฟล์ที่อัปโหลดต้องเป็นไปตามข้อจำกัดต่อไปนี้

  • ขนาดไฟล์สูงสุด: 2MB
  • สัดส่วนภาพที่ยอมรับ: 1:1 (สี่เหลี่ยมจัตุรัส)
  • ประเภท MIME ของสื่อที่ยอมรับ: image/jpeg, image/png

ผลกระทบจากโควต้า: การเรียกใช้วิธีการนี้มีต้นทุนโควต้า 50 หน่วย

ส่งคำขอ

คำขอ HTTP

POST https://www.googleapis.com/youtube/v3/playlistImages

การให้สิทธิ์

คำขอนี้ต้องได้รับการให้สิทธิ์ที่มีขอบเขตต่อไปนี้อย่างน้อย 1 ขอบเขต (อ่านเพิ่มเติมเกี่ยวกับการตรวจสอบสิทธิ์และการให้สิทธิ์)

ขอบเขต
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

พารามิเตอร์

ตารางต่อไปนี้แสดงพารามิเตอร์ที่คำค้นหานี้รองรับ พารามิเตอร์ทั้งหมดที่แสดงคือพารามิเตอร์การค้นหา

พารามิเตอร์
พารามิเตอร์ที่จำเป็น
part string

พารามิเตอร์ part ระบุ รายการทรัพยากร playlistImage อย่างน้อย 1 รายการที่คั่นด้วยคอมมา ที่การตอบกลับของ API จะรวมไว้

ถ้าพารามิเตอร์ ระบุพร็อพเพอร์ตี้ที่มีพร็อพเพอร์ตี้ย่อย จะรวมอยู่ในคำตอบ
พารามิเตอร์ที่ไม่บังคับ
onBehalfOfContentOwner string
สามารถใช้พารามิเตอร์นี้ในคำขอที่ได้รับอนุญาตอย่างถูกต้องเท่านั้น หมายเหตุ: พารามิเตอร์นี้มีไว้สำหรับพาร์ทเนอร์เนื้อหาของ YouTube เท่านั้น

พารามิเตอร์ onBehalfOfContentOwner ระบุว่าข้อมูลเข้าสู่ระบบการให้สิทธิ์ของคำขอระบุผู้ใช้ YouTube CMS ที่ทำหน้าที่ในนามของเจ้าของเนื้อหาที่ระบุไว้ในค่าพารามิเตอร์ พารามิเตอร์นี้มีไว้สำหรับพาร์ทเนอร์เนื้อหาของ YouTube ที่เป็นเจ้าของและจัดการช่อง YouTube ต่างๆ จำนวนมาก ซึ่งจะช่วยให้เจ้าของเนื้อหาตรวจสอบสิทธิ์เพียงครั้งเดียวและเข้าถึงข้อมูลวิดีโอและช่องทั้งหมดของตนได้โดยไม่ต้องระบุข้อมูลเข้าสู่ระบบการตรวจสอบสิทธิ์สำหรับแต่ละช่อง บัญชี CMS ที่ผู้ใช้ตรวจสอบสิทธิ์จะต้องลิงก์กับเจ้าของเนื้อหา YouTube ที่ระบุ
onBehalfOfContentOwnerChannel string
สามารถใช้พารามิเตอร์นี้ในคำขอที่ได้รับอนุญาตอย่างถูกต้องเท่านั้น หมายเหตุ: พารามิเตอร์นี้มีไว้สำหรับพาร์ทเนอร์เนื้อหาของ YouTube เท่านั้น

พารามิเตอร์ onBehalfOfContentOwnerChannel รายการ ระบุรหัสช่อง YouTube ของช่องที่คุณกำลังใช้งานวิดีโอ เพิ่ม แล้ว ต้องระบุพารามิเตอร์นี้เมื่อคำขอระบุค่าสำหรับ onBehalfOfContentOwner และใช้ได้ใน ร่วมกับพารามิเตอร์นั้น นอกจากนี้ คำขอจะต้อง ได้รับอนุญาตโดยใช้บัญชี CMS ที่ลิงก์กับเจ้าของเนื้อหาที่ ระบุพารามิเตอร์ onBehalfOfContentOwner สุดท้าย แชแนลที่ค่าพารามิเตอร์ onBehalfOfContentOwnerChannel ระบุต้องลิงก์กับเจ้าของเนื้อหาที่ onBehalfOfContentOwner ระบุพารามิเตอร์

มีไว้สำหรับพาร์ทเนอร์ด้านเนื้อหาของ YouTube ที่เป็นเจ้าของและจัดการ ช่อง YouTube ต่างๆ ซึ่งจะช่วยให้เจ้าของเนื้อหาสามารถตรวจสอบสิทธิ์เพียงครั้งเดียว และดำเนินการในนามของแชแนลที่ระบุในพารามิเตอร์ โดยไม่ต้องระบุข้อมูลเข้าสู่ระบบการตรวจสอบสิทธิ์สำหรับ ช่องทางแยกต่างหาก

เนื้อหาของคำขอ

ระบุทรัพยากรplaylist Images ในเนื้อหาคำขอ

สำหรับแหล่งข้อมูลดังกล่าว

  • คุณต้องระบุค่าสำหรับพร็อพเพอร์ตี้เหล่านี้

    • snippet.playlistId
    • snippet.type

  • คุณกำหนดค่าให้กับพร็อพเพอร์ตี้เหล่านี้ได้

    • snippet.width
    • snippet.height

คำตอบ

หากสำเร็จ เมธอดนี้จะแสดงทรัพยากรplaylistImages ในเนื้อหาการตอบกลับ