ChannelBanners: insert

อัปโหลดรูปภาพแบนเนอร์ของช่องไปยัง YouTube เมธอดนี้จะแสดง 2 ขั้นตอนแรกของกระบวนการ 3 ขั้นตอนเพื่ออัปเดตรูปภาพแบนเนอร์สำหรับช่อง

  1. เรียกใช้เมธอด channelBanners.insert เพื่ออัปโหลดข้อมูลรูปภาพไบนารีไปยัง YouTube รูปภาพต้องมีสัดส่วนภาพ 16:9 และมีขนาดอย่างน้อย 2048x1152 พิกเซล เราขอแนะนำให้อัปโหลดรูปภาพขนาด 2560 x 1440 พิกเซล
  2. ดึงค่าของพร็อพเพอร์ตี้ url จากการตอบกลับที่ API แสดงผลในขั้นตอนที่ 1
  3. เรียกใช้เมธอด channels.update เพื่ออัปเดตการตั้งค่าการสร้างแบรนด์ของช่อง ตั้งค่าของพร็อพเพอร์ตี้ brandingSettings.image.bannerExternalUrl เป็น URL ที่ได้ในขั้นตอนที่ 2

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

  • ขนาดไฟล์สูงสุด: 6 MB
  • ประเภท MIME ของสื่อที่ยอมรับ: image/jpeg, image/png, application/octet-stream

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

ส่งคำขอ

คำขอ HTTP

POST https://www.googleapis.com/upload/youtube/v3/channelBanners/insert

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

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

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

พารามิเตอร์

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

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

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

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

ไม่ต้องระบุเนื้อหาคำขอเมื่อเรียกใช้วิธีการนี้

คำตอบ

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

ข้อผิดพลาด

ตารางต่อไปนี้ระบุข้อความแสดงข้อผิดพลาดที่ API อาจแสดงผลเพื่อตอบสนองต่อการเรียกเมธอดนี้ โปรดดูรายละเอียดเพิ่มเติมในเอกสารประกอบข้อความแสดงข้อผิดพลาด

ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย
badRequest (400) bannerAlbumFull อัลบั้มหน้าปกช่อง YouTube มีรูปภาพมากเกินไป โปรดไปที่ http://photos.google.com ไปยังหน้าอัลบั้ม และนำบางภาพออกจากรูปภาพจากอัลบั้มนั้น
badRequest (400) mediaBodyRequired คำขอไม่รวมเนื้อหารูปภาพ

ลองใช้เลย

ใช้ APIs Explorer เพื่อเรียกใช้ API นี้เพื่อดูคำขอและการตอบสนองของ API