本頁面由 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 不支援服務帳戶，如果您嘗試使用服務帳戶進行驗證，就會收到這則錯誤訊息。介紹 Google 帳戶支援功能的 YouTube API 部落格文章，也更詳細地說明瞭 `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`	如要成功插入或更新該資源的 `localizations` 物件，必須設定 `channelSection` 資源的 `snippet.defaultLanguage` 屬性。
`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`	如要成功插入或更新該資源的 `localizations` 物件，必須設定 `channelSection` 資源的 `snippet.defaultLanguage` 屬性。
`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` 參數所識別的類別。
`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`	找不到指定的 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`	本地化物件中的其中一個值未通過驗證。使用 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` 參數設為無效值。

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