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

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 版的錯誤，但錯誤的意思仍適用於這個版本。

活動

YouTube 已淘汰頻道公告功能。系統已不再支援 activities.insert 方法。

下表列出 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 方法擷取有效值，並依照 `a href="/youtube/v3/docs/channelSections#resource">channelSections` 資源說明文件中的指南進行更新。
`badRequest (400)`	`notEditable`	無法建立這個管道專區。
`badRequest (400)`	`styleRequired`	`channelSection` 資源必須為 `snippet.style` 欄位指定值。
`badRequest (400)`	`targetInvalidCountry`	`targeting.countries` 清單中的其中一個值驗證失敗。使用 channelSections.list 方法擷取有效值，並依照 `a href="/youtube/v3/docs/channelSections#resource">channelSections` 資源說明文件中的指南進行更新。
`badRequest (400)`	`targetInvalidLanguage`	`targeting.languages` 清單中的其中一個值驗證失敗。使用 channelSections.list 方法擷取有效值，並依照 `a href="/youtube/v3/docs/channelSections#resource">channelSections` 資源說明文件中的指南進行更新。
`badRequest (400)`	`targetInvalidRegion`	`targeting.regions` 清單中的其中一個值驗證失敗。使用 channelSections.list 方法擷取有效值，並依照 `a href="/youtube/v3/docs/channelSections#resource">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 方法擷取有效值，並按照 `a href="/youtube/v3/docs/channelSections#resource">channelSections` 資源說明文件中的指南進行更新。
`badRequest (400)`	`notEditable`	這個管道專區無法編輯。
`badRequest (400)`	`styleRequired`	`channelSection` 資源必須為 `snippet.style` 欄位指定值。
`badRequest (400)`	`targetInvalidCountry`	`targeting.countries` 清單中的其中一個值驗證失敗。使用 channelSections.list 方法擷取有效值，並依照 `a href="/youtube/v3/docs/channelSections#resource">channelSections` 資源說明文件中的指南進行更新。
`badRequest (400)`	`targetInvalidLanguage`	`targeting.languages` 清單中的其中一個值驗證失敗。使用 channelSections.list 方法擷取有效值，並依照 `a href="/youtube/v3/docs/channelSections#resource">channelSections` 資源說明文件中的指南進行更新。
`badRequest (400)`	`targetInvalidRegion`	`targeting.regions` 清單中的其中一個值驗證失敗。使用 channelSections.list 方法擷取有效值，並按照 `a href="/youtube/v3/docs/channelSections#resource">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` 參數所識別的類別。使用 guideCategories.list 方法擷取有效值清單。
`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

系統已不再支援 comments.markAsSpam 方法。

下表列出 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`	本地化物件中的其中一個值驗證失敗。請使用 playlists.list 方法擷取有效值，並確保按照播放清單資源說明文件中的指南更新這些值。
`badRequest (400)`	`maxPlaylistExceeded`	頻道已達到可建立的播放清單上限，因此無法建立播放清單。
`forbidden (403)`	`playlistForbidden`	系統禁止這項作業，或是要求未經過適當授權。
`invalidValue (400)`	`invalidPlaylistSnippet`	要求提供無效的播放清單片段。
`required (400)`	`playlistTitleRequired`	要求必須指定播放清單標題。

`playlists.update`

錯誤類型	錯誤詳細資料	說明
`badRequest (400)`	`defaultLanguageNotSetError`	`defaultLanguage` 必須設為更新 `localizations`。
`badRequest (400)`	`localizationValidationError`	本地化物件中的其中一個值驗證失敗。請使用 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`	使用者已超出可上傳的影片數量。
`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` 參數設為無效值。