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 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 屬性指定有效值。屬性值最多可包含 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 只有在廣播狀態為 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 屬性的值。

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 只能指定 offsetTimeMswalltime 其中之一。

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 liveStream 資源中的 snippet.description 屬性值不得超過 10000 個字元。
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 屬性值最多可以有 10000 個字元。
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 這個頻道未啟用贊助功能。