LiveStreams: update

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

Use Case ทั่วไป

ส่งคำขอ

คำขอ HTTP

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

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

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

ขอบเขต
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 ระบุว่าข้อมูลเข้าสู่ระบบการให้สิทธิ์ของคำขอระบุผู้ใช้ YouTube CMS ที่ดำเนินการในนามของเจ้าของเนื้อหาที่ระบุไว้ในค่าพารามิเตอร์ พารามิเตอร์นี้มีไว้สำหรับพาร์ทเนอร์เนื้อหาของ 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 ในเนื้อหาการตอบสนอง

ข้อผิดพลาด

ตารางต่อไปนี้ระบุข้อความแสดงข้อผิดพลาดที่ 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 ผู้ใช้สามารถดูข้อมูลเพิ่มเติมได้ที่ https://www.youtube.com/features
invalidValue (400) invalidDescription ค่าของพร็อพเพอร์ตี้ snippet.description ในทรัพยากร LiveStream มีอักขระได้สูงสุด 10,000 ตัว
invalidValue (400) invalidTitle ค่าของพร็อพเพอร์ตี้ snippet.title ในทรัพยากร LiveStream ต้องมีความยาวระหว่าง 1 ถึง 128 อักขระ
notFound (404) liveStreamNotFound ไม่มีสตรีมแบบสดที่ระบุ
required (400) idRequired ทรัพยากร LiveStream ต้องระบุค่าสำหรับพร็อพเพอร์ตี้ id
required (400) ingestionTypeRequired ทรัพยากร LiveStream ต้องระบุค่าสำหรับพร็อพเพอร์ตี้ cdn.ingestionType
required (400) titleRequired ทรัพยากร LiveStream ต้องระบุค่าสำหรับพร็อพเพอร์ตี้ snippet.title

ลองใช้เลย

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