Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

YouTube Data API - Errors

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

一般錯誤

下表列出不屬於特定 API 方法的 API 錯誤訊息。

`Core API errors`

錯誤類型	錯誤詳情	說明
`forbidden (403)`	`forbidden`	禁止存取。要求可能未獲得適當授權。
`quotaExceeded (403)`	`quotaExceeded`	您已超出配額，因此無法完成要求。

`Common request errors`

錯誤類型	錯誤詳情	說明
`badRequest (400)`	`incompatibleParameters`	要求指定了兩個以上無法在同一要求中使用的參數。
`badRequest (400)`	`invalidFilters`	要求指定了無效的篩選器參數。
`badRequest (400)`	`invalidPageToken`	要求指定的頁面權杖無效。
`badRequest (400)`	`missingRequiredParameter`	要求缺少必要參數。
`badRequest (400)`	`unexpectedParameter`	要求指定了非預期的參數。
`forbidden (403)`	`accountDelegationForbidden`	經過驗證的使用者無法代表指定的 Google 帳戶採取行動。
`forbidden (403)`	`authenticatedUserAccountClosed`	已驗證使用者的 YouTube 帳戶已關閉。如果通過驗證的使用者代表另一個 Google 帳戶，則這項錯誤是指後者。
`forbidden (403)`	`authenticatedUserAccountSuspended`	已驗證使用者的 YouTube 帳戶遭到停權。如果已驗證的使用者是代表其他 Google 帳戶行事，這項錯誤是指後者。
`forbidden (403)`	`authenticatedUserNotChannel`	這項要求必須將已驗證使用者解析為頻道，但事實並非如此。如果要求已通過驗證，且使用 `onBehalfOfContentOwner` 委派參數，則應一併設定 `onBehalfOfContentOwnerChannel` 參數。
`forbidden (403)`	`channelClosed`	要求中識別的管道已關閉。
`forbidden (403)`	`channelNotFound`	找不到要求中指定的頻道。
`forbidden (403)`	`channelSuspended`	要求中指定的頻道已遭停權。
`forbidden (403)`	`cmsUserAccountNotFound`	CMS 使用者不得代表指定的內容擁有者採取行動。
`forbidden (403)`	`insufficientCapabilities`	CMS 使用者權限不足。
`forbidden (403)`	`insufficientPermissions`	要求提供的 OAuth 2.0 權杖指定的範圍不足，無法存取要求的資料。
`notFound (404)`	`contentOwnerAccountNotFound`	找不到指定的內容擁有者帳戶。

`Request context errors`

錯誤類型	錯誤詳情	說明
`badRequest (400)`	`invalidLanguage`	`hl` 參數值未指定有效的語言代碼。
`badRequest (400)`	`invalidMine`	要求不支援使用 `mine` 參數。
`badRequest (400)`	`invalidMine`	如果通過驗證的使用者是 YouTube 合作夥伴，則無法在要求中使用 `mine` 參數。請移除 `mine` 參數，並移除 `onBehalfOfContentOwner` 參數以 YouTube 使用者身分進行驗證，或提供 `onBehalfOfContentOwnerChannel` 參數 (如果呼叫的方法支援)，以合作夥伴的其中一個頻道身分執行操作。
`badRequest (400)`	`invalidPart`	要求的 `part` 參數指定了無法同時寫入的部分。
`badRequest (400)`	`invalidRegionCode`	`regionCode` 參數指定的區碼無效。
`badRequest (400)`	`unexpectedPart`	要求的 `part` 參數指定了非預期的值。
`badRequest (400)`	`unknownPart`	要求的 `part` 參數指定了不明的值。
`badRequest (400)`	`unsupportedLanguageCode`	`hl` 參數值未指定支援的語言代碼。
`badRequest (400)`	`unsupportedRegionCode`	`regionCode` 參數指定了不支援的區碼。
`unauthorized (401)`	`authorizationRequired`	要求使用 `mine` 參數，但未獲得適當授權。
`unauthorized (401)`	`youtubeSignupRequired`	這項錯誤表示使用者擁有未連結的 Google 帳戶，也就是說，使用者有 Google 帳戶，但沒有 YouTube 頻道。這類使用者可以存取許多需要使用者授權的功能，例如為影片評分或將影片加入`watch_later`播放清單。舉例來說，使用者必須擁有 YouTube 頻道，才能上傳影片。擁有 Gmail 帳戶或 Android 裝置的使用者一定有 Google 帳戶，但可能尚未將該 Google 帳戶連結至 YouTube 頻道。如果您嘗試使用 OAuth 2.0 服務帳戶流程，通常會看到這個錯誤。YouTube 不支援服務帳戶，如果您嘗試使用服務帳戶進行驗證，就會收到這項錯誤。 YouTube API 網誌文章介紹了 Google 帳戶支援功能，也更詳細地討論了 `youtubeSignupRequired` 錯誤。雖然該網誌文章說明的是 API 2.1 版的錯誤，但錯誤的意義仍適用。

活動

下表列出 API 針對 activities 資源相關呼叫傳回的錯誤訊息。這些方法也可能傳回「常見要求錯誤」一節中列出的錯誤。

`activities.list`

錯誤類型	錯誤詳情	說明
`forbidden (403)`	`homeParameterDeprecated`	使用者首頁活動資料無法透過這個 API 取得。如果在未經授權的要求中，將 `home` 參數設為 `true`，就可能發生這項錯誤。
`forbidden (403)`	`forbidden`	要求未獲得適當授權。
`notFound (404)`	`channelNotFound`	找不到要求 `channelId` 參數指定的頻道 ID。
`notFound (404)`	`homeChannelNotFound`	找不到目前已驗證使用者的 YouTube 首頁動態消息。
`unauthorized (401)`	`authorizationRequired`	要求使用 `home` 參數，但未獲得適當授權。

字幕

下表列出 API 針對 captions 資源相關呼叫傳回的錯誤訊息。這些方法也可能傳回「常見要求錯誤」一節中列出的錯誤。

`captions.delete`

錯誤類型	錯誤詳情	說明
`forbidden (403)`	`forbidden`	與要求相關聯的權限不足，無法刪除字幕軌。要求可能未獲得適當授權。
`notFound (404)`	`captionNotFound`	找不到字幕軌。請檢查要求 `id` 參數的值，確保正確無誤。

`captions.download`

錯誤類型	錯誤詳情	說明
`forbidden (403)`	`forbidden`	與要求相關聯的權限不足，無法下載字幕軌。要求可能未獲得適當授權。
`invalidValue (400)`	`couldNotConvert`	字幕軌資料無法轉換為要求的語言和/或格式。請確認要求的 `tfmt` 和 `tlang` 值有效，且所要求字幕軌的 `snippet.status` 不是 `failed`。
`notFound (404)`	`captionNotFound`	找不到字幕軌。請檢查要求 `id` 參數的值，確保正確無誤。

`captions.insert`

