LiveBroadcasts: insert

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

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

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

ส่งคำขอ

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

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

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

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

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

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

  • snippet.title
  • snippet.description
  • snippet.categoryId
  • 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
  • contentDetails.availabilityConfig
  หมายเหตุ: ตารางพร็อพเพอร์ตี้จะแสดงค่าเริ่มต้นที่ตั้งไว้สำหรับพร็อพเพอร์ตี้ที่ระบุ ระบบจะกำหนดค่าเริ่มต้นในกรณีใดกรณีหนึ่งต่อไปนี้
  

  • คุณไม่ได้ระบุค่าสำหรับพร็อพเพอร์ตี้เหล่านั้น
  • ค่าพารามิเตอร์ 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