LiveBroadcasts: insert

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

สร้างการออกอากาศ

Use Case ทั่วไป

ส่งคำขอ

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

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

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

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

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

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

    • 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 แหล่งข้อมูลการถ่ายทอดสดมีค่าที่ไม่ถูกต้องสำหรับพร็อพเพอร์ตี้ contentDetails.enable_embed คุณไม่สามารถฝังการออกอากาศนี้
invalidValue (400) invalidLatencyPreferenceOptions แหล่งข้อมูล LiveBroadcast มีค่าที่ไม่ถูกต้องสำหรับพร็อพเพอร์ตี้ contentDetails.latencyPreference ค่ากำหนดเวลาในการตอบสนองนี้ไม่รองรับการตั้งค่าบางอย่าง
invalidValue (400) invalidPrivacyStatus แหล่งข้อมูลการถ่ายทอดสดมีค่าที่ไม่ถูกต้องสำหรับพร็อพเพอร์ตี้ status.privacy_status
invalidValue (400) invalidProjection แหล่งข้อมูลการถ่ายทอดสดมีค่าที่ไม่ถูกต้องสำหรับพร็อพเพอร์ตี้ contentDetails.projection ตั้งการฉายภาพเริ่มต้นของการออกอากาศเป็น 360 ไม่ได้
invalidValue (400) invalidScheduledEndTime แหล่งข้อมูลการถ่ายทอดสดมีค่าที่ไม่ถูกต้องสำหรับพร็อพเพอร์ตี้ snippet.scheduledEndTime เวลาสิ้นสุดที่กำหนดไว้ต้องเป็นไปตามเวลาเริ่มต้นที่กำหนดไว้
invalidValue (400) invalidScheduledStartTime แหล่งข้อมูลการถ่ายทอดสดมีค่าที่ไม่ถูกต้องสำหรับพร็อพเพอร์ตี้ snippet.scheduledStartTime เวลาเริ่มต้นที่กำหนดไว้ต้องเป็นวันที่ในอนาคตและใกล้เคียงกับวันที่ปัจจุบันซึ่งสามารถกำหนดเวลาออกอากาศได้อย่างน่าเชื่อถือ
invalidValue (400) invalidTitle แหล่งข้อมูล LiveBroadcast ไม่ได้ระบุค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้ snippet.title ค่าของพร็อพเพอร์ตี้ต้องมีความยาวระหว่าง 1 ถึง 100 อักขระ
limitExceeded userBroadcastsExceedLimit ผู้ใช้สร้างการออกอากาศสดหรือออกอากาศแบบกำหนดเวลามากเกินไปและต้องหยุดหรือลบบางรายการ
rateLimitExceeded userRequestsExceedRateLimit ผู้ใช้ส่งคำขอมากเกินไปในกรอบเวลาที่กำหนด
required (400) privacyStatusRequired แหล่งข้อมูลการถ่ายทอดสดต้องระบุสถานะความเป็นส่วนตัว ดูค่า privacyStatus ที่ถูกต้อง
required (400) scheduledEndTimeRequired แหล่งข้อมูลการถ่ายทอดสดต้องระบุพร็อพเพอร์ตี้ snippet.scheduledEndTime
required (400) scheduledStartTimeRequired แหล่งข้อมูลการถ่ายทอดสดต้องระบุพร็อพเพอร์ตี้ snippet.scheduledStartTime
required (400) titleRequired แหล่งข้อมูลการถ่ายทอดสดต้องระบุพร็อพเพอร์ตี้ snippet.title

ลองใช้เลย

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