錯誤類型	錯誤詳情	說明
`badRequest (400)`	`contentRequired`	要求不含字幕軌內容。
`conflict (409)`	`captionExists`	指定影片已有字幕軌，且 `snippet.language` 和 `snippet.name` 與提供的值相同。一部影片可以有多個相同語言的音軌，但每個音軌必須有不同的名稱。有多種方法可以解決這項錯誤。您可以刪除現有曲目，然後插入新曲目，或是在插入新曲目前變更其名稱。
`forbidden (403)`	`forbidden`	與要求相關聯的權限不足，無法上傳字幕軌。要求可能未獲得適當授權。
`invalidValue (400)`	`invalidMetadata`	要求含有無效的中繼資料值，因此無法建立曲目。確認要求為 `snippet.language`、`snippet.name` 和 `snippet.videoId` 屬性指定有效值。您也可以加入 `snippet.isDraft` 屬性，但這並非必要。
`notFound (404)`	`videoNotFound`	找不到 `videoId` 參數指定的影片。
`invalidValue (400)`	`nameTooLong`	要求中指定的 `snippet.name` 過長。支援的長度上限為 150 個半形字元。

`captions.list`

錯誤類型	錯誤詳情	說明
`forbidden (403)`	`forbidden`	由於與要求相關聯的權限不足，無法擷取要求的資源，因此無法擷取一或多個字幕軌。要求可能未獲得適當授權。
`notFound (404)`	`captionNotFound`	找不到一或多個指定的字幕軌。如果 `videoId` 參數識別出實際影片，但 `id` 參數識別出不存在的字幕軌 ID，或是與其他影片相關聯的軌 ID，就會發生這項錯誤。請檢查要求 `id` 和 `videoId` 參數的值，確保正確無誤。
`notFound (404)`	`videoNotFound`	找不到 `videoId` 參數所指的影片。

`captions.update`

錯誤類型	錯誤詳情	說明
`badRequest (400)`	`contentRequired`	要求未上傳更新的字幕檔案。如果 `sync` 參數設為 `true`，就必須提供實際曲目內容。
`forbidden (403)`	`forbidden`	與要求相關聯的權限不足，無法更新字幕軌。要求可能未獲得適當授權。
`notFound (404)`	`captionNotFound`	找不到指定的字幕軌。檢查要求中 `id` 參數的值，確認是否正確。

channelBanners

下表列出 API 在回應與 channelBanners 資源相關的呼叫時傳回的錯誤訊息。這些方法也可能會傳回「常見要求錯誤」一節中列出的錯誤。

`channelBanners.insert`

錯誤類型	錯誤詳情	說明
`badRequest (400)`	`bannerAlbumFull`	YouTube 頻道圖片相簿中的圖片過多。請前往 http://photos.google.com，然後前往相簿頁面，從該相簿中移除部分圖片。
`badRequest (400)`	`mediaBodyRequired`	要求不含圖片內容。

channelSections

下表列出 API 在回應與 channelSections 資源相關的呼叫時傳回的錯誤訊息。這些方法也可能會傳回「常見要求錯誤」一節中列出的錯誤。

`channelSections.delete`

錯誤類型	錯誤詳情	說明
`badRequest (400)`	`notEditable`	無法刪除這個頻道專區。
`forbidden (403)`	`channelSectionForbidden`	要求未正確驗證，或這個管道不支援。
`invalidValue (400)`	`idInvalid`	`id` 屬性指定的頻道版面 ID 無效。
`invalidValue (400)`	`idRequired`	`id` 屬性必須指定值，用來識別要刪除的頻道區段。
`notFound (404)`	`channelNotFound`	找不到頻道。
`notFound (404)`	`channelSectionNotFound`	找不到您要更新的頻道專區。

`channelSections.insert`

錯誤類型	錯誤詳情	說明
`badRequest (400)`	`defaultLanguageNotSetError`	必須設定 `channelSection` 資源的 `snippet.defaultLanguage` 屬性，才能成功插入或更新該資源的 `localizations` 物件。
`badRequest (400)`	`invalidLanguage`	`localizations` 物件的其中一個語言鍵未通過驗證。使用 channelSections.list 方法擷取有效值，並按照 `channelSections` 資源說明文件中的指南更新值。
`badRequest (400)`	`notEditable`	無法建立這個頻道專區。
`badRequest (400)`	`styleRequired`	`channelSection` 資源必須為 `snippet.style` 欄位指定值。
`badRequest (400)`	`targetInvalidCountry`	`targeting.countries` 清單中的某個值未通過驗證。請使用 channelSections.list 方法擷取有效值，並按照 `channelSections` 資源說明文件中的指南更新。
`badRequest (400)`	`targetInvalidLanguage`	`targeting.languages` 清單中的某個值未通過驗證。使用 channelSections.list 方法擷取有效值，並按照 `channelSections` 資源說明文件中的指南更新值。
`badRequest (400)`	`targetInvalidRegion`	`targeting.regions` 清單中的某個值未通過驗證。使用 channelSections.list 方法擷取有效值，並按照 `channelSections` 資源說明文件中的指南更新這些值。
`badRequest (400)`	`typeRequired`	`channelSection` 資源必須為 `snippet.type` 欄位指定值。
`forbidden (403)`	`channelSectionForbidden`	要求未正確驗證，或這個管道不支援。
`invalidValue (400)`	`channelNotActive`	至少有一個指定管道未啟用。
`invalidValue (400)`	`channelsDuplicated`	要求失敗，因為指定了重複的管道。
`invalidValue (400)`	`channelsNeeded`	如果 `snippet.type` 屬性的值為 `multipleChannels`，則必須指定 `contentDetails.channels[]` 屬性，且至少要指定一個管道。
`invalidValue (400)`	`channelsNotExpected`	要求提供的資源指定了 `contentDetails.channels[]` 屬性的值，但這類頻道專區不應包含頻道。
`invalidValue (400)`	`contentDetailsNeeded`	您插入的資源必須包含這類頻道版面的 `contentDetails` 物件。
`invalidValue (400)`	`inValidPosition`	`snippet.position` 屬性包含無效值。
`invalidValue (400)`	`maxChannelSectionExceeded`	頻道版面數量已達上限，因此無法完成要求。
`invalidValue (400)`	`maxChannelsExceeded`	要求失敗，因為頻道版面中包含過多頻道。
`invalidValue (400)`	`maxPlaylistExceeded`	要求失敗，因為頻道版面中包含過多播放清單。
`invalidValue (400)`	`onePlaylistNeeded`	如果 `snippet.type` 屬性的值為 `singlePlaylist`，則 `contentDetails.playlists[]` 屬性必須指定一個播放清單。
`invalidValue (400)`	`ownChannelInChannels`	你無法在頻道專區中加入自己的頻道。
`invalidValue (400)`	`playlistIsPrivate`	指定的一或多個播放清單為私人播放清單，因此無法納入頻道專區。
`invalidValue (400)`	`playlistsDuplicated`	要求指定了重複的播放清單，因此失敗。
`invalidValue (400)`	`playlistsNeeded`	如果 `snippet.type` 屬性的值為 `singlePlaylist` 或 `multiplePlaylists`，則必須指定 `contentDetails.playlists[]` 屬性。
`invalidValue (400)`	`playlistsNotExpected`	要求提供的資源指定了 `contentDetails.playlists[]` 屬性的值，但這類頻道版面不應包含播放清單。
`invalidValue (400)`	`snippetNeeded`	您必須指定 `snippet`，才能建立頻道版面。
`invalidValue (400)`	`titleLengthExceeded`	`snippet.title` 屬性的值過長。
`invalidValue (400)`	`titleRequired`	如果 `snippet.type` 屬性的值為 `multiplePlaylists` 或 `multipleChannels`，則必須為 `snippet.title` 屬性指定值，藉此設定區段標題。
`notFound (404)`	`channelNotFound`	找不到一或多個指定管道。
`notFound (404)`	`playlistNotFound`	找不到一或多個指定的播放清單。

