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 |
只有在廣播處於 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 |
在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/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 的重新整理率,就會發生這項錯誤,因為這樣會不必要地浪費頻寬。 |
liveCuepoints
下表列出 API 在回應與 liveCuepoints
資源相關的呼叫時,可能會傳回的錯誤訊息。
liveCuepoints.insert
錯誤類型 |
錯誤詳細資料 |
說明 |
invalidValue (400) |
conflictingTimeFields |
只能指定 offsetTimeMs 或 walltime 其中之一。 |
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 |
只能指定 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 屬性值最多可包含 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 屬性指定值。 |
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-27 (世界標準時間)。
[null,null,["上次更新時間:2025-07-27 (世界標準時間)。"],[[["\u003cp\u003eThe API returns \u003ccode\u003eforbidden (403)\u003c/code\u003e or \u003ccode\u003einsufficientPermissions\u003c/code\u003e errors when a user lacks the necessary authorization to perform an action, such as creating, deleting, or viewing resources.\u003c/p\u003e\n"],["\u003cp\u003eSeveral API calls related to live broadcasts, streams, and cuepoints may return a \u003ccode\u003eliveStreamingNotEnabled\u003c/code\u003e error, which means that the user has not enabled live streaming for their channel.\u003c/p\u003e\n"],["\u003cp\u003eMany errors across different API resources are caused by \u003ccode\u003einvalidValue (400)\u003c/code\u003e issues, including invalid descriptions, titles, privacy status, or time-related fields, which indicate that the provided data does not meet the required criteria.\u003c/p\u003e\n"],["\u003cp\u003eRequests can fail with a \u003ccode\u003erateLimitExceeded\u003c/code\u003e error if a user surpasses the allowed request rate, which could happen in multiple \u003ccode\u003eliveBroadcasts\u003c/code\u003e, \u003ccode\u003eliveChatMessages\u003c/code\u003e, or \u003ccode\u003eliveStreams\u003c/code\u003e operations.\u003c/p\u003e\n"],["\u003cp\u003eMany errors indicate a \u003ccode\u003enotFound (404)\u003c/code\u003e issue, indicating that a broadcast, stream, chat, message, or ban cannot be located, which often signals an incorrect or deleted resource.\u003c/p\u003e\n"]]],["The document details error scenarios within the YouTube Live API, categorized by function. `fanFundingEvents.list` can fail due to insufficient permissions or disabled Fan Funding. Live broadcast actions (`bind`, `delete`, `insert`, `list`, `transition`, `update`) often fail from user permission issues, missing parameters, invalid values, or exceeding limits. Live chat interactions (`bans`, `messages`) face issues with permissions, invalid IDs, missing data, and rate limits. `liveCuepoints` and `liveStreams` can encounter similar errors, including issues with missing data, incorrect configuration, or forbidden actions. `sponsors.list` can be blocked due to permissions or disabled sponsorship.\n"],null,[]]