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 屬性指定的值無效。這個值必須是代表紀元時間戳記的整數。
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 其中之一。

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 只能指定 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 屬性值最多可包含 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 頻道未啟用贊助功能。