`channelSections.list`

錯誤類型	錯誤詳情	說明
`forbidden (403)`	`channelSectionForbidden`	要求者無權存取要求的頻道版面。
`invalidValue (400)`	`idInvalid`	要求指定的頻道版面 ID 無效。
`invalidValue (400)`	`invalidCriteria`	篩選條件無效，因此無法完成要求。
`notFound (404)`	`channelNotFound`	找不到與要求相關聯的頻道。
`notFound (404)`	`channelSectionNotFound`	找不到與要求相關聯的頻道版面。

`channelSections.update`

錯誤類型	錯誤詳情	說明
`badRequest (400)`	`defaultLanguageNotSetError`	必須設定 `channelSection` 資源的 `snippet.defaultLanguage` 屬性，才能成功插入或更新該資源的 `localizations` 物件。
`badRequest (400)`	`invalidLanguage`	`localizations` 物件的其中一個語言鍵未通過驗證。請使用 channelSections.list 方法擷取有效值，並按照 `channelSections` 資源說明文件中的指南更新。
`badRequest (400)`	`notEditable`	無法編輯這個頻道專區。
`badRequest (400)`	`styleRequired`	`channelSection` 資源必須為 `snippet.style` 欄位指定值。
`badRequest (400)`	`targetInvalidCountry`	`targeting.countries` 清單中的某個值未通過驗證。使用 channelSections.list 方法擷取有效值，並按照 `channelSections` 資源說明文件中的指南更新值。
`badRequest (400)`	`targetInvalidLanguage`	`targeting.languages` 清單中的其中一個值未通過驗證。使用 channelSections.list 方法擷取有效值，並按照 `channelSections` 資源說明文件中的指南更新這些值。
`badRequest (400)`	`targetInvalidRegion`	`targeting.regions` 清單中的某個值未通過驗證。請使用 channelSections.list 方法擷取有效值，並按照 `channelSections` 資源說明文件中的指南更新。
`badRequest (400)`	`typeRequired`	`channelSection` 資源必須為 `snippet.type` 欄位指定值。
`forbidden (403)`	`channelSectionForbidden`	要求未正確驗證，或這個管道不支援。
`invalidValue (400)`	`channelNotActive`	至少有一個指定管道未啟用。
`invalidValue (400)`	`channelsDuplicated`	要求失敗，因為指定了重複的管道。
`invalidValue (400)`	`channelsNeeded`	如果 `snippet.type` 屬性的值為 `multipleChannels`，則必須指定 `contentDetails.channels[]` 屬性，且至少要指定一個管道。
`invalidValue (400)`	`channelsNotExpected`	要求提供的資源為 `contentDetails.channels[]` 屬性指定了值，但這類頻道區段不應有頻道。
`invalidValue (400)`	`contentDetailsNeeded`	您更新的資源必須包含這類頻道版面的 `contentDetails` 物件。
`invalidValue (400)`	`idInvalid`	`id` 屬性指定了無效的頻道區段 ID。
`invalidValue (400)`	`idRequired`	`id` 屬性必須指定可識別要更新的頻道區段的值。
`invalidValue (400)`	`inValidPosition`	`snippet.position` 屬性包含無效值。
`invalidValue (400)`	`maxChannelsExceeded`	要求失敗，因為頻道版面中包含過多頻道。
`invalidValue (400)`	`maxPlaylistExceeded`	要求失敗，因為頻道版面中包含過多播放清單。
`invalidValue (400)`	`onePlaylistNeeded`	如果 `snippet.type` 屬性的值為 `singlePlaylist`，則 `contentDetails.playlists[]` 屬性必須指定一個播放清單。
`invalidValue (400)`	`ownChannelInChannels`	你無法在頻道專區中加入自己的頻道。
`invalidValue (400)`	`playlistIsPrivate`	指定的一或多個播放清單為私人播放清單，因此無法納入頻道專區。
`invalidValue (400)`	`playlistsDuplicated`	要求指定了重複的播放清單，因此失敗。
`invalidValue (400)`	`playlistsNeeded`	如果 `snippet.type` 屬性的值為 `singlePlaylist` 或 `multiplePlaylists`，則必須指定 `contentDetails.playlists[]` 屬性。
`invalidValue (400)`	`playlistsNotExpected`	要求提供的資源指定了 `contentDetails.playlists[]` 屬性的值，但這類頻道版面不應包含播放清單。
`invalidValue (400)`	`snippetNeeded`	必須指定 `snippet`，才能更新頻道版面。
`invalidValue (400)`	`titleLengthExceeded`	`snippet.title` 屬性的值過長。
`invalidValue (400)`	`titleRequired`	如果 `snippet.type` 屬性的值為 `multiplePlaylists` 或 `multipleChannels`，則必須為 `snippet.title` 屬性指定值，藉此設定區段標題。
`notFound (404)`	`channelNotFound`	找不到一或多個指定管道。
`notFound (404)`	`channelSectionNotFound`	找不到你要更新的頻道版面。
`notFound (404)`	`playlistNotFound`	找不到一或多個指定的播放清單。

頻道

下表列出 API 針對 channels 資源相關呼叫傳回的錯誤訊息。這些方法也可能傳回「常見要求錯誤」一節中列出的錯誤。

`channels.list`

錯誤類型	錯誤詳情	說明
`badRequest (400)`	`invalidCriteria`	最多可指定下列其中一個篩選器：`id`、`mySubscribers`、`categoryId`、`mine`、`managedByMe`、`forUsername`。如果使用 `onBehalfOfContentOwner` 參數驗證內容擁有者，則只能指定 `id` 或 `managedByMe`。
`forbidden (403)`	`channelForbidden`	`id` 參數指定的管道不支援要求，或要求未獲得適當授權。
`notFound (404)`	`categoryNotFound`	找不到 `categoryId` 參數識別的類別。
`notFound (404)`	`channelNotFound`	找不到 `id` 參數中指定的頻道。

`channels.update`

