本文件說明 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 |
只有在廣播狀態為 created 或 ready 時,才能修改 contentDetails.closedCaptionsType 值。 |
forbidden (403) |
enableAutoStartModificationNotAllowed |
只有在串流已停用且廣播處於 created 或 ready 狀態時,才能修改 contentDetails.enableAutoStart 值。 |
forbidden (403) |
enableClosedCaptionsModificationNotAllowed |
只有在廣播狀態為 created 或 ready 時,才能修改 contentDetails.enableClosedCaptions 值。 |
forbidden (403) |
enableDvrModificationNotAllowed |
只有在廣播狀態為 created 或 ready 時,才能修改 contentDetails. 值。 |
forbidden (403) |
enableMonitorStreamModificationNotAllowed |
只有在廣播狀態為 created 或 ready 時,才能修改 contentDetails. 值。 |
forbidden (403) |
recordFromStartModificationNotAllowed |
只有在廣播狀態為 created 或 ready 時,才能修改 contentDetails. 值。 |
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. 屬性。 |
required (400) |
enableMonitorStreamRequired |
liveBroadcast 資源並未指定 contentDetails. 屬性。 |
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 的重新整理頻率,導致系統消耗不必要的頻寬時,就會發生這項錯誤。 |
liveCuepoints
下表列出 API 在回應 liveCuepoints
資源相關呼叫時傳回的錯誤訊息。
liveCuepoints.insert
錯誤類型 | 錯誤詳情 | 說明 |
---|---|---|
invalidValue (400) |
conflictingTimeFields |
只能指定 offsetTimeMs 和 walltime 其中之一。 |
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 屬性的值。 |
贊助者
下表列出 API 在回應 sponsors
資源相關呼叫時傳回的錯誤訊息。
sponsors.list
錯誤類型 | 錯誤詳情 | 說明 |
---|---|---|
forbidden (403) |
insufficientPermissions |
權限不足,無法查看這個頻道的贊助者。 |
invalidValue (400) |
invalidValueInRequest |
要求含有無效值。 |
invalidValue (400) |
sponsorshipNotEnabledForChannelId |
這個頻道未啟用贊助功能。 |