YouTube Live Streaming API - Errors

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

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 使用者在指定時間範圍內傳送過多要求。
rateLimitExceeded (403) concurrentBroadcastsExceedLimit 頻道同時進行的現場直播數量已達上限。頻道必須先停止一或多個直播，才能開始其他直播。
rateLimitExceeded (403) sharedIngestionBroadcastsExceedLimit 頻道中，共用攝入來源的現場直播數量已達上限。如要開始播放要求的內容，必須先停止一或多個廣播。
required (400) idRequired 必要 id 參數必須識別要轉換狀態的廣播。
required (400) statusRequired API 要求必須為 status 參數指定值。

liveBroadcasts.update

錯誤類型 錯誤詳細資料 說明
backendError (503) backendError 部分設定目前無法套用。這可能是因為直播才剛建立。請稍後再試。
forbidden (403) closedCaptionsTypeModificationNotAllowed 只有在直播處於 created 或 ready 狀態時，才能修改 contentDetails.closedCaptionsType 值。
forbidden (403) enableAutoStartModificationNotAllowed 只有在直播未啟用，且直播處於 created 或 ready 狀態時，才能修改 contentDetails.enableAutoStart 值。
forbidden (403) enableClosedCaptionsModificationNotAllowed 只有在廣播狀態為 created 或 ready 時，才能修改 contentDetails.enableClosedCaptions 值。
forbidden (403) enableDvrModificationNotAllowed 只有在直播狀態為 created 或 ready 時，才能修改 contentDetails.enableDvr 值。
forbidden (403) enableMonitorStreamModificationNotAllowed 只有在直播狀態為 created 或 ready 時，才能修改 contentDetails.monitorStream.enableMonitorStream 值。
forbidden (403) recordFromStartModificationNotAllowed 只有在廣播狀態為 created 或 ready 時，才能修改 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最多可包含 5,000 個字元。
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 屬性未識別直播。
preconditionFailed (412) videoNotEligibleForAdsMonetization 影片不符合廣告營利資格。如果頻道不符合營利資格，就可能發生這種情況。
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/2474026 和 https://www.youtube.com/features。
rateLimitExceeded (403) userRequestsExceedRateLimit 使用者在指定時間範圍內傳送過多要求。
required (400) idRequired 必要 id 參數必須識別要插入提示點的廣播。
required (400) cueTypeRequired 必須在 API 要求主體中指定必要的 cueType 欄位。
notFound (404) liveBroadcastNotFound id 參數指定的廣播不存在。
invalidValue (400) conflictingTimeFields 只能指定 insertionOffsetTimeMs 和 walltimeMs 其中之一。如果同時設定這兩個值，會導致錯誤。如未設定任一值，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 的重新整理頻率，就會發生這項錯誤，不必要地浪費頻寬。

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 的重新整理頻率，就會發生這項錯誤，導致頻寬遭到不必要的浪費。

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.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 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 屬性的值。