錯誤類型	錯誤詳情	說明
`badRequest (400)`	`brandingValidationError`	`brandingSettings` 物件中的其中一個值未通過驗證。使用 `channels.list` 方法擷取頻道的現有設定，然後按照 `channels` 資源說明文件中的指南更新屬性值。
`badRequest (400)`	`channelTitleUpdateForbidden`	更新頻道的 `brandingSettings part` 時，必須將 `brandingSettings.channel.title` 屬性的值設為頻道的目前名稱，或省略該屬性。如果變更屬性值，API 會傳回錯誤。
`badRequest (400)`	`defaultLanguageNotSetError`	`defaultLanguage` 必須設為更新 `localizations`。
`badRequest (400)`	`invalidBrandingOption`	您指定的其中一項品牌設定不存在。請使用 `channels.list` 方法擷取有效值，並務必按照 `channels` 資源說明文件中的規範更新。
`badRequest (400)`	`invalidCustomMessage`	要求中繼資料指定了無效的自訂訊息。檢查要求傳送的資源中 `invideoPromotion.items[].customMessage` 屬性的值。
`badRequest (400)`	`invalidDuration`	要求中繼資料在 invideoPromotion 部分指定了無效的時間長度。
`badRequest (400)`	`invalidDuration`	要求中繼資料指定的位置類型無效，無法判斷宣傳項目在影片播放器中的位置。請檢查要求傳送的資源中 `invideoPromotion.position.type` 屬性的值。
`badRequest (400)`	`invalidRecentlyUploadedBy`	要求中繼資料指定的頻道 ID 無效。檢查要求傳送的資源中 `invideoPromotion.items[].id.recentlyUploadedBy` 屬性的值。
`badRequest (400)`	`invalidTimingOffset`	要求中繼資料在 invideoPromotion 部分指定了無效的時間偏移。
`badRequest (400)`	`invalidTimingOffset`	請求中繼資料指定了無效的時間偏移，無法判斷宣傳項目應在影片播放器中顯示的時間。請檢查要求傳送的資源中 `invideoPromotion.timing.offsetMs` 屬性的值。
`badRequest (400)`	`invalidTimingType`	要求中繼資料指定了無效的時間設定方法，無法判斷宣傳項目應在影片播放器中顯示的時間。請檢查要求傳送的資源中 `invideoPromotion.timing.type` 屬性的值。
`badRequest (400)`	`localizationValidationError`	本地化物件中的其中一個值未通過驗證。請使用 channels.list 方法擷取有效值，並務必按照頻道資源說明文件中的規範更新。
`badRequest (400)`	`tooManyPromotedItems`	invideoPromotion 部分中的宣傳項目數量超過上限。
`forbidden (403)`	`channelForbidden`	`id` 參數中指定的管道不支援要求，或要求未獲得適當授權。
`forbidden (403)`	`promotedVideoNotAllowed`	找不到 API 要求嘗試更新的頻道。請檢查要求傳送至 `channel` 資源的 `id` 屬性值，確認頻道 ID 正確無誤。
`forbidden (403)`	`websiteLinkNotAllowed`	不允許使用指定的網站網址。
`notFound (404)`	`channelNotFound`	找不到 `id` 參數指定的頻道，或該頻道沒有品牌選項。
`notFound (404)`	`channelNotFound`	找不到 `id` 參數中指定的管道。
`notFound (404)`	`unknownChannelId`	找不到指定的頻道 ID。
`notFound (404)`	`unknownChannelId`	找不到指定的 recentlyUploadedBy 頻道 ID。
`notFound (404)`	`unknownVideoId`	找不到指定為宣傳項目的影片 ID。
`required (400)`	`requiredItemIdType`	要求中繼資料必須在 invideoPromotion 部分指定項目類型。
`required (400)`	`requiredItemId`	要求中繼資料必須在 invideoPromotion 部分指定項目。
`required (400)`	`requiredTimingOffset`	要求中繼資料必須指定預設時間偏移，YouTube 才能判斷何時顯示宣傳項目。在要求傳送的資源中，設定 `invideoPromotion.defaultTiming.offsetMs` 屬性的值。
`required (400)`	`requiredTimingOffset`	要求中繼資料必須指定時間偏移，YouTube 才能判斷何時顯示宣傳項目。在要求傳送的資源中，設定 `invideoPromotion.timing.offsetMs` 屬性的值。
`required (400)`	`requiredTimingType`	要求中繼資料必須指定時間設定方法，YouTube 才能判斷何時顯示宣傳項目。在要求傳送的資源中，設定 `invideoPromotion.defaultTiming.type` 屬性的值。
`required (400)`	`requiredTimingType`	要求中繼資料必須指定時間方法，YouTube 才能判斷何時顯示宣傳項目。在要求傳送的資源中，設定 `invideoPromotion.timing.type` 屬性的值。
`required (400)`	`requiredTiming`	要求中繼資料必須為 `invideoPromotion` 部分中的每個項目指定時間。
`required (400)`	`requiredVideoId`	要求中繼資料必須指定影片 ID，才能識別宣傳項目。
`required (400)`	`requiredWebsiteUrl`	要求中繼資料必須在 invideoPromotion 部分指定網站網址。在要求傳送的資源中，設定 `invideoPromotion.items[].id.websiteUrl` 屬性的值。

commentThreads

下表列出 API 針對 commentThreads 資源相關呼叫傳回的錯誤訊息。這些方法也可能傳回「常見要求錯誤」一節中列出的錯誤。

`commentThreads.list`

錯誤類型	錯誤詳情	說明
`badRequest (400)`	`operationNotSupported`	API 要求無效或格式不正確。因此 API 伺服器無法理解要求。
`badRequest (400)`	`processingFailure`	API 伺服器無法成功處理要求。雖然這可能是暫時性錯誤，但通常表示要求的輸入內容無效。請檢查要求主體中的 `commentThread` 資源結構，確保其有效。
`forbidden (403)`	`commentsDisabled`	`videoId` 參數所指的影片已停用留言功能。
`forbidden (403)`	`forbidden`	權限不足，無法擷取一或多個要求的留言串。要求可能未獲得適當授權。
`notFound (404)`	`channelNotFound`	找不到 `allThreadsRelatedToChannelId` 參數指定的頻道。
`notFound (404)`	`commentThreadNotFound`	找不到一或多個指定的留言串。檢查要求 `id` 參數的值，確保正確無誤。
`notFound (404)`	`videoNotFound`	找不到 `videoId` 參數指定的影片。

`commentThreads.insert`

錯誤類型	錯誤詳情	說明
`badRequest (400)`	`channelOrVideoIdMissing`	每個留言串都必須連結至頻道或影片。請確認資源為 `snippet.channelId` 和 `snippet.videoId` 屬性指定值。影片留言會顯示在影片觀賞頁面。
`badRequest (400)`	`commentTextRequired`	要插入的 `comment` 資源必須為 `snippet.topLevelComment.snippet.textOriginal` 屬性指定值。留言內容不得為空。
`badRequest (400)`	`commentTextTooLong`	要插入的 `comment` 資源中，`snippet.topLevelComment.snippet.textOriginal` 屬性包含過多字元。
`badRequest (400)`	`invalidCommentThreadMetadata`	要求中繼資料無效。
`badRequest (400)`	`processingFailure`	API 伺服器無法順利處理要求，雖然這可能是暫時性錯誤，但通常表示要求的輸入內容無效。檢查要求主體中的 `commentThread` 資源結構，確認結構有效。
`forbidden (403)`	`forbidden`	權限不足，無法建立註解討論串。要求可能未獲得適當授權。
`forbidden (403)`	`ineligibleAccount`	用來授權 API 要求的 YouTube 帳戶必須與使用者的 Google 帳戶合併，才能插入留言或留言串。
`notFound (404)`	`channelNotFound`	找不到指定的頻道。檢查 `snippet.channelId` 屬性的值，確認是否正確。
`notFound (404)`	`videoNotFound`	找不到指定的影片。請檢查 `snippet.videoId` 屬性的值，確保正確無誤。

