Watermarks: set

อัปโหลดรูปภาพลายน้ำไปยัง YouTube และตั้งค่าสำหรับช่อง

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

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

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

ส่งคำขอ

คำขอ HTTP

POST https://www.googleapis.com/upload/youtube/v3/watermarks/set

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

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

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

พารามิเตอร์

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

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

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

เนื้อความของคำขอ

ระบุทรัพยากร watermark ในเนื้อหาคำขอ ทรัพยากรมีพร็อพเพอร์ตี้ต่อไปนี้

  • timing (object, ต้องระบุ): ห่อหุ้มเวลาแสดงลายน้ำ
    • timing.type (string, ต้องระบุ): ตั้งค่าเป็น offsetFromStart หรือ offsetFromEnd
    • timing.offsetMs (unsigned long, ต้องระบุ): ออฟเซ็ตเริ่มต้นเป็นมิลลิวินาที ต้องมีระยะเวลาอย่างน้อย 1000 มิลลิวินาที หาก type เป็น offsetFromEnd
    • timing.durationMs (unsigned long, ไม่บังคับ): ระยะเวลาที่มองเห็นได้เป็นมิลลิวินาที (ขั้นต่ำ 1000 มิลลิวินาที) หาก type เป็น offsetFromEnd ต้องไม่เกิน offsetMs
  • targetChannelId (string, ไม่บังคับ): รหัสช่อง YouTube ที่ลายน้ำลิงก์ไป หากไม่ระบุ ระบบจะลิงก์ไปยังช่องที่ระบุโดย channelId
  • position (object เลิกใช้งานแล้ว): YouTube จะไม่สนใจ ระบบจะวางลายน้ำไว้ที่มุมขวาบนเสมอ

คำตอบ

หากสำเร็จ เมธอดนี้จะแสดงรหัสสถานะ HTTP 204 No Content

ข้อผิดพลาด

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

ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย
badRequest (400) imageFormatUnsupported รูปภาพที่คุณระบุอยู่ในรูปแบบที่ระบบไม่รองรับ
badRequest (400) imageTooTall รูปภาพที่คุณส่งมาสูงเกินไป
badRequest (400) imageTooWide รูปภาพที่คุณระบุมีความกว้างมากเกินไป
badRequest (400) mediaBodyRequired คำขอต้องไม่มีเนื้อหารูปภาพ
forbidden (403) forbidden ตั้งลายน้ำสำหรับช่องที่ระบุไม่ได้ คำขออาจไม่ได้รับอนุญาตอย่างถูกต้อง หรือตั้งค่าพารามิเตอร์ channelId เป็นค่าที่ไม่ถูกต้อง

ลองใช้งาน

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