ChannelBanners

ทรัพยากร channelBanner มี URL ที่คุณจะใช้เพื่อตั้งค่ารูปภาพที่อัปโหลดใหม่เป็นรูปภาพแบนเนอร์ของช่อง

เมธอด

API รองรับวิธีการต่อไปนี้สำหรับทรัพยากร channelBanners

แทรก
อัปโหลดรูปภาพแบนเนอร์ของช่องไปยัง 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

การนําเสนอทรัพยากร

โครงสร้าง JSON ต่อไปนี้แสดงรูปแบบของทรัพยากร channelBanners

{
  "kind": "youtube#channelBannerResource",
  "etag": etag,
  "url": string
}

พร็อพเพอร์ตี้

ตารางต่อไปนี้จะกำหนดพร็อพเพอร์ตี้ที่ปรากฏในทรัพยากรนี้

พร็อพเพอร์ตี้
kind string
ระบุประเภทของทรัพยากร API ค่าจะเป็น youtube#channelBannerResource
etag etag
Etag ของทรัพยากรนี้
url string
URL ของรูปภาพแบนเนอร์ หลังจากเรียกใช้เมธอด channelBanners.insert ให้ดึงค่านี้จากการตอบกลับของ API จากนั้นเรียกใช้เมธอด channels.update และตั้งค่า URL เป็นค่าของพร็อพเพอร์ตี้ brandingSettings.image.bannerExternalUrl เพื่อตั้งค่ารูปภาพแบนเนอร์ของช่อง