comments

下表列出 API 在回應與 comments 資源相關的呼叫時傳回的錯誤訊息。這些方法也可能會傳回「常見要求錯誤」一節中列出的錯誤。

`comments.list`

錯誤類型	錯誤詳情	說明
`badRequest (400)`	`operationNotSupported`	API 要求無效或格式不正確。因此 API 伺服器無法解讀要求。
`forbidden (403)`	`forbidden`	權限不足，因此無法擷取一或多則要求提供的留言。要求可能未獲得適當授權。
`notFound (404)`	`commentNotFound`	找不到一或多則指定留言。檢查要求中 `id` 和 `parentId` 參數的值，確保正確無誤。

`comments.setModerationStatus`

錯誤類型	錯誤詳情	說明
`badRequest (400)`	`banWithoutReject`	只有在 `moderationStatus` 參數值為 `rejected` 時，才能使用 `banAuthor` 參數。
`badRequest (400)`	`operationNotSupported`	API 要求無效或格式不正確。因此 API 伺服器無法解讀要求。
`badRequest (400)`	`processingFailure`	API 伺服器無法順利處理要求，這可能是暫時性錯誤，但通常表示要求輸入內容無效。
`forbidden (403)`	`forbidden`	由於權限不足，無法設定一或多則留言的管理狀態。要求可能未獲得適當授權。
`notFound (404)`	`commentNotFound`	找不到要求嘗試更新的一或多則留言。檢查要求中 `id` 參數的值，確認是否正確。

`comments.insert`

錯誤類型	錯誤詳情	說明
`badRequest (400)`	`commentTextRequired`	插入的 `comment` 資源必須指定 `snippet.textOriginal` 屬性的值。必須輸入註解。
`badRequest (400)`	`commentTextTooLong`	要插入的 `comment` 資源的 `snippet.textOriginal` 屬性包含過多字元。
`badRequest (400)`	`invalidCommentMetadata`	要求中繼資料無效。
`badRequest (400)`	`operationNotSupported`	API 使用者無法插入留言，回覆 `snippet.parentId` 屬性識別的頂層留言。在 `commentThread` 資源中，`snippet.canReply` 屬性會指出目前檢視者是否可以回覆討論串。
`badRequest (400)`	`parentCommentIsPrivate`	指定的上層留言為私人留言。API 不支援回覆私人留言。
`badRequest (400)`	`parentIdMissing`	插入的留言必須連結至上層留言。不過，API 要求主體中的 `comment` 資源未指定 `snippet.parentId` 屬性的值。
`badRequest (400)`	`processingFailure`	API 伺服器無法成功處理要求。這可能是暫時性錯誤，但通常表示要求輸入內容無效。請檢查要求主體中的 `comment` 資源結構，確保其有效。
`forbidden (403)`	`forbidden`	權限不足，無法建立留言。要求可能未獲得適當授權。
`forbidden (403)`	`ineligibleAccount`	用來授權 API 要求的 YouTube 帳戶必須與使用者的 Google 帳戶合併，才能插入留言或留言串。
`notFound (404)`	`parentCommentNotFound`	找不到指定的上層留言。請檢查要求主體中的 `snippet.parentId` 屬性值，確認是否正確。

`comments.delete`

錯誤類型	錯誤詳情	說明
`badRequest (400)`	`processingFailure`	API 伺服器無法順利處理要求，這可能是暫時性錯誤，但通常表示要求輸入內容無效。
`forbidden (403)`	`forbidden`	權限不足，無法刪除留言。要求可能未獲得適當授權。
`notFound (404)`	`commentNotFound`	找不到指定的留言。請檢查要求 `id` 參數的值，確保正確無誤。

`comments.update`

錯誤類型	錯誤詳情	說明
`badRequest (400)`	`commentTextTooLong`	更新中的 `comment` 資源，其 `snippet.textOriginal` 屬性包含過多字元。
`badRequest (400)`	`invalidCommentMetadata`	要求中繼資料無效。
`badRequest (400)`	`operationNotSupported`	API 要求無效或格式不正確。因此 API 伺服器無法理解要求。
`badRequest (400)`	`processingFailure`	API 伺服器無法成功處理要求。雖然這可能是暫時性錯誤，但通常表示要求的輸入內容無效。請檢查要求主體中的 `comment` 資源結構，確保其有效。
`forbidden (403)`	`forbidden`	權限不足，無法更新留言。要求可能未獲得適當授權。
`forbidden (403)`	`ineligibleAccount`	用於授權 API 要求的 YouTube 帳戶必須與使用者的 Google 帳戶合併，才能更新留言或留言串。
`notFound (404)`	`commentNotFound`	找不到指定的註解。請檢查要求主體中的 `id` 屬性值，確認是否正確。

成員

下表列出 API 針對 members 資源相關呼叫傳回的錯誤訊息。這些方法也可能傳回「常見要求錯誤」一節中列出的錯誤。

`members.list`

錯誤類型	錯誤詳情	說明
`badRequest (400)`	`channelMembershipsNotEnabled`	授權要求的創作者頻道未啟用頻道會員功能。
`badRequest (400)`	`invalidMode`	`mode` 參數值無效。如果 `pageToken` 參數指定的權杖是使用與指定模式不同的模式擷取，就可能發生這項錯誤。
`badRequest (400)`	`invalidPageToken`	`pageToken` 參數值無效。如果要求中使用的頁面權杖已過期，就會發生這個錯誤。
`badRequest (400)`	`invalidHasAccessToLevel`	`hasAccessToLevel` 參數值無效。沒有任何等級具有指定的 `id`。
`badRequest (400)`	`invalidFilterByMemberChannelId`	`filterByMemberChannelId` 參數值無效。如果 `filterByMemberChannelId` 參數值指定超過 100 個頻道，就會發生這項錯誤。

membershipsLevels

下表列出 API 在回應與 members 資源相關的呼叫時傳回的錯誤訊息。這些方法也可能傳回「常見要求錯誤」一節中列出的錯誤。

`membershipsLevels.list`

錯誤類型	錯誤詳情	說明
`badRequest (400)`	`channelMembershipsNotEnabled`	授權要求的創作者頻道未啟用頻道會員功能。

playlistItems

下表列出 API 針對 playlistItems 資源相關呼叫傳回的錯誤訊息。這些方法也可能傳回「常見要求錯誤」一節中列出的錯誤。

`playlistItems.delete`

錯誤類型	錯誤詳情	說明
`forbidden (403)`	`playlistItemsNotAccessible`	要求未經適當授權，無法刪除指定的播放清單項目。
`notFound (404)`	`playlistItemNotFound`	找不到要求 `id` 參數指定的播放清單項目。
`invalidValue (400)`	`playlistOperationUnsupported`	API 不支援從指定播放清單刪除影片的功能。舉例來說，你無法從上傳的影片播放清單中刪除影片。

`playlistItems.insert`

錯誤類型	錯誤詳情	說明
`duplicate`	`videoAlreadyInPlaylist`	你要加入播放清單的影片已在其中。
`forbidden (403)`	`playlistContainsMaximumNumberOfVideos`	播放清單中的項目數量已達上限。
`forbidden (403)`	`playlistItemsNotAccessible`	要求未經適當授權，無法插入指定的播放清單項目。
`invalidValue (400)`	`invalidContentDetails`	要求中的 `contentDetails` 屬性無效。可能的原因是「`contentDetails.note`」欄位超過 280 個字元。
`invalidValue (400)`	`invalidPlaylistItemPosition`	要求嘗試將播放清單項目的位置設為無效或不支援的值。檢查資源 `snippet` 中的 `position` 屬性值。
`invalidValue (400)`	`invalidResourceType`	這項作業不支援為資源 ID 指定的 `type`。資源 ID 會識別要新增至播放清單的項目，例如 `youtube#video`。
`invalidValue (400)`	`manualSortRequired`	要求嘗試設定播放清單項目的位置，但播放清單並未使用手動排序。(例如依日期或熱門程度排序)。如要解決這項錯誤，請從要求插入的資源中移除 `snippet.position` 元素。如要將播放清單項目放在清單中的特定位置，請先在播放清單設定中，將播放清單的「排序」選項更新為「手動」。你可以在 YouTube 影片管理員中調整這項設定。
`invalidValue (400)`	`videoAlreadyInAnotherSeriesPlaylist`	你要新增至播放清單的影片已加入其他系列播放清單。
`invalidValue (400)`	`playlistOperationUnsupported`	API 不支援將影片插入指定播放清單。舉例來說，你無法在「上傳的影片」播放清單中插入影片。
`notFound (404)`	`playlistNotFound`	找不到要求 `playlistId` 參數指定的播放清單。
`notFound (404)`	`videoNotFound`	找不到你要新增至播放清單的影片。請檢查 `videoId` 屬性的值，確保正確無誤。
`required (400)`	`channelIdRequired`	要求未指定必要 `channelId` 屬性的值。
`required (400)`	`playlistIdRequired`	要求未指定必要 `playlistId` 屬性的值。
`required (400)`	`resourceIdRequired`	要求必須包含資源，其中 `snippet` 物件指定 `resourceId`。

`playlistItems.list`

錯誤類型	錯誤詳情	說明
`forbidden (403)`	`playlistItemsNotAccessible`	要求未獲得適當授權，無法擷取指定播放清單。
`notFound (404)`	`playlistNotFound`	找不到要求 `playlistId` 參數指定的播放清單。
`notFound (404)`	`videoNotFound`	找不到要求 `videoId` 參數指定的影片。
`required (400)`	`playlistIdRequired`	訂閱要求未指定必要 `playlistId` 屬性的值。
`invalidValue (400)`	`playlistOperationUnsupported`	這個 API 不支援列出指定播放清單中的影片。舉例來說，你無法將影片列入「稍後觀看」播放清單。

`playlistItems.update`

錯誤類型	錯誤詳情	說明
`forbidden (403)`	`playlistItemsNotAccessible`	要求未獲得適當授權，無法更新指定的播放清單項目。
`invalidValue (400)`	`invalidPlaylistItemPosition`	要求嘗試將播放清單項目的位置設為無效或不支援的值。請檢查資源 `snippet` 中 `position` 屬性的值。
`invalidValue (400)`	`invalidResourceType`	這項作業不支援為資源 ID 指定的 `type`。資源 ID 會識別要新增至播放清單的項目，例如 `youtube#video`。
`invalidValue (400)`	`invalidSnippet`	要求未指定有效的 `snippet` 屬性。
`invalidValue (400)`	`manualSortRequired`	要求嘗試設定播放清單項目的位置，但播放清單並未使用手動排序。(例如依日期或熱門程度排序)。如要解決這項錯誤，請從要求插入的資源中移除 `snippet.position` 元素。如要將播放清單項目放在清單中的特定位置，請先在播放清單設定中，將播放清單的「排序」選項更新為「手動」。你可以在 YouTube 影片管理員中調整這項設定。
`invalidValue (400)`	`playlistOperationUnsupported`	API 不支援更新指定播放清單中的影片。舉例來說，你無法更新「上傳的影片」播放清單中的影片。
`notFound (404)`	`playlistItemNotFound`	找不到以要求 `id` 屬性識別的播放清單項目。
`notFound (404)`	`playlistNotFound`	找不到要求 `playlistId` 參數指定的播放清單。
`required (400)`	`channelIdRequired`	要求未指定必要 `channelId` 屬性的值。
`required (400)`	`playlistIdRequired`	要求未指定必要 `playlistId` 屬性的值。
`required (400)`	`playlistItemIdRequired`	要求中指定的播放清單項目資源必須使用 `id` 屬性，識別要更新的播放清單項目。

播放清單

下表列出 API 針對 playlists 資源相關呼叫傳回的錯誤訊息。這些方法也可能傳回「常見要求錯誤」一節列出的錯誤。

`playlists.delete`

錯誤類型	錯誤詳情	說明
`forbidden (403)`	`playlistForbidden`	這項作業遭到禁止，或要求未獲得適當授權。
`notFound (404)`	`playlistNotFound`	找不到要求 `id` 參數指定的播放清單。
`invalidValue (400)`	`playlistOperationUnsupported`	API 不支援刪除指定播放清單的功能。舉例來說，你無法刪除「上傳的影片」播放清單。

`playlists.list`

錯誤類型	錯誤詳情	說明
`forbidden (403)`	`channelClosed`	`channelId` 參數中指定的管道已關閉。
`forbidden (403)`	`channelSuspended`	`channelId` 參數指定的頻道已遭停權。
`forbidden (403)`	`playlistForbidden`	以要求 `id` 參數識別的播放清單不支援要求，或要求未獲得適當授權。
`notFound (404)`	`channelNotFound`	找不到 `channelId` 參數中指定的管道。
`notFound (404)`	`playlistNotFound`	找不到要求 `id` 參數指定的播放清單。
`invalidValue (400)`	`playlistOperationUnsupported`	API 不支援列出指定播放清單的功能。舉例來說，你無法列出「稍後觀看」播放清單。

`playlists.insert`

錯誤類型	錯誤詳情	說明
`badRequest (400)`	`defaultLanguageNotSetError`	`defaultLanguage` 必須設為更新 `localizations`。
`badRequest (400)`	`localizationValidationError`	localizations 物件中的某個值未通過驗證。請使用 playlists.list 方法擷取有效值，並務必按照播放清單資源說明文件中的規範更新。
`badRequest (400)`	`maxPlaylistExceeded`	頻道的播放清單數量已達上限，因此無法建立播放清單。
`forbidden (403)`	`playlistForbidden`	這項作業遭到禁止，或要求未獲得適當授權。
`invalidValue (400)`	`invalidPlaylistSnippet`	要求提供的播放清單片段無效。
`required (400)`	`playlistTitleRequired`	要求必須指定播放清單標題。

`playlists.update`

錯誤類型	錯誤詳情	說明
`badRequest (400)`	`defaultLanguageNotSetError`	`defaultLanguage` 必須設為更新 `localizations`。
`badRequest (400)`	`localizationValidationError`	localizations 物件中的某個值未通過驗證。請使用 playlists.list 方法擷取有效值，並務必按照播放清單資源說明文件中的指南更新這些值。
`forbidden (403)`	`playlistForbidden`	這項作業遭到禁止，或要求未獲得適當授權。
`invalidValue (400)`	`invalidPlaylistSnippet`	要求提供的播放清單程式碼片段無效。
`invalidValue (400)`	`playlistOperationUnsupported`	API 不支援更新指定播放清單。舉例來說，你無法更新上傳影片播放清單的屬性。
`notFound (404)`	`playlistNotFound`	找不到以要求 `id` 參數識別的播放清單。
`required (400)`	`playlistTitleRequired`	要求必須指定播放清單標題。

搜尋

下表列出 API 在回應與 search 資源相關的呼叫時傳回的錯誤訊息。這些方法也可能會傳回「常見要求錯誤」一節中列出的錯誤。

`search.list`

錯誤類型	錯誤詳情	說明
`badRequest (400)`	`invalidChannelId`	`channelId` 參數指定的頻道 ID 無效。
`badRequest (400)`	`invalidLocation`	`location` 和/或 `locationRadius` 參數值的格式不正確。
`badRequest (400)`	`invalidRelevanceLanguage`	`relevanceLanguage` 參數值的格式不正確。
`badRequest (400)`	`invalidSearchFilter`	要求包含無效的搜尋篩選器和/或限制組合。如果您為 `eventType`、`videoCaption`、`videoCategoryId`、`videoDefinition`、`videoDimension`、`videoDuration`、`videoEmbeddable`、`videoLicense`、`videoSyndicated` 或 `videoType` 參數設定值，則必須將 `type` 參數設為 `video`。

訂閱項目

下表列出 API 在回應與 subscriptions 資源相關的呼叫時傳回的錯誤訊息。這些方法也可能會傳回「常見要求錯誤」一節中列出的錯誤。

`subscriptions.delete`

錯誤類型	錯誤詳情	說明
`forbidden (403)`	`subscriptionForbidden`	要求未正確驗證，或這個管道不支援。
`notFound (404)`	`subscriptionNotFound`	找不到您要刪除的訂閱項目。請檢查要求 `id` 參數的值，確保正確無誤。

`subscriptions.insert`

錯誤類型	錯誤詳情	說明
`badRequest (400)`	`subscriptionDuplicate`	您嘗試建立的訂閱項目已存在。
`badRequest (400)`	`subscriptionForbidden`	訂閱數量已達上限。
`badRequest (400)`	`subscriptionForbidden`	您最近訂閱了太多頻道，請過幾個小時後再試一次。
`badRequest (400)`	`subscriptionForbidden`	系統不支援訂閱自己的頻道。
`forbidden (403)`	`subscriptionForbidden`	要求未正確驗證，或這個管道不支援。
`notFound (404)`	`publisherNotFound`	找不到要求 `snippet.resourceId` 屬性指定的資源。
`notFound (404)`	`subscriberNotFound`	找不到要求中指定的訂閱者。
`required (400)`	`publisherRequired`	要求中指定的訂閱資源必須使用 `snippet.resourceId` 屬性，識別要訂閱的頻道。

`subscriptions.list`

錯誤類型	錯誤詳情	說明
`forbidden (403)`	`accountClosed`	訂閱者的帳戶已關閉，因此無法擷取訂閱項目。
`forbidden (403)`	`accountSuspended`	訂閱者的帳戶已遭停權，因此無法擷取訂閱項目。
`forbidden (403)`	`subscriptionForbidden`	要求者無權存取所要求的訂閱項目。
`notFound (404)`	`subscriberNotFound`	找不到要求中指定的訂閱者。

縮圖

下表列出 API 在回應與 thumbnails 資源相關的呼叫時傳回的錯誤訊息。這些方法也可能傳回「常見要求錯誤」一節中列出的錯誤。

`thumbnails.set`

錯誤類型	錯誤詳情	說明
`badRequest (400)`	`invalidImage`	提供的圖片內容無效。
`badRequest (400)`	`mediaBodyRequired`	要求未包含圖片內容。
`forbidden (403)`	`forbidden`	無法為指定影片設定縮圖。要求可能未獲得適當授權。
`forbidden (403)`	`forbidden`	已驗證的使用者沒有權限上傳及設定自訂影片縮圖。
`notFound (404)`	`videoNotFound`	找不到要插入縮圖的影片。檢查要求中 `videoId` 參數的值，確認是否正確。
`tooManyRequests (429)`	`uploadRateLimitExceeded`	頻道最近上傳的縮圖過多，請稍後再試。

videoAbuseReportReasons

下表列出 API 在回應與 videoAbuseReportReasons 資源相關的呼叫時傳回的錯誤訊息。這些方法也可能會傳回「常見要求錯誤」一節中列出的錯誤。

`videoAbuseReportReasons.list`

錯誤類型	錯誤詳情	說明
`forbidden (403)`	`forbidden`	禁止存取。要求可能未獲得適當授權。

videoCategories

下表列出 API 在回應與 videoCategories 資源相關的呼叫時傳回的錯誤訊息。這些方法也可能傳回「常見要求錯誤」一節中列出的錯誤。

`videoCategories.list`

錯誤類型	錯誤詳情	說明
`notFound (404)`	`videoCategoryNotFound`	找不到 `id` 參數識別的影片類別。使用 videoCategories.list 方法擷取有效值清單。

影片

下表列出 API 在回應與 videos 資源相關的呼叫時傳回的錯誤訊息。這些方法也可能會傳回「常見要求錯誤」一節中列出的錯誤。

`videos.insert`

錯誤類型	錯誤詳情	說明
`badRequest (400)`	`defaultLanguageNotSet`	要求嘗試新增本地化影片詳細資料，但未指定影片詳細資料的預設語言。
`badRequest (400)`	`invalidCategoryId`	`snippet.categoryId` 屬性指定的類別 ID 無效。使用 `videoCategories.list` 方法擷取支援的類別。
`badRequest (400)`	`invalidDescription`	要求中繼資料指定的影片說明無效。
`badRequest (400)`	`invalidFilename`	`Slug` 標頭中指定的影片檔案名稱無效。
`badRequest (400)`	`invalidPublishAt`	要求中繼資料指定的排定發布時間無效。
`badRequest (400)`	`invalidRecordingDetails`	要求中繼資料中的 `recordingDetails` 物件指定了無效的錄製詳細資料。
`badRequest (400)`	`invalidTags`	要求中繼資料指定了無效的影片關鍵字。
`badRequest (400)`	`invalidTitle`	要求中繼資料指定的影片標題無效或空白。
`badRequest (400)`	`invalidVideoGameRating`	要求中繼資料指定的電玩遊戲分級無效。
`badRequest (400)`	`invalidVideoMetadata`	要求中繼資料無效。如果要求更新 `video` 資源的 `snippet` 部分，但未設定 `snippet.title` 和 `snippet.categoryId` 屬性的值，就會發生這項錯誤。
`badRequest (400)`	`mediaBodyRequired`	要求不含影片內容。
`badRequest (400)`	`uploadLimitExceeded`	頻道已達每日影片上傳數量上限。這是 YouTube 平台的限制，與 Google Cloud 雲端專案的 API 配額完全無關。
`forbidden (403)`	`forbidden`
`forbidden (403)`	`forbiddenLicenseSetting`	要求嘗試為影片設定無效授權。
`forbidden (403)`	`forbiddenPrivacySetting`	要求嘗試為影片設定無效的隱私權設定。

`videos.list`

錯誤類型	錯誤詳情	說明
`badRequest (400)`	`videoChartNotFound`	不支援或無法提供要求的影片圖表。
`forbidden (403)`	`forbidden`	要求未獲得適當授權，無法存取影片檔案或處理資訊。`fileDetails`、`processingDetails` 和 `suggestions` 部分僅供影片擁有者使用。
`forbidden (403)`	`forbidden`	要求無法存取使用者評分資訊。這項錯誤可能是因為要求未正確授權使用 `myRating` 參數。
`notFound (404)`	`videoNotFound`	找不到您要擷取的影片。請檢查要求 `id` 參數的值，確保正確無誤。

`videos.delete`

錯誤類型	錯誤詳情	說明
`forbidden (403)`	`forbidden`	無法刪除你嘗試刪除的影片。要求可能未獲得適當授權。
`notFound (404)`	`videoNotFound`	找不到您要刪除的影片。請檢查要求 `id` 參數的值，確保正確無誤。

`videos.update`

錯誤類型	錯誤詳情	說明
`badRequest (400)`	`defaultLanguageNotSet`	API 要求嘗試新增本地化影片詳細資料，但未指定影片詳細資料的預設語言。
`badRequest (400)`	`invalidCategoryId`	`snippet.categoryId` 屬性指定的類別 ID 無效。使用 `videoCategories.list` 方法擷取支援的類別。
`badRequest (400)`	`invalidDefaultBroadcastPrivacySetting`	要求嘗試為預設廣播設定無效的隱私權設定。
`badRequest (400)`	`invalidDescription`	要求中繼資料指定的影片說明無效。
`badRequest (400)`	`invalidPublishAt`	要求中繼資料指定的排定發布時間無效。
`badRequest (400)`	`invalidRecordingDetails`	要求中繼資料中的 `recordingDetails` 物件指定了無效的錄製詳細資料。
`badRequest (400)`	`invalidTags`	要求中繼資料指定了無效的影片關鍵字。
`badRequest (400)`	`invalidTitle`	要求中繼資料指定的影片標題無效或空白。
`badRequest (400)`	`invalidVideoMetadata`	要求中繼資料無效。如果要求更新 `video` 資源的 `snippet` 部分，但未設定 `snippet.title` 和 `snippet.categoryId` 屬性的值，就會發生這項錯誤。
`forbidden (403)`	`forbidden`	禁止存取。要求可能未獲得適當授權。
`forbidden (403)`	`forbiddenEmbedSetting`	要求嘗試為影片設定無效的嵌入設定。部分頻道可能未獲授權，無法提供直播嵌入式播放器。詳情請參閱 YouTube 說明中心。
`forbidden (403)`	`forbiddenLicenseSetting`	要求嘗試為影片設定無效的授權。
`forbidden (403)`	`forbiddenPrivacySetting`	要求嘗試為影片設定無效的隱私權設定。
`notFound (404)`	`videoNotFound`	找不到您要更新的影片。請檢查要求主體中的 `id` 欄位值，確認是否正確。

`videos.rate`

錯誤類型	錯誤詳情	說明
`badRequest (400)`	`emailNotVerified`	使用者必須先驗證電子郵件地址，才能評分。
`badRequest (400)`	`invalidRating`	要求中的 `rating` 參數含有非預期的值。
`badRequest (400)`	`videoPurchaseRequired`	只有租借影片的使用者可以評分。
`forbidden (403)`	`forbidden`	你嘗試評分的影片無法評分。要求可能未獲得適當授權。
`forbidden (403)`	`videoRatingDisabled`	影片擁有者已停用評分功能。
`notFound (404)`	`videoNotFound`	找不到你要評分的影片。請檢查要求 `id` 參數的值，確保正確無誤。

`videos.reportAbuse`

錯誤類型	錯誤詳情	說明
`badRequest (400)`	`invalidAbuseReason`	要求中的 `reason_id` 欄位或 `reason_id` 和 `secondary_reason_id` 欄位組合含有非預期的值。
`badRequest (400)`	`rateLimitExceeded`	使用者在指定時間範圍內傳送過多要求。
`forbidden (403)`	`forbidden`
`notFound (404)`	`videoNotFound`	找不到您要檢舉濫用行為的影片。

浮水印

下表列出 API 針對 watermarks 資源相關呼叫傳回的錯誤訊息。這些方法也可能傳回「常見要求錯誤」一節中列出的錯誤。

`watermarks.set`

錯誤類型	錯誤詳情	說明
`badRequest (400)`	`imageFormatUnsupported`	你提供的圖片格式不受支援。
`badRequest (400)`	`imageTooTall`	提供的圖片過高。
`badRequest (400)`	`imageTooWide`	提供的圖片過寬。
`badRequest (400)`	`mediaBodyRequired`	要求不含圖片內容。
`forbidden (403)`	`forbidden`	無法為指定頻道設定浮水印。要求可能未正確授權，或 `channelId` 參數設為無效值。

`watermarks.unset`

錯誤類型	錯誤詳情	說明
`forbidden (403)`	`forbidden`	無法取消指定頻道的浮水印。要求可能未正確授權，或 `channelId` 參數設為無效值。

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

一般錯誤

Core API errors

Common request errors

Request context errors

活動

activities.list

字幕

captions.delete

captions.download

captions.insert

captions.list

captions.update

channelBanners

channelBanners.insert

channelSections

channelSections.delete

channelSections.insert

channelSections.list

channelSections.update

頻道

channels.list

channels.update

commentThreads

commentThreads.list

commentThreads.insert

comments

comments.list

comments.setModerationStatus

comments.insert

comments.delete

comments.update

成員

members.list

membershipsLevels

membershipsLevels.list