本頁面由 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` 參數，但未獲適當授權。

captions

下表列出 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`	影片內促銷部分允許的宣傳商品數量超過上限。
`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`	找不到指定的 lastUploadedBy 頻道 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`	要求必須指定播放清單標題。

search

下表列出 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`	無法找到你要檢舉濫用情形的影片。

watermarks

下表列出 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` 參數設定的值無效。