LiveBroadcasts: insert

ตอนนี้ API รองรับความสามารถในการตั้งสถานะการถ่ายทอดสดเป็น "สร้างมาเพื่อเด็ก" แล้ว ตอนนี้ทรัพยากร liveBroadcast มีพร็อพเพอร์ตี้ที่ระบุสถานะ "สร้างมาเพื่อเด็ก" ของการถ่ายทอดสดดังกล่าวแล้ว เราได้ปรับปรุงข้อกําหนดในการให้บริการและนโยบายสําหรับนักพัฒนาซอฟต์แวร์ ของบริการ YouTube API ในวันที่ 10 มกราคม 2020 เช่นกัน สําหรับประวัติเพิ่มเติม โปรดอ่านประวัติการแก้ไขสําหรับบริการ API สตรีมมิงแบบสดของ YouTube และข้อกําหนดในการให้บริการของบริการ YouTube API

สร้างการประกาศ

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

ส่งคำขอ

คำขอ HTTP

POST https://www.googleapis.com/youtube/v3/liveBroadcasts

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

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

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

พารามิเตอร์

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

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

พร็อพเพอร์ตี้ part ที่คุณสามารถใส่ในค่าพารามิเตอร์ได้คือ id, snippet, contentDetails และ status
พารามิเตอร์ที่ไม่บังคับ
onBehalfOfContentOwner string
พารามิเตอร์นี้ใช้ได้เฉพาะในคําขอที่ได้รับอนุญาตอย่างถูกต้อง หมายเหตุ: พารามิเตอร์นี้มีไว้สําหรับพาร์ทเนอร์เนื้อหาของ YouTube เท่านั้น

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

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

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

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

ระบุแหล่งข้อมูล LiveBroadcast ในส่วนเนื้อหาของคําขอ สําหรับทรัพยากรดังกล่าว ให้ทําดังนี้

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

    • snippet.title
    • snippet.scheduledStartTime
    • status.privacyStatus

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

    • snippet.title
    • snippet.description
    • snippet.scheduledStartTime
    • snippet.scheduledEndTime
    • status.privacyStatus
    • status.selfDeclaredMadeForKids
    • contentDetails.monitorStream.enableMonitorStream
    • contentDetails.monitorStream.broadcastStreamDelayMs
    • contentDetails.enableAutoStart
    • contentDetails.enableAutoStop
    • contentDetails.enableClosedCaptions
    • contentDetails.enableDvr
    • contentDetails.enableEmbed
    • contentDetails.recordFromStart

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

คำตอบ

หากใช้วิธีนี้ วิธีนี้จะแสดงทรัพยากร LiveBroadcast ในเนื้อหาการตอบกลับ

ข้อผิดพลาด

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

ประเภทข้อผิดพลาด รายละเอียดข้อผิดพลาด คำอธิบาย
insufficientPermissions insufficientLivePermissions คําขอไม่ได้รับอนุญาตให้สร้างการถ่ายทอดสด
insufficientPermissions livePermissionBlocked ผู้ใช้ที่ให้สิทธิ์คําขอไม่สามารถสตรีมวิดีโอสดบน YouTube ได้ในขณะนี้ ดูรายละเอียดที่อธิบายสาเหตุที่ผู้ใช้สตรีมวิดีโอสดไม่ได้ในการตั้งค่าช่องของผู้ใช้ที่ https://www.youtube.com/features
insufficientPermissions liveStreamingNotEnabled ผู้ใช้ที่ให้สิทธิ์คําขอไม่ได้เปิดใช้สตรีมวิดีโอสดบน YouTube ผู้ใช้จะดูข้อมูลเพิ่มเติมได้ที่ https://www.youtube.com/features
invalidValue (400) invalidAutoStart ทรัพยากร liveBroadcast มีค่าที่ไม่ถูกต้องสําหรับพร็อพเพอร์ตี้ contentDetails.enableAutoStart การออกอากาศบางรายการไม่รองรับการตั้งค่านี้
invalidValue (400) invalidAutoStop ทรัพยากร liveBroadcast มีค่าที่ไม่ถูกต้องสําหรับพร็อพเพอร์ตี้ contentDetails.enableAutoStop คุณไม่สามารถแก้ไขการตั้งค่า enableAutoStop สําหรับการออกอากาศถาวร
invalidValue (400) invalidDescription ทรัพยากร liveBroadcast ไม่ได้ระบุค่าที่ถูกต้องสําหรับพร็อพเพอร์ตี้ snippet.description ค่าของพร็อพเพอร์ตี้มีอักขระได้สูงสุด 5,000 ตัว
invalidValue (400) invalidEmbedSetting ทรัพยากร liveBroadcast มีค่าที่ไม่ถูกต้องสําหรับพร็อพเพอร์ตี้ contentDetails.enable_embed คุณไม่สามารถฝังการออกอากาศนี้
invalidValue (400) invalidLatencyPreferenceOptions ทรัพยากร liveBroadcast มีค่าที่ไม่ถูกต้องสําหรับพร็อพเพอร์ตี้ contentDetails.latencyPreference การตั้งค่าเวลาในการตอบสนองบางอย่างอาจไม่รองรับการตั้งค่าบางอย่าง
invalidValue (400) invalidPrivacyStatus ทรัพยากร liveBroadcast มีค่าที่ไม่ถูกต้องสําหรับพร็อพเพอร์ตี้ status.privacy_status
invalidValue (400) invalidProjection ทรัพยากร liveBroadcast มีค่าที่ไม่ถูกต้องสําหรับพร็อพเพอร์ตี้ contentDetails.projection ตั้งการคาดคะเนเริ่มต้นของการออกอากาศเป็น 360 ไม่ได้
invalidValue (400) invalidScheduledEndTime ทรัพยากร liveBroadcast มีค่าที่ไม่ถูกต้องสําหรับพร็อพเพอร์ตี้ snippet.scheduledEndTime เวลาสิ้นสุดที่กําหนดไว้ต้องเป็นไปตามเวลาเริ่มต้นที่กําหนดไว้
invalidValue (400) invalidScheduledStartTime ทรัพยากร liveBroadcast มีค่าที่ไม่ถูกต้องสําหรับพร็อพเพอร์ตี้ snippet.scheduledStartTime เวลาเริ่มต้นที่กําหนดไว้ต้องเป็นวันที่ในอนาคตและใกล้กับวันที่ปัจจุบันที่ตั้งเวลาให้ออกอากาศได้อย่างน่าเชื่อถือในเวลานั้น
invalidValue (400) invalidTitle ทรัพยากร liveBroadcast ไม่ได้ระบุค่าที่ถูกต้องสําหรับพร็อพเพอร์ตี้ snippet.title ค่าของพร็อพเพอร์ตี้ต้องมีความยาวระหว่าง 1 ถึง 100 อักขระ
limitExceeded userBroadcastsExceedLimit ผู้ใช้ได้สร้างการออกอากาศสดหรือตามกําหนดการมากเกินไป และต้องหยุดหรือลบบางรายการ
rateLimitExceeded userRequestsExceedRateLimit ผู้ใช้ส่งคําขอมากเกินไปในกรอบเวลาที่กําหนด
required (400) privacyStatusRequired ทรัพยากร liveBroadcast ต้องระบุสถานะความเป็นส่วนตัว ดูค่า privacyStatus ที่ถูกต้อง
required (400) scheduledEndTimeRequired ทรัพยากร liveBroadcast ต้องระบุพร็อพเพอร์ตี้ snippet.scheduledEndTime
required (400) scheduledStartTimeRequired ทรัพยากร liveBroadcast ต้องระบุพร็อพเพอร์ตี้ snippet.scheduledStartTime
required (400) titleRequired ทรัพยากร liveBroadcast ต้องระบุพร็อพเพอร์ตี้ snippet.title

ลองใช้เลย

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