YouTube Live Streaming API - Errors

本文件會說明 YouTube Live Streaming API 作業可傳回的各種錯誤類型。您也可以在該方法的參考說明文件中找到個別方法的錯誤清單。

fanFundingEvents

下表說明 API 在回應 fanFundingEvents 資源相關呼叫時傳回的錯誤訊息。

fanFundingEvents.list

錯誤類型 錯誤詳細資料 說明
forbidden (403) insufficientPermissions 您的權限不足,無法查看這個頻道的支持者贊助活動。
invalidValue (400) fanFundingNotEnabledForChannelId 頻道未啟用粉絲贊助功能。

現場直播

下表說明 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 liveBroadcast 資源中指定的 id 屬性沒有識別廣播。

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 屬性的有效值。屬性值最多可包含 5000 個字元。
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 只有在廣播處於 createdready 狀態時,才能修改 contentDetails.closedCaptionsType 值。
forbidden (403) enableAutoStartModificationNotAllowed 只有在串流無效且廣播處於 createdready 狀態時,才能修改 contentDetails.enableAutoStart 值。
forbidden (403) enableClosedCaptionsModificationNotAllowed 只有在廣播狀態為 createdready 時,才能修改 contentDetails.enableClosedCaptions 值。
forbidden (403) enableDvrModificationNotAllowed 只有在播送狀態為 createdready 時,才能修改 contentDetails.enableDvr 值。
forbidden (403) enableMonitorStreamModificationNotAllowed 只有在播送狀態為 createdready 時,才能修改 contentDetails.monitorStream.enableMonitorStream 值。
forbidden (403) recordFromStartModificationNotAllowed 只有在播送狀態為 createdready 時,才能修改 contentDetails.recordFromStart 值。
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 最多可包含 5000 個字元。
invalidValue (400) invalidEmbedSetting liveBroadcast 資源包含無效的 contentDetails.enable_embed 屬性值。您無法嵌入這個廣播。
invalidValue (400) invalidEnableClosedCaptions liveBroadcast 資源中,contentDetails.enableClosedCaptions 屬性的值與 contentDetails.closedCaptionType 設定的值不相容。修改資源,只加入這兩個屬性之一,然後重新提交要求。
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 liveBroadcast 資源中指定的 id 屬性沒有識別廣播。
required (400) broadcastStreamDelayMsRequired liveBroadcast 資源未指定 contentDetails.monitorStream.broadcastStreamDelayMs 屬性。
required (400) enableMonitorStreamRequired liveBroadcast 資源未指定 contentDetails.monitorStream.enableMonitorStream 屬性。
required (400) idRequired liveBroadcast 資源必須加入並指定 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/2474026https://www.youtube.com/features 瞭解詳情。
rateLimitExceeded (403) userRequestsExceedRateLimit 使用者在指定時間範圍內傳送太多要求。
required (400) idRequired 必要的 id 參數必須識別您想要插入提示點的廣播。
required (400) cueTypeRequired 您必須在 API 要求主體中指定必要的 cueType 欄位。
notFound (404) liveBroadcastNotFound id 參數指定的廣播不存在。
invalidValue (400) conflictingTimeFields 您只能指定 insertionOffsetTimeMswalltimeMs 其中之一。設定這兩個值會造成錯誤。如未設定任何值,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 找不到指定的頻道 ID。
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 屬性的值。

liveChatMessage

下表說明 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 您只能指定 offsetTimeMswalltime 其中之一。

即時串流

下表說明 API 在回應 liveStreams 資源相關呼叫時傳回的錯誤訊息。

liveStreams.delete

錯誤類型 錯誤詳細資料 說明
forbidden (403) liveStreamDeletionNotAllowed 無法刪除指定的直播,因為該串流已繫結至尚未完成的廣播。
insufficientPermissions insufficientLivePermissions 要求無權刪除指定的直播活動。詳情請參閱實作 OAuth2 驗證
insufficientPermissions liveStreamingNotEnabled 授權要求的使用者未啟用 YouTube 的即時串流影片。使用者可以前往 https://www.youtube.com/features 瞭解詳情。
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 liveStream 資源中的 snippet.description 屬性值最多可包含 10,000 個字元。
invalidValue (400) invalidFormat liveStream」資源中的「cdn.format」屬性值無效。
invalidValue (400) invalidFrameRate liveStream」資源中的「cdn.frameRate」屬性值無效。
invalidValue (400) invalidIngestionType liveStream」資源中的「cdn.ingestionType」屬性值無效。
invalidValue (400) invalidResolution liveStream」資源中的「cdn.resolution」屬性值無效。
invalidValue (400) invalidTitle liveStream 資源中的 snippet.title 屬性值長度必須介於 1 到 128 個字元之間。
rateLimitExceeded userRequestsExceedRateLimit 使用者在指定時間範圍內傳送太多要求。
required (400) cdnRequired liveStream 資源必須包含 cdn 物件。
required (400) frameRateRequired 如果您指定了 cdn.resolution 屬性的值,但不是 cdn.frameRate 屬性的值,API 會傳回這個錯誤。
required (400) ingestionTypeRequired liveStream 資源必須指定 cdn.ingestionType 屬性的值。
required (400) resolutionRequired 如果您指定了 cdn.frameRate 屬性的值,但不是 cdn.resolution 屬性的值,API 會傳回這個錯誤。
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.formatcdn.frameRatecdn.ingestionTypecdn.resolution 欄位值。
forbidden (403) liveStreamModificationNotAllowed API 不允許將可重複使用的串流變更為不可重複使用,反之亦然。詳情請參閱瞭解廣播和訊息串一文。
insufficientPermissions insufficientLivePermissions 要求無權更新指定的直播活動。詳情請參閱實作 OAuth2 驗證
insufficientPermissions liveStreamingNotEnabled 授權要求的使用者未啟用 YouTube 的即時串流影片。使用者可以前往 https://www.youtube.com/features 瞭解詳情。
invalidValue (400) invalidDescription liveStream 資源中的 snippet.description 屬性值最多可包含 10,000 個字元。
invalidValue (400) invalidTitle liveStream 資源中的 snippet.title 屬性值必須介於 1 到 128 個字元之間。
notFound (404) liveStreamNotFound 指定的直播活動不存在。
required (400) idRequired liveStream 資源必須指定 id 屬性的值。
required (400) ingestionTypeRequired liveStream 資源必須指定 cdn.ingestionType 屬性的值。
required (400) titleRequired liveStream 資源必須指定 snippet.title 屬性的值。

贊助者

下表說明 API 在回應 sponsors 資源相關呼叫時傳回的錯誤訊息。

sponsors.list

錯誤類型 錯誤詳細資料 說明
forbidden (403) insufficientPermissions 您的權限不足,無法查看頻道的贊助商。
invalidValue (400) invalidValueInRequest 要求含有無效值。
invalidValue (400) sponsorshipNotEnabledForChannelId 頻道未啟用贊助功能。