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