LiveStreams: update

อัปเดตสตรีมวิดีโอ หากอัปเดตพร็อพเพอร์ตี้ที่ต้องการเปลี่ยนไม่ได้ คุณจะต้องสร้างสตรีมใหม่ที่มีการตั้งค่าที่เหมาะสม

กรณีการใช้งานทั่วไป

ส่งคำขอ

คำขอ HTTP

PUT https://www.googleapis.com/youtube/v3/liveStreams

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

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

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

พารามิเตอร์

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

พารามิเตอร์
พารามิเตอร์ที่จำเป็น
part string
พารามิเตอร์ part มีไว้เพื่อวัตถุประสงค์ 2 อย่างในการดำเนินการนี้ โดยจะระบุพร็อพเพอร์ตี้ที่การดำเนินการเขียนจะตั้งค่า รวมถึงพร็อพเพอร์ตี้ที่การตอบกลับของ API จะรวมไว้ด้วย

พร็อพเพอร์ตี้ part ที่คุณรวมไว้ในค่าพารามิเตอร์ได้ ได้แก่ id, snippet, cdn และ status

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

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

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

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

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

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

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

    • id
    • snippet.title
    • cdn.frameRate
    • cdn.ingestionType
    • cdn.resolution

  • คุณตั้งค่าพร็อพเพอร์ตี้ต่อไปนี้ได้

    • snippet.title
    • snippet.description

    หากคุณส่งคำขออัปเดต แต่ไม่ได้ระบุค่าสำหรับพร็อพเพอร์ตี้ที่มีค่าอยู่แล้ว ระบบจะลบค่าที่มีอยู่ของพร็อพเพอร์ตี้นั้น

คำตอบ

หากดำเนินการสำเร็จ วิธีการนี้จะแสดงผล liveStream resource ในเนื้อหาการตอบกลับ

ข้อผิดพลาด

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

ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย
forbidden (403) liveStreamModificationNotAllowed ไม่สามารถแก้ไขไลฟ์สดที่ระบุในสถานะปัจจุบันได้ ดูข้อมูลเพิ่มเติมได้ที่อายุการใช้งานของออกอากาศ
forbidden (403) liveStreamModificationNotAllowed API ไม่อนุญาตให้คุณเปลี่ยนค่าของช่อง cdn.format, cdn.frameRate, cdn.ingestionType หรือ cdn.resolution หลังจากที่สร้างสตรีมแล้ว
forbidden (403) liveStreamModificationNotAllowed API ไม่อนุญาตให้คุณเปลี่ยนสตรีมที่นํามาใช้ซ้ำได้เป็นสตรีมที่นํามาใช้ซ้ำไม่ได้ หรือเปลี่ยนสตรีมที่นํามาใช้ซ้ำไม่ได้เป็นสตรีมที่นํามาใช้ซ้ำได้ ดูข้อมูลเพิ่มเติมได้ที่การทำความเข้าใจการออกอากาศและสตรีม
insufficientPermissions insufficientLivePermissions คำขอไม่ได้รับอนุญาตให้อัปเดตสตรีมแบบสดที่ระบุ ดูข้อมูลเพิ่มเติมได้ที่การใช้การตรวจสอบสิทธิ์ OAuth2
insufficientPermissions liveStreamingNotEnabled ผู้ใช้ที่อนุญาตให้ส่งคำขอนี้ไม่มีสิทธิ์สตรีมวิดีโอสดบน YouTube ผู้ใช้ดูข้อมูลเพิ่มเติมได้ที่การมีสิทธิ์ใช้ฟีเจอร์
invalidValue (400) invalidDescription ค่าของพร็อพเพอร์ตี้ snippet.description ในทรัพยากรสตรีมแบบสดมีอักขระได้สูงสุด 10,000 ตัว
invalidValue (400) invalidTitle ค่าของพร็อพเพอร์ตี้ snippet.title ในทรัพยากรสตรีมแบบสดต้องมีความยาวระหว่าง 1 ถึง 128 อักขระ
notFound (404) liveStreamNotFound ไม่มีสตรีมแบบสดที่ระบุ
required (400) idRequired ทรัพยากรสตรีมแบบสดต้องระบุค่าสำหรับพร็อพเพอร์ตี้ id
required (400) ingestionTypeRequired ทรัพยากรสตรีมแบบสดต้องระบุค่าสำหรับพร็อพเพอร์ตี้ cdn.ingestionType
required (400) titleRequired ทรัพยากรสตรีมแบบสดต้องระบุค่าสำหรับพร็อพเพอร์ตี้ snippet.title

ลองใช้งาน

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