本頁面由 Cloud Translation API 翻譯而成。

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`	使用者在特定時間範圍內傳送過多要求。
`required (400)`	`idRequired`	必要 `id` 參數必須識別要轉換狀態的廣播。
`required (400)`	`statusRequired`	API 要求必須為 `status` 參數指定值。

`liveBroadcasts.update`

錯誤類型	錯誤詳細資料	說明
`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` 最多可包含 5000 個字元。
`invalidValue (400)`	`invalidEmbedSetting`	liveBroadcast 資源的 `contentDetails.enable_embed` 屬性含有無效值。你無法嵌入這場廣播。
`invalidValue (400)`	`invalidEnableClosedCaptions`	在直播資源中，「`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/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` 屬性指定的值無效。這個值必須是代表紀元時間戳記的整數。
`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` 屬性值最多可有 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.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` 屬性值最多可有 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` 屬性指定值。

YouTube Live Streaming API - Errors 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

liveBroadcasts

liveBroadcasts.bind

liveBroadcasts.delete

liveBroadcasts.insert

liveBroadcasts.list

liveBroadcasts.transition

liveBroadcasts.update

liveBroadcasts.cuepoint

liveChatBans

liveChatBans.delete

liveChatBans.insert