YouTube Live Streaming API - Errors
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
เอกสารนี้ระบุประเภทข้อผิดพลาดต่างๆ ที่การดำเนินการ YouTube Live Streaming API อาจแสดง นอกจากนี้ คุณยังดูรายการข้อผิดพลาดสำหรับแต่ละวิธีได้ในเอกสารอ้างอิงของวิธีนั้นๆ
fanFundingEvents
ตารางต่อไปนี้ระบุข้อความแสดงข้อผิดพลาดที่ API แสดงเพื่อตอบสนองต่อการเรียกที่เกี่ยวข้องกับทรัพยากร fanFundingEvents
fanFundingEvents.list
ประเภทข้อผิดพลาด |
รายละเอียดข้อผิดพลาด |
คำอธิบาย |
forbidden (403) |
insufficientPermissions |
คุณไม่มีสิทธิ์ที่จำเป็นในการดูกิจกรรมการให้เงินสนับสนุนของแฟนๆ ในช่อง |
invalidValue (400) |
fanFundingNotEnabledForChannelId |
ช่องไม่ได้เปิดใช้การให้เงินสนับสนุนของแฟนๆ |
liveBroadcasts
ตารางต่อไปนี้ระบุข้อความแสดงข้อผิดพลาดที่ API แสดงเพื่อตอบสนองต่อการเรียกที่เกี่ยวข้องกับทรัพยากร liveBroadcasts
liveBroadcasts.bind
ประเภทข้อผิดพลาด |
รายละเอียดข้อผิดพลาด |
คำอธิบาย |
backendError |
internalError |
เกิดข้อผิดพลาดภายในระหว่างการเชื่อมโยง |
forbidden (403) |
liveBroadcastBindingNotAllowed |
สถานะปัจจุบันของการออกอากาศสดไม่อนุญาตให้เชื่อมโยงกับการสตรีม |
insufficientPermissions |
insufficientLivePermissions |
คำขอไม่ได้รับอนุญาตให้ดึงข้อมูลการถ่ายทอดสดที่ระบุ ดูข้อมูลเพิ่มเติมได้ที่การใช้การตรวจสอบสิทธิ์ OAuth2 |
insufficientPermissions |
liveStreamingNotEnabled |
ผู้ใช้ที่ให้สิทธิ์คำขอไม่ได้เปิดใช้การสตรีมวิดีโอสดบน YouTube ผู้ใช้ดูข้อมูลเพิ่มเติมได้ที่ https://www.youtube.com/features |
notFound (404) |
liveBroadcastNotFound |
ไม่มีการออกอากาศที่ระบุโดยพารามิเตอร์ id |
notFound (404) |
liveStreamNotFound |
ไม่มีสตรีมที่ระบุโดยพารามิเตอร์ streamId |
rateLimitExceeded |
userRequestsExceedRateLimit |
ผู้ใช้ส่งคำขอมากเกินไปในช่วงเวลาที่กำหนด |
required (400) |
idRequired |
พารามิเตอร์ id ที่จำเป็นต้องระบุต้องระบุการออกอากาศที่จะเชื่อมโยง |
liveBroadcasts.delete
ประเภทข้อผิดพลาด |
รายละเอียดข้อผิดพลาด |
คำอธิบาย |
forbidden (403) |
liveBroadcastDeletionNotAllowed |
สถานะปัจจุบันของการถ่ายทอดสดไม่อนุญาตให้ลบ |
insufficientPermissions |
insufficientLivePermissions |
คำขอไม่ได้รับอนุญาตให้ลบการถ่ายทอดสดที่ระบุ ดูข้อมูลเพิ่มเติมได้ที่การใช้การตรวจสอบสิทธิ์ OAuth2 |
insufficientPermissions |
liveStreamingNotEnabled |
ผู้ใช้ที่ให้สิทธิ์คำขอไม่ได้เปิดใช้การสตรีมวิดีโอสดบน YouTube ผู้ใช้ดูข้อมูลเพิ่มเติมได้ที่ https://www.youtube.com/features |
notFound (404) |
liveBroadcastNotFound |
พร็อพเพอร์ตี้ id ที่ระบุในแหล่งข้อมูล liveBroadcast ไม่ได้ระบุการออกอากาศ |
liveBroadcasts.insert
ประเภทข้อผิดพลาด |
รายละเอียดข้อผิดพลาด |
คำอธิบาย |
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 |
liveBroadcasts.list
ประเภทข้อผิดพลาด |
รายละเอียดข้อผิดพลาด |
คำอธิบาย |
insufficientPermissions |
insufficientLivePermissions |
คำขอไม่ได้รับอนุญาตให้ดึงข้อมูลการออกอากาศสด |
insufficientPermissions |
liveStreamingNotEnabled |
ผู้ใช้ที่ให้สิทธิ์คำขอไม่ได้เปิดใช้การสตรีมวิดีโอสดบน YouTube ผู้ใช้ดูข้อมูลเพิ่มเติมได้ที่ https://www.youtube.com/features |
liveBroadcasts.transition
ประเภทข้อผิดพลาด |
รายละเอียดข้อผิดพลาด |
คำอธิบาย |
backendError |
errorExecutingTransition |
เกิดข้อผิดพลาดขณะเปลี่ยนสถานะการออกอากาศ |
forbidden (403) |
errorStreamInactive |
ไม่อนุญาตให้เปลี่ยนฉากตามที่ขอเมื่อสตรีมที่เชื่อมโยงกับการออกอากาศไม่ได้ใช้งาน |
forbidden (403) |
invalidTransition |
การถ่ายทอดสดเปลี่ยนจากสถานะปัจจุบันเป็นสถานะที่ขอไม่ได้ |
forbidden (403) |
redundantTransition |
การถ่ายทอดสดอยู่ในสถานะที่ขอหรือกำลังประมวลผลเป็นสถานะที่ขอ |
insufficientPermissions |
insufficientLivePermissions |
คำขอไม่ได้รับอนุญาตให้เปลี่ยนสถานะการออกอากาศสด |
insufficientPermissions |
livePermissionBlocked |
ขณะนี้ผู้ใช้ที่ให้สิทธิ์คำขอไม่สามารถสตรีมวิดีโอสดบน YouTube รายละเอียดที่อธิบายสาเหตุที่ผู้ใช้สตรีมวิดีโอสดไม่ได้อาจอยู่ในส่วนการตั้งค่าช่องของผู้ใช้ที่ https://www.youtube.com/features |
insufficientPermissions |
liveStreamingNotEnabled |
ผู้ใช้ที่ให้สิทธิ์คำขอไม่ได้เปิดใช้การสตรีมวิดีโอสดบน YouTube ผู้ใช้ดูข้อมูลเพิ่มเติมได้ที่ https://www.youtube.com/features |
notFound (404) |
liveBroadcastNotFound |
ไม่มีการออกอากาศที่ระบุโดยพารามิเตอร์ id |
rateLimitExceeded (403) |
userRequestsExceedRateLimit |
ผู้ใช้ส่งคำขอมากเกินไปในช่วงเวลาที่กำหนด |
required (400) |
idRequired |
พารามิเตอร์ id ที่จำเป็นต้องระบุการออกอากาศที่คุณต้องการเปลี่ยนสถานะ |
required (400) |
statusRequired |
คำขอ API ต้องระบุค่าสำหรับพารามิเตอร์ status |
liveBroadcasts.update
ประเภทข้อผิดพลาด |
รายละเอียดข้อผิดพลาด |
คำอธิบาย |
forbidden (403) |
closedCaptionsTypeModificationNotAllowed |
จะแก้ไขค่า contentDetails.closedCaptionsType ได้ก็ต่อเมื่อการออกอากาศอยู่ในสถานะ created หรือ ready เท่านั้น |
forbidden (403) |
enableAutoStartModificationNotAllowed |
คุณจะแก้ไขค่า contentDetails.enableAutoStart ได้ก็ต่อเมื่อสตรีมไม่ได้ใช้งานและสถานะการออกอากาศเป็น created หรือ ready |
forbidden (403) |
enableClosedCaptionsModificationNotAllowed |
แก้ไขค่า contentDetails.enableClosedCaptions ได้ก็ต่อเมื่อสถานะการออกอากาศเป็น created หรือ ready |
forbidden (403) |
enableDvrModificationNotAllowed |
แก้ไขค่า contentDetails.enableDvr ได้ก็ต่อเมื่อสถานะการออกอากาศเป็น created หรือ ready |
forbidden (403) |
enableMonitorStreamModificationNotAllowed |
แก้ไขค่า contentDetails.monitorStream.enableMonitorStream ได้ก็ต่อเมื่อสถานะการออกอากาศเป็น created หรือ ready |
forbidden (403) |
recordFromStartModificationNotAllowed |
แก้ไขค่า contentDetails.recordFromStart ได้ก็ต่อเมื่อสถานะการออกอากาศเป็น created หรือ ready |
insufficientPermissions |
insufficientLivePermissions |
คำขอไม่ได้รับอนุญาตให้อัปเดตการถ่ายทอดสดที่ระบุ ดูข้อมูลเพิ่มเติมได้ที่การใช้การตรวจสอบสิทธิ์ OAuth2 |
insufficientPermissions |
liveStreamingNotEnabled |
ผู้ใช้ที่ให้สิทธิ์คำขอไม่ได้เปิดใช้การสตรีมวิดีโอสดบน YouTube ผู้ใช้ดูข้อมูลเพิ่มเติมได้ที่ https://www.youtube.com/features |
invalidValue (400) |
invalidAutoStart |
ทรัพยากร liveBroadcast
มีค่าที่ไม่ถูกต้องสำหรับพร็อพเพอร์ตี้ contentDetails.enableAutoStart
คุณไม่สามารถแก้ไขการตั้งค่า enableAutoStart สำหรับการออกอากาศแบบต่อเนื่องได้ |
invalidValue (400) |
invalidAutoStop |
ทรัพยากร liveBroadcast
มีค่าที่ไม่ถูกต้องสำหรับพร็อพเพอร์ตี้ contentDetails.enableAutoStop คุณ
ไม่สามารถแก้ไขการตั้งค่า enableAutoStop สำหรับการออกอากาศแบบต่อเนื่องได้ |
invalidValue (400) |
invalidDescription |
แหล่งข้อมูล liveBroadcast ไม่ได้ระบุค่าที่ถูกต้องสำหรับพร็อพเพอร์ตี้ snippet.description snippet.description มีอักขระได้สูงสุด 5,000 ตัว |
invalidValue (400) |
invalidEmbedSetting |
ทรัพยากร liveBroadcast มีค่าที่ไม่ถูกต้องสำหรับพร็อพเพอร์ตี้ contentDetails.enable_embed คุณฝังการออกอากาศนี้ไม่ได้ |
invalidValue (400) |
invalidEnableClosedCaptions |
ในทรัพยากร liveBroadcast ค่าของพร็อพเพอร์ตี้ contentDetails.enableClosedCaptions ไม่เข้ากันกับค่าของการตั้งค่า contentDetails.closedCaptionType แก้ไขทรัพยากรให้มีพร็อพเพอร์ตี้เพียงรายการเดียวจาก 2 รายการ แล้วส่งคำขออีกครั้ง |
invalidValue (400) |
invalidLatencyPreferenceOptions |
ทรัพยากร liveBroadcast
มีค่าที่ไม่ถูกต้องสำหรับพร็อพเพอร์ตี้ contentDetails.latencyPreference
การตั้งค่าบางอย่างไม่รองรับค่ากำหนดเวลาในการตอบสนองนี้
|
invalidValue (400) |
invalidPrivacyStatus |
แหล่งข้อมูล liveBroadcast ไม่ได้ระบุสถานะความเป็นส่วนตัวที่ถูกต้อง ดูค่า privacyStatus ที่ใช้ได้ |
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 snippet.title ต้องมีความยาวระหว่าง 1 ถึง 100 อักขระ |
notFound (404) |
liveBroadcastNotFound |
พร็อพเพอร์ตี้ id ที่ระบุในแหล่งข้อมูล liveBroadcast ไม่ได้ระบุการออกอากาศ |
required (400) |
broadcastStreamDelayMsRequired |
แหล่งข้อมูล liveBroadcast ไม่ได้ระบุพร็อพเพอร์ตี้ contentDetails.monitorStream.broadcastStreamDelayMs |
required (400) |
enableMonitorStreamRequired |
แหล่งข้อมูล liveBroadcast ไม่ได้ระบุพร็อพเพอร์ตี้ contentDetails.monitorStream.enableMonitorStream |
required (400) |
idRequired |
แหล่งข้อมูลการถ่ายทอดสดต้องมีและระบุค่าสำหรับพร็อพเพอร์ตี้ id |
required (400) |
privacyStatusRequired |
แหล่งข้อมูล liveBroadcast ไม่ได้ระบุสถานะความเป็นส่วนตัว ดูค่า privacyStatus ที่ใช้ได้ใน |
required (400) |
scheduledEndTimeRequired |
แหล่งข้อมูล liveBroadcast ไม่ได้ระบุพร็อพเพอร์ตี้ snippet.scheduledEndTime |
required (400) |
scheduledStartTimeRequired |
แหล่งข้อมูล liveBroadcast ไม่ได้ระบุพร็อพเพอร์ตี้ snippet.scheduledStartTime |
required (400) |
titleRequired |
แหล่งข้อมูล liveBroadcast ไม่ได้ระบุพร็อพเพอร์ตี้ snippet.title |
liveBroadcasts.cuepoint
ประเภทข้อผิดพลาด |
รายละเอียดข้อผิดพลาด |
คำอธิบาย |
insufficientPermissions (403) |
insufficientLivePermissions |
คำขอไม่ได้รับอนุญาตให้แทรกคิวพอยต์ในการออกอากาศสด
|
insufficientPermissions (403) |
liveStreamingNotEnabled |
ผู้ใช้ที่ให้สิทธิ์คำขอไม่ได้เปิดใช้การสตรีมวิดีโอสดบน YouTube
ผู้ใช้ดูข้อมูลเพิ่มเติมได้ที่
https://support.google.com/youtube/answer/2474026 และ
https://www.youtube.com/features |
rateLimitExceeded (403) |
userRequestsExceedRateLimit |
ผู้ใช้ส่งคำขอมากเกินไปในช่วงเวลาที่กำหนด |
required (400) |
idRequired |
พารามิเตอร์ id ที่จำเป็นต้องระบุการออกอากาศ
ที่คุณต้องการแทรกเครื่องหมาย |
required (400) |
cueTypeRequired |
ต้องระบุฟิลด์ cueType ที่จำเป็นในเนื้อหาคำขอ API |
notFound (404) |
liveBroadcastNotFound |
ไม่มีการออกอากาศที่ระบุโดยพารามิเตอร์ id |
invalidValue (400) |
conflictingTimeFields |
คุณระบุได้เพียงหนึ่งใน insertionOffsetTimeMs และ walltimeMs การตั้งค่าทั้ง 2 ค่าจะทำให้เกิดข้อผิดพลาด หากคุณไม่ได้ตั้งค่าใดค่าหนึ่ง YouTube จะใช้insertionOffsetTimeMs เวลา0 เริ่มต้น ซึ่งหมายความว่าระบบจะแทรกคิวพอยต์โดยเร็วที่สุด |
invalidValue (400) |
invalidInsertionOffsetTimeMs |
ทรัพยากร cuepoint ระบุค่าที่ไม่ถูกต้องสำหรับพร็อพเพอร์ตี้
insertionOffsetTimeMs ค่าต้องเป็น 0 หรือจำนวนเต็มบวก |
invalidValue (400) |
invalidWalltimeMs |
ทรัพยากร cuepoint ระบุค่าที่ไม่ถูกต้องสำหรับพร็อพเพอร์ตี้
walltimeMs ค่าต้องเป็นจำนวนเต็มที่แสดงการประทับเวลา Epoch
|
backendError (5xx) |
serviceUnavailable |
บริการไม่พร้อมใช้งาน โปรดลองส่งคำขออีกครั้งในอีกสักครู่ |
liveChatBans
ตารางต่อไปนี้ระบุข้อความแสดงข้อผิดพลาดที่ API แสดงเพื่อตอบสนองต่อการเรียกที่เกี่ยวข้องกับทรัพยากร liveChatBans
liveChatBans.delete
ประเภทข้อผิดพลาด |
รายละเอียดข้อผิดพลาด |
คำอธิบาย |
forbidden (403) |
forbidden |
นำการแบนที่ระบุออกไม่ได้ ข้อผิดพลาดนี้อาจเกิดขึ้นหากคำขอได้รับอนุญาตจากผู้ดูแลคนหนึ่งที่พยายามยกเลิกการแบนผู้ดูแลอีกคน |
forbidden (403) |
insufficientPermissions |
คุณไม่มีสิทธิ์ที่จำเป็นในการยกเลิกการแบนที่ระบุ |
invalidValue (400) |
invalidLiveChatBanId |
พารามิเตอร์ id ระบุค่าที่ไม่ถูกต้อง |
notFound (404) |
liveChatBanNotFound |
ไม่พบการแบนที่ระบุ |
liveChatBans.insert
ประเภทข้อผิดพลาด |
รายละเอียดข้อผิดพลาด |
คำอธิบาย |
forbidden (403) |
insufficientPermissions |
คุณไม่มีสิทธิ์ที่จำเป็นในการแบนผู้ใช้จากแชทสดที่ระบุ |
forbidden (403) |
liveChatBanInsertionNotAllowed |
สร้างการแบนที่ระบุไม่ได้ ข้อผิดพลาดนี้อาจเกิดขึ้นหากคำขอพยายามแบนเจ้าของแชทหรือผู้ดูแลคนอื่น |
invalidValue (400) |
invalidChannelId |
ไม่พบรหัสช่องที่ระบุ |
invalidValue (400) |
invalidLiveChatId |
ค่า snippet.liveChatId ที่ระบุในคำขอไม่ถูกต้อง ตรวจสอบทรัพยากร liveBroadcast ที่เชื่อมโยงเพื่อให้แน่ใจว่าคุณมีค่าที่ถูกต้อง |
notFound (404) |
liveChatNotFound |
ไม่พบแชทสดที่ระบุ ตรวจสอบทรัพยากร liveBroadcast ที่เชื่อมโยงเพื่อให้แน่ใจว่าคุณตั้งค่าพร็อพเพอร์ตี้ snippet.liveChatId เป็นค่าที่ถูกต้อง |
notFound (404) |
liveChatUserNotFound |
ไม่พบผู้ใช้แชทสดที่คุณพยายามแบน |
required (400) |
bannedUserChannelIdRequired |
ทรัพยากร liveChatBan ที่ส่งในเนื้อหาคำขอต้องระบุค่าสำหรับพร็อพเพอร์ตี้ snippet.bannedUserDetails.channelId |
required (400) |
liveChatIdRequired |
ทรัพยากร liveChatBan ที่ส่งในเนื้อหาคำขอต้องระบุค่าสำหรับพร็อพเพอร์ตี้ snippet.liveChatId |
liveChatMessages
ตารางต่อไปนี้ระบุข้อความแสดงข้อผิดพลาดที่ API แสดงเพื่อตอบสนองต่อการเรียกที่เกี่ยวข้องกับทรัพยากร liveChatMessages
liveChatMessages.delete
ประเภทข้อผิดพลาด |
รายละเอียดข้อผิดพลาด |
คำอธิบาย |
forbidden (403) |
forbidden |
คุณไม่มีสิทธิ์ที่จำเป็นในการลบข้อความที่ระบุ |
forbidden (403) |
modificationNotAllowed |
ลบทรัพยากร liveChatMessage ที่ระบุไม่ได้ พารามิเตอร์ id อาจระบุข้อความที่สร้างโดยผู้ดูแลหรือผู้ใช้รายอื่นที่ลบข้อความไม่ได้ |
notFound (404) |
liveChatMessageNotFound |
ไม่พบข้อความที่คุณพยายามลบ ตรวจสอบค่าของพารามิเตอร์ id เพื่อให้แน่ใจว่าถูกต้อง |
liveChatMessages.insert
ประเภทข้อผิดพลาด |
รายละเอียดข้อผิดพลาด |
คำอธิบาย |
forbidden (403) |
forbidden |
คุณไม่มีสิทธิ์ที่จำเป็นในการสร้างข้อความที่ระบุ |
forbidden (403) |
liveChatDisabled |
เจ้าของได้ปิดใช้แชทสดที่ระบุแล้ว ซึ่งหมายความว่าคุณจะเพิ่มข้อความลงในแชทไม่ได้ |
forbidden (403) |
liveChatEnded |
แชทสดที่ระบุสิ้นสุดแล้ว |
invalidValue (400) |
messageTextInvalid |
ข้อความ (snippet.textMessageDetails.messageText ) ไม่ถูกต้อง |
notFound (404) |
liveChatNotFound |
แชทสดที่ระบุในคำขอ API ไม่มีอยู่ ข้อผิดพลาดนี้จะเกิดขึ้นหากเจ้าของลบแชท |
rateLimitExceeded |
rateLimitExceeded |
ผู้ใช้โพสต์ข้อความแชทมากเกินไปในกรอบเวลาที่กำหนด |
required (400) |
liveChatIdRequired |
แหล่งข้อมูล liveChatMessage ต้องมีและระบุค่าสำหรับพร็อพเพอร์ตี้ snippet.liveChatId |
required (400) |
messageTextRequired |
แหล่งข้อมูล liveChatMessage ต้องมีและระบุค่าสำหรับพร็อพเพอร์ตี้ snippet.textMessageDetails.messageText |
required (400) |
typeRequired |
แหล่งข้อมูล liveChatMessage ต้องมีและระบุค่าสำหรับพร็อพเพอร์ตี้ snippet.type ตั้งค่าพารามิเตอร์เป็น text |
liveChatMessages.list
ประเภทข้อผิดพลาด |
รายละเอียดข้อผิดพลาด |
คำอธิบาย |
forbidden (403) |
forbidden |
คุณไม่มีสิทธิ์ที่จำเป็นในการดึงข้อความสำหรับแชทสดที่ระบุ |
forbidden (403) |
liveChatDisabled |
ไม่ได้เปิดใช้แชทสดสำหรับการออกอากาศที่ระบุ |
forbidden (403) |
liveChatEnded |
แชทสดที่ระบุสิ้นสุดแล้ว |
notFound (404) |
liveChatNotFound |
ไม่พบแชทสดที่คุณพยายามดึงข้อมูล ตรวจสอบค่าของพารามิเตอร์ liveChatId ของคำขอเพื่อให้แน่ใจว่าถูกต้อง |
rateLimitExceeded |
rateLimitExceeded |
ส่งคำขอเร็วเกินไปหลังจากส่งคำขอก่อนหน้า ข้อผิดพลาดนี้เกิดขึ้นเมื่อมีการส่งคำขอ API เพื่อดึงข้อความบ่อยกว่าอัตราการรีเฟรชของ YouTube ซึ่งทำให้สิ้นเปลืองแบนด์วิดท์โดยไม่จำเป็น |
liveCuepoints
ตารางต่อไปนี้ระบุข้อความแสดงข้อผิดพลาดที่ API แสดงเพื่อตอบสนองต่อการเรียกที่เกี่ยวข้องกับทรัพยากร liveCuepoints
liveCuepoints.insert
ประเภทข้อผิดพลาด |
รายละเอียดข้อผิดพลาด |
คำอธิบาย |
invalidValue (400) |
conflictingTimeFields |
คุณระบุได้เพียง 1 รายการจาก offsetTimeMs และ walltime |
liveChatMessages.streamlist
ประเภทข้อผิดพลาด |
รายละเอียดข้อผิดพลาด |
คำอธิบาย |
INVALID_ARGUMENT (3) |
LIVE_CHAT_ENDED |
คุณจะไม่สามารถดึงข้อความสำหรับแชทสดที่สิ้นสุดแล้วได้ |
PERMISSION_DENIED (7) |
forbidden |
คุณไม่มีสิทธิ์ที่จำเป็นในการดึงข้อความสำหรับแชทสดที่ระบุ |
PERMISSION_DENIED (7) |
liveChatDisabled |
ไม่ได้เปิดใช้แชทสดสำหรับการออกอากาศที่ระบุ |
PERMISSION_DENIED (7) |
liveChatEnded |
แชทสดที่ระบุสิ้นสุดแล้ว |
NOT_FOUND (5) |
liveChatNotFound |
ไม่พบแชทสดที่คุณพยายามดึงข้อมูล ตรวจสอบค่าของพารามิเตอร์ liveChatId ของคำขอเพื่อให้แน่ใจว่าถูกต้อง |
RESOURCE_EXHAUSTED (8) |
rateLimitExceeded |
ส่งคำขอเร็วเกินไปหลังจากส่งคำขอก่อนหน้า ข้อผิดพลาดนี้เกิดขึ้นเมื่อมีการส่งคำขอ API เพื่อดึงข้อความบ่อยกว่าอัตราการรีเฟรชของ YouTube ซึ่งทำให้สิ้นเปลืองแบนด์วิดท์โดยไม่จำเป็น |
liveCuepoints
ตารางต่อไปนี้ระบุข้อความแสดงข้อผิดพลาดที่ API แสดงเพื่อตอบสนองต่อการเรียกที่เกี่ยวข้องกับทรัพยากร liveCuepoints
liveCuepoints.insert
ประเภทข้อผิดพลาด |
รายละเอียดข้อผิดพลาด |
คำอธิบาย |
invalidValue (400) |
conflictingTimeFields |
คุณระบุได้เพียง 1 รายการจาก offsetTimeMs และ walltime |
liveStreams
ตารางต่อไปนี้ระบุข้อความแสดงข้อผิดพลาดที่ API แสดงเพื่อตอบสนองต่อการเรียกที่เกี่ยวข้องกับทรัพยากร liveStreams
liveStreams.delete
ประเภทข้อผิดพลาด |
รายละเอียดข้อผิดพลาด |
คำอธิบาย |
forbidden (403) |
liveStreamDeletionNotAllowed |
ไม่สามารถลบไลฟ์สดที่ระบุได้เนื่องจากเชื่อมโยงกับการออกอากาศที่ยังไม่เสร็จสมบูรณ์ |
insufficientPermissions |
insufficientLivePermissions |
คำขอไม่ได้รับอนุญาตให้ลบไลฟ์สดที่ระบุ ดูข้อมูลเพิ่มเติมได้ที่การติดตั้งใช้งานการตรวจสอบสิทธิ์ OAuth 2.0 |
insufficientPermissions |
liveStreamingNotEnabled |
ผู้ใช้ที่ให้สิทธิ์คำขอไม่ได้เปิดใช้การสตรีมวิดีโอสดบน YouTube ดูข้อมูลเพิ่มเติมได้ที่การมีสิทธิ์ใช้ฟีเจอร์ |
notFound (404) |
liveStreamNotFound |
ไม่มีไลฟ์สดที่ระบุ |
liveStreams.insert
ประเภทข้อผิดพลาด |
รายละเอียดข้อผิดพลาด |
คำอธิบาย |
insufficientPermissions |
insufficientLivePermissions |
คำขอไม่ได้รับอนุญาตให้สร้างไลฟ์สดที่ระบุ |
insufficientPermissions |
livePermissionBlocked |
ขณะนี้ผู้ใช้ที่ให้สิทธิ์คำขอไม่สามารถสตรีมวิดีโอสดบน YouTube รายละเอียดที่อธิบายสาเหตุที่ผู้ใช้สตรีมวิดีโอสดไม่ได้อาจอยู่ในส่วนการตั้งค่าช่องของผู้ใช้ที่ https://www.youtube.com/features |
insufficientPermissions |
liveStreamingNotEnabled |
ผู้ใช้ที่ให้สิทธิ์คำขอไม่ได้เปิดใช้การสตรีมวิดีโอสดบน YouTube ผู้ใช้ดูข้อมูลเพิ่มเติมได้ที่ https://www.youtube.com/features |
invalidValue (400) |
invalidDescription |
ค่าของพร็อพเพอร์ตี้ snippet.description ในทรัพยากร liveStream มีอักขระได้สูงสุด 10000 ตัว |
invalidValue (400) |
invalidFormat |
ค่าของพร็อพเพอร์ตี้ cdn.format ในทรัพยากร liveStream ไม่ถูกต้อง |
invalidValue (400) |
invalidFrameRate |
ค่าของพร็อพเพอร์ตี้ cdn.frameRate ในทรัพยากร liveStream ไม่ถูกต้อง |
invalidValue (400) |
invalidIngestionType |
ค่าของพร็อพเพอร์ตี้ cdn.ingestionType ในทรัพยากร liveStream ไม่ถูกต้อง |
invalidValue (400) |
invalidResolution |
ค่าของพร็อพเพอร์ตี้ cdn.resolution ในทรัพยากร liveStream ไม่ถูกต้อง |
invalidValue (400) |
invalidTitle |
ค่าของพร็อพเพอร์ตี้ snippet.title ในทรัพยากร liveStream ต้องมีความยาวระหว่าง 1 ถึง 128 อักขระ |
rateLimitExceeded |
userRequestsExceedRateLimit |
ผู้ใช้ส่งคำขอมากเกินไปในช่วงเวลาที่กำหนด |
required (400) |
cdnRequired |
ทรัพยากร liveStream ต้องมีออบเจ็กต์ cdn |
required (400) |
frameRateRequired |
API จะแสดงข้อผิดพลาดนี้หากคุณระบุค่าสำหรับพร็อพเพอร์ตี้ cdn.resolution แต่ไม่ได้ระบุค่าสำหรับพร็อพเพอร์ตี้ cdn.frameRate |
required (400) |
ingestionTypeRequired |
ทรัพยากร liveStream ต้องระบุค่าสำหรับพร็อพเพอร์ตี้ cdn.ingestionType |
required (400) |
resolutionRequired |
API จะแสดงข้อผิดพลาดนี้หากคุณระบุค่าสำหรับพร็อพเพอร์ตี้ cdn.frameRate แต่ไม่ได้ระบุค่าสำหรับพร็อพเพอร์ตี้ cdn.resolution |
required (400) |
titleRequired |
ทรัพยากร liveStream ต้องระบุค่าสำหรับพร็อพเพอร์ตี้ snippet.title |
liveStreams.list
ประเภทข้อผิดพลาด |
รายละเอียดข้อผิดพลาด |
คำอธิบาย |
insufficientPermissions |
insufficientLivePermissions |
คำขอไม่ได้รับอนุญาตให้ดึงข้อมูลไลฟ์สดที่ระบุ |
insufficientPermissions |
liveStreamingNotEnabled |
ผู้ใช้ที่ให้สิทธิ์คำขอไม่ได้เปิดใช้การสตรีมวิดีโอสดบน YouTube ผู้ใช้ดูข้อมูลเพิ่มเติมได้ที่ https://www.youtube.com/features |
liveStreams.update
ประเภทข้อผิดพลาด |
รายละเอียดข้อผิดพลาด |
คำอธิบาย |
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 มีอักขระได้สูงสุด 10000 ตัว |
invalidValue (400) |
invalidTitle |
ค่าของพร็อพเพอร์ตี้ snippet.title ในทรัพยากร liveStream ต้องมีความยาวระหว่าง 1 ถึง 128 อักขระ |
notFound (404) |
liveStreamNotFound |
ไม่มีไลฟ์สดที่ระบุ |
required (400) |
idRequired |
แหล่งข้อมูลสตรีมแบบสดต้องระบุค่าสำหรับพร็อพเพอร์ตี้ id |
required (400) |
ingestionTypeRequired |
แหล่งข้อมูลสตรีมแบบสดต้องระบุค่าสำหรับพร็อพเพอร์ตี้ cdn.ingestionType |
required (400) |
titleRequired |
แหล่งข้อมูลสตรีมแบบสดต้องระบุค่าสำหรับพร็อพเพอร์ตี้ snippet.title |
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-07-27 UTC
[null,null,["อัปเดตล่าสุด 2025-07-27 UTC"],[[["\u003cp\u003eThe API returns \u003ccode\u003eforbidden (403)\u003c/code\u003e or \u003ccode\u003einsufficientPermissions\u003c/code\u003e errors when a user lacks the necessary authorization to perform an action, such as creating, deleting, or viewing resources.\u003c/p\u003e\n"],["\u003cp\u003eSeveral API calls related to live broadcasts, streams, and cuepoints may return a \u003ccode\u003eliveStreamingNotEnabled\u003c/code\u003e error, which means that the user has not enabled live streaming for their channel.\u003c/p\u003e\n"],["\u003cp\u003eMany errors across different API resources are caused by \u003ccode\u003einvalidValue (400)\u003c/code\u003e issues, including invalid descriptions, titles, privacy status, or time-related fields, which indicate that the provided data does not meet the required criteria.\u003c/p\u003e\n"],["\u003cp\u003eRequests can fail with a \u003ccode\u003erateLimitExceeded\u003c/code\u003e error if a user surpasses the allowed request rate, which could happen in multiple \u003ccode\u003eliveBroadcasts\u003c/code\u003e, \u003ccode\u003eliveChatMessages\u003c/code\u003e, or \u003ccode\u003eliveStreams\u003c/code\u003e operations.\u003c/p\u003e\n"],["\u003cp\u003eMany errors indicate a \u003ccode\u003enotFound (404)\u003c/code\u003e issue, indicating that a broadcast, stream, chat, message, or ban cannot be located, which often signals an incorrect or deleted resource.\u003c/p\u003e\n"]]],["The document details error scenarios within the YouTube Live API, categorized by function. `fanFundingEvents.list` can fail due to insufficient permissions or disabled Fan Funding. Live broadcast actions (`bind`, `delete`, `insert`, `list`, `transition`, `update`) often fail from user permission issues, missing parameters, invalid values, or exceeding limits. Live chat interactions (`bans`, `messages`) face issues with permissions, invalid IDs, missing data, and rate limits. `liveCuepoints` and `liveStreams` can encounter similar errors, including issues with missing data, incorrect configuration, or forbidden actions. `sponsors.list` can be blocked due to permissions or disabled sponsorship.\n"],null,[]]