Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

YouTube Data API - Errors

このドキュメントでは、YouTube Data API オペレーションから返される可能性のあるさまざまな種類のエラーについて説明します。また、各メソッドのリファレンスドキュメントには、そのメソッドで表示される可能性のあるエラーのリストが記載されています。

一般的なエラー

次の表に、特定の API メソッドに固有ではない API エラーメッセージを示します。

`Core API errors`

エラーのタイプ	エラーの詳細	説明
`forbidden (403)`	`forbidden`	アクセスは禁止されています。リクエストは適切に承認されない可能性があります。
`quotaExceeded (403)`	`quotaExceeded`	リクエストを完了できません。既に割り当てを超えています。

`Common request errors`

エラーのタイプ	エラーの詳細	説明
`badRequest (400)`	`incompatibleParameters`	リクエストに 1 つのリクエストでは同時に使用できないパラメータが複数指定されています。
`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` パラメータが使用可能な場合は、このパラメータを指定してパートナーのチャンネルの 1 つとして動作する必要があります。
`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 のエラーについて説明していますが、エラーの意味は引き続き適用されます。

アクティビティ

次の表に、activities リソースに関連する呼び出しに対して API が返すエラーメッセージを示します。これらのメソッドは、一般的なリクエストエラーのセクションに記載されているエラーを返すこともあります。

`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.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 文字（全角 75 文字）です。

`captions.list`

エラーのタイプ	エラーの詳細	説明
`forbidden (403)`	`forbidden`	リクエストに関連付けられた権限が、リクエストされたリソースを取得するのに十分でないため、1 つ以上の字幕トラックを取得できませんでした。リクエストが適切に認証されていない可能性があります。
`notFound (404)`	`captionNotFound`	指定された字幕トラックが 1 つ以上見つかりませんでした。このエラーは、`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

次の表に、channelBanners リソースに関連する呼び出しに応じて API が返すエラーメッセージを示します。これらのメソッドは、一般的なリクエストエラーのセクションに記載されているエラーを返すこともあります。

`channelBanners.insert`

エラーのタイプ	エラーの詳細	説明
`badRequest (400)`	`bannerAlbumFull`	YouTube チャンネルアートアルバムの画像が多すぎます。http://photos.google.com にアクセスし、アルバムページに移動して、そのアルバムから画像をいくつか削除してください。
`badRequest (400)`	`mediaBodyRequired`	リクエストに画像コンテンツが含まれていません。

channelSections

次の表に、channelSections リソースに関連する呼び出しに対して API が返すエラーメッセージを示します。これらのメソッドは、一般的なリクエストエラーのセクションに記載されているエラーを返すこともあります。

`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` オブジェクトの言語キーの 1 つが検証に失敗しました。channelSections.list メソッドを使用して有効な値を取得し、`channelSections` リソースのドキュメントのガイドラインに沿って更新してください。
`badRequest (400)`	`notEditable`	このチャンネルセクションは作成できません。
`badRequest (400)`	`styleRequired`	`channelSection` リソースでは、`snippet.style` フィールドの値を指定する必要があります。
`badRequest (400)`	`targetInvalidCountry`	`targeting.countries` リストの値のいずれかが検証に失敗しました。channelSections.list メソッドを使用して有効な値を取得し、`channelSections` リソースのドキュメントのガイドラインに沿って更新してください。
`badRequest (400)`	`targetInvalidLanguage`	`targeting.languages` リストの値の 1 つが検証に失敗しました。channelSections.list メソッドを使用して有効な値を取得し、`channelSections` リソースのドキュメントのガイドラインに沿って更新してください。
`badRequest (400)`	`targetInvalidRegion`	`targeting.regions` リストの値の 1 つが検証に失敗しました。channelSections.list メソッドを使用して有効な値を取得し、`channelSections` リソースのドキュメントのガイドラインに沿って更新します。
`badRequest (400)`	`typeRequired`	`channelSection` リソースでは、`snippet.type` フィールドの値を指定する必要があります。
`forbidden (403)`	`channelSectionForbidden`	リクエストが適切に認証されていないか、このチャネルではサポートされていません。
`invalidValue (400)`	`channelNotActive`	指定されたチャンネルのうち、少なくとも 1 つが有効ではありません。
`invalidValue (400)`	`channelsDuplicated`	重複するチャネルが指定されていたため、リクエストを処理できませんでした。
`invalidValue (400)`	`channelsNeeded`	`snippet.type` プロパティの値が `multipleChannels` の場合、`contentDetails.channels[]` プロパティを指定し、少なくとも 1 つのチャネルを指定する必要があります。
`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[]` プロパティには 1 つの再生リストのみを指定する必要があります。
`invalidValue (400)`	`ownChannelInChannels`	自分のチャンネルを、そのチャンネルに表示されるチャンネルセクションに含めることはできません。
`invalidValue (400)`	`playlistIsPrivate`	指定された再生リストの 1 つ以上が非公開であるため、チャンネルセクションに含めることができません。
`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`	指定された 1 つ以上のチャンネルが見つかりません。
`notFound (404)`	`playlistNotFound`	指定された 1 つ以上の再生リストが見つかりません。

`channelSections.list`

エラーのタイプ	エラーの詳細	説明
`forbidden (403)`	`channelSectionForbidden`	リクエスト元は、リクエストされたチャンネルセクションにアクセスすることを許可されていません。
`invalidValue (400)`	`idInvalid`	リクエストで無効なチャンネルセクション ID が指定されています。
`invalidValue (400)`	`invalidCriteria`	フィルタ条件が無効なため、リクエストを完了できませんでした。
`notFound (404)`	`channelNotFound`	リクエストに関連付けられているチャンネルが見つかりません。
`notFound (404)`	`channelSectionNotFound`	リクエストに関連付けられているチャンネルセクションが見つかりません。

`channelSections.update`

エラーのタイプ	エラーの詳細	説明
`badRequest (400)`	`defaultLanguageNotSetError`	`channelSection` リソースの `snippet.defaultLanguage` プロパティは、そのリソースの `localizations` オブジェクトを正常に挿入または更新するように設定する必要があります。
`badRequest (400)`	`invalidLanguage`	`localizations` オブジェクトの言語キーのいずれかの検証に失敗しました。channelSections.list メソッドを使用して有効な値を取得し、`channelSections` リソースのドキュメントのガイドラインに沿って更新してください。
`badRequest (400)`	`notEditable`	このチャンネルセクションは編集できません。
`badRequest (400)`	`styleRequired`	`channelSection` リソースでは、`snippet.style` フィールドの値を指定する必要があります。
`badRequest (400)`	`targetInvalidCountry`	`targeting.countries` リストの値のいずれかが検証に失敗しました。channelSections.list メソッドを使用して有効な値を取得し、`channelSections` リソースのドキュメントのガイドラインに沿って更新してください。
`badRequest (400)`	`targetInvalidLanguage`	`targeting.languages` リストの値のいずれかが検証に失敗しました。channelSections.list メソッドを使用して有効な値を取得し、`channelSections` リソースのドキュメントのガイドラインに沿って更新します。
`badRequest (400)`	`targetInvalidRegion`	`targeting.regions` リストの値の 1 つが検証に失敗しました。channelSections.list メソッドを使用して有効な値を取得し、`channelSections` リソースのドキュメントのガイドラインに沿って更新してください。
`badRequest (400)`	`typeRequired`	`channelSection` リソースでは、`snippet.type` フィールドの値を指定する必要があります。
`forbidden (403)`	`channelSectionForbidden`	リクエストが適切に認証されていないか、このチャネルではサポートされていません。
`invalidValue (400)`	`channelNotActive`	指定されたチャンネルのうち、少なくとも 1 つが有効ではありません。
`invalidValue (400)`	`channelsDuplicated`	重複するチャネルが指定されていたため、リクエストを処理できませんでした。
`invalidValue (400)`	`channelsNeeded`	`snippet.type` プロパティの値が `multipleChannels` の場合、`contentDetails.channels[]` プロパティを指定し、少なくとも 1 つのチャネルを指定する必要があります。
`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[]` プロパティには 1 つの再生リストのみを指定する必要があります。
`invalidValue (400)`	`ownChannelInChannels`	自分のチャンネルを、そのチャンネルに表示されるチャンネルセクションに含めることはできません。
`invalidValue (400)`	`playlistIsPrivate`	指定された再生リストの 1 つ以上が非公開であるため、チャンネルセクションに含めることができません。
`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`	指定された 1 つ以上のチャンネルが見つかりません。
`notFound (404)`	`channelSectionNotFound`	更新しようとしているチャンネルセクションが見つかりません。
`notFound (404)`	`playlistNotFound`	指定された 1 つ以上の再生リストが見つかりません。

チャネル

次の表に、channels リソースに関連する呼び出しに応じて API が返すエラーメッセージを示します。これらのメソッドは、一般的なリクエストエラーのセクションに記載されているエラーを返すこともあります。

`channels.list`

エラーのタイプ	エラーの詳細	説明
`badRequest (400)`	`invalidCriteria`	指定できるフィルタは、`id`、`mySubscribers`、`categoryId`、`mine`、`managedByMe`、`forUsername` のいずれか 1 つのみです。`onBehalfOfContentOwner` パラメータを使用してコンテンツ所有者の認証を行う場合は、`id` または `managedByMe` のみを指定できます。
`forbidden (403)`	`channelForbidden`	`id` パラメータで指定されたチャネルがリクエストをサポートしていないか、リクエストが適切に承認されていません。
`notFound (404)`	`categoryNotFound`	`categoryId` パラメータで指定されたカテゴリが見つかりません。
`notFound (404)`	`channelNotFound`	`id` パラメータで指定されたチャンネルが見つかりません。

`channels.update`

エラーのタイプ	エラーの詳細	説明
`badRequest (400)`	`brandingValidationError`	`brandingSettings` オブジェクトの値の 1 つが検証に失敗しました。`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`	リクエストのメタデータで、動画内プロモーションのパートに無効な継続時間が指定されています。
`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`	localizations オブジェクトの値の 1 つが検証に失敗しました。channels.list メソッドを使用して有効な値を取得し、チャンネルリソースのドキュメントのガイドラインに沿って更新してください。
`badRequest (400)`	`tooManyPromotedItems`	invideoPromotion 部分で許可されているプロモーションアイテムの数を超えています。
`forbidden (403)`	`channelForbidden`	`id` パラメータで指定されたチャンネルがリクエストをサポートしていないか、リクエストが適切に承認されていません。
`forbidden (403)`	`promotedVideoNotAllowed`	API リクエストが更新しようとしているチャンネルが見つかりません。リクエストが送信した `channel` リソースの `id` プロパティの値を確認して、チャンネル ID が正しいことを確認します。
`forbidden (403)`	`websiteLinkNotAllowed`	指定されたウェブサイトの URL は許可されていません。
`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 部分でウェブサイトの URL を指定する必要があります。リクエストが送信するリソースの `invideoPromotion.items[].id.websiteUrl` プロパティの値を設定します。

commentThreads

次の表に、commentThreads リソースに関連する呼び出しに対して API が返すエラーメッセージを示します。これらのメソッドは、一般的なリクエストエラーのセクションに記載されているエラーを返すこともあります。

`commentThreads.list`

エラーのタイプ	エラーの詳細	説明
`badRequest (400)`	`operationNotSupported`	API リクエストが無効であるか、形式が正しくありません。その結果、API サーバーはリクエストを理解できませんでした。
`badRequest (400)`	`processingFailure`	API サーバーがリクエストを正常に処理できませんでした。これは一時的なエラーである可能性がありますが、通常はリクエストの入力が無効であることを示します。リクエスト本文の `commentThread` リソースの構造をチェックして、有効であることを確認します。
`forbidden (403)`	`commentsDisabled`	`videoId` パラメータで指定された動画では、コメントが無効になっています。
`forbidden (403)`	`forbidden`	権限が不十分なため、リクエストされたコメントスレッドの 1 つ以上を取得できません。リクエストが適切に認証されていない可能性があります。
`notFound (404)`	`channelNotFound`	`allThreadsRelatedToChannelId` パラメータで指定されたチャンネルが見つかりませんでした。
`notFound (404)`	`commentThreadNotFound`	指定されたコメントスレッドが 1 つ以上見つかりません。リクエストの `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.list`

エラーのタイプ	エラーの詳細	説明
`badRequest (400)`	`operationNotSupported`	API リクエストが無効であるか、形式が正しくありません。その結果、API サーバーはリクエストを理解できませんでした。
`forbidden (403)`	`forbidden`	権限が不十分なため、リクエストされたコメントの一部を取得できません。リクエストが適切に認証されていない可能性があります。
`notFound (404)`	`commentNotFound`	指定された 1 つ以上のコメントが見つかりません。リクエストの `id` パラメータと `parentId` パラメータの値が正しいことを確認します。

`comments.setModerationStatus`

エラーのタイプ	エラーの詳細	説明
`badRequest (400)`	`banWithoutReject`	`banAuthor` パラメータは、`moderationStatus` パラメータ値が `rejected` の場合にのみ使用できます。
`badRequest (400)`	`operationNotSupported`	API リクエストが無効であるか、形式が正しくありません。その結果、API サーバーはリクエストを理解できませんでした。
`badRequest (400)`	`processingFailure`	API サーバーがリクエストを正常に処理できませんでした。これは一時的なエラーである可能性がありますが、通常はリクエストの入力が無効であることを示します。
`forbidden (403)`	`forbidden`	権限が不十分なため、1 つ以上のコメントの管理ステータスを設定できません。リクエストが適切に認証されていない可能性があります。
`notFound (404)`	`commentNotFound`	リクエストで更新しようとしているコメントが 1 つ以上見つかりません。リクエストの `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` プロパティの値が正しいことを確認します。

メンバー

次の表に、members リソースに関連する呼び出しに対して API が返すエラーメッセージを示します。これらのメソッドは、一般的なリクエストエラーのセクションに記載されているエラーを返すこともあります。

`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

`membershipsLevels.list`

エラーのタイプ	エラーの詳細	説明
`badRequest (400)`	`channelMembershipsNotEnabled`	リクエストを承認するクリエイターチャンネルで、チャンネルメンバーシップが有効になっていません。

playlistItems

次の表に、playlistItems リソースに関連する呼び出しに応じて API が返すエラーメッセージを示します。これらのメソッドは、一般的なリクエストエラーのセクションに記載されているエラーを返すこともあります。

`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` プロパティを使用して、更新するプレイリストアイテムを識別する必要があります。

再生リスト

次の表に、playlists リソースに関連する呼び出しに応じて API が返すエラーメッセージを示します。これらのメソッドは、一般的なリクエストエラーのセクションに記載されているエラーを返すこともあります。

`playlists.delete`

エラーのタイプ	エラーの詳細	説明
`forbidden (403)`	`playlistForbidden`	このオペレーションは禁止されているか、リクエストが適切に承認されていません。
`notFound (404)`	`playlistNotFound`	リクエストの `id` パラメータで指定された再生リストが見つかりません。
`invalidValue (400)`	`playlistOperationUnsupported`	API は、指定された再生リストを削除する機能をサポートしていません。たとえば、アップロードした動画の再生リストは削除できません。

`playlists.list`

エラーのタイプ	エラーの詳細	説明
`forbidden (403)`	`channelClosed`	`channelId` パラメータで指定されたチャンネルが閉じられています。
`forbidden (403)`	`channelSuspended`	`channelId` パラメータで指定されたチャンネルが停止されています。
`forbidden (403)`	`playlistForbidden`	リクエストの `id` パラメータで指定された再生リストがリクエストをサポートしていないか、リクエストが適切に承認されていません。
`notFound (404)`	`channelNotFound`	`channelId` パラメータで指定されたチャンネルが見つかりません。
`notFound (404)`	`playlistNotFound`	リクエストの `id` パラメータで指定された再生リストが見つかりません。
`invalidValue (400)`	`playlistOperationUnsupported`	この API は、指定された再生リストを一覧表示する機能をサポートしていません。たとえば、[後で見る] 再生リストは一覧表示できません。

`playlists.insert`

エラーのタイプ	エラーの詳細	説明
`badRequest (400)`	`defaultLanguageNotSetError`	`defaultLanguage` は `localizations` を更新するように設定する必要があります。
`badRequest (400)`	`localizationValidationError`	localizations オブジェクトの値の 1 つが検証に失敗しました。playlists.list メソッドを使用して有効な値を取得し、再生リストリソースのドキュメントのガイドラインに沿って更新してください。
`badRequest (400)`	`maxPlaylistExceeded`	チャンネルに作成できる再生リストの最大数に達しているため、再生リストを作成できません。
`forbidden (403)`	`playlistForbidden`	このオペレーションは禁止されているか、リクエストが適切に認可されていません。
`invalidValue (400)`	`invalidPlaylistSnippet`	リクエストに指定されている再生リストスニペットは無効です。
`required (400)`	`playlistTitleRequired`	リクエストでは、再生リストのタイトルを指定する必要があります。

`playlists.update`

エラーのタイプ	エラーの詳細	説明
`badRequest (400)`	`defaultLanguageNotSetError`	`defaultLanguage` は `localizations` を更新するように設定する必要があります。
`badRequest (400)`	`localizationValidationError`	localizations オブジェクトの値の 1 つが検証に失敗しました。playlists.list メソッドを使用して有効な値を取得し、再生リストリソースのドキュメントのガイドラインに沿って更新してください。
`forbidden (403)`	`playlistForbidden`	このオペレーションは禁止されているか、リクエストが適切に認可されていません。
`invalidValue (400)`	`invalidPlaylistSnippet`	リクエストに指定されている再生リストスニペットは無効です。
`invalidValue (400)`	`playlistOperationUnsupported`	API は、指定された再生リストを更新する機能をサポートしていません。たとえば、アップロードした動画の再生リストのプロパティは更新できません。
`notFound (404)`	`playlistNotFound`	リクエストの `id` パラメータで指定された再生リストが見つかりません。
`required (400)`	`playlistTitleRequired`	リクエストでは、再生リストのタイトルを指定する必要があります。

検索

次の表に、search リソースに関連する呼び出しに対して API が返すエラーメッセージを示します。これらのメソッドは、一般的なリクエストエラーセクションに記載されているエラーを返すこともあります。

`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` に設定する必要があります。

サブスクリプション

次の表に、subscriptions リソースに関連する呼び出しに応じて API が返すエラーメッセージを示します。これらのメソッドは、一般的なリクエストエラーセクションに記載されているエラーを返すこともあります。

`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`	リクエストで特定されているチャンネル登録者が見つかりません。

サムネイル

次の表に、thumbnails リソースに関連する呼び出しに対して API が返すエラーメッセージを示します。これらのメソッドは、一般的なリクエストエラーのセクションに記載されているエラーを返すこともあります。

`thumbnails.set`

エラーのタイプ	エラーの詳細	説明
`badRequest (400)`	`invalidImage`	指定された画像コンテンツが無効です。
`badRequest (400)`	`mediaBodyRequired`	リクエストに画像コンテンツが含まれていません。
`forbidden (403)`	`forbidden`	指定された動画には、サムネイルを設定できません。リクエストが適切に認証されない可能性があります。
`forbidden (403)`	`forbidden`	この認証済みユーザーには、カスタムの動画のサムネイルをアップロードし、設定する権限がありません。
`notFound (404)`	`videoNotFound`	サムネイル画像の挿入先動画が見つかりません。リクエストの `videoId` パラメータの値が正しいことを確認します。
`tooManyRequests (429)`	`uploadRateLimitExceeded`	このチャンネルは最近、サムネイルをアップロードしすぎました。しばらくしてから、もう一度リクエストをお試しください。

videoAbuseReportReasons

次の表に、videoAbuseReportReasons リソースに関連する呼び出しに応じて API が返すエラーメッセージを示します。これらのメソッドは、一般的なリクエストエラーのセクションに記載されているエラーを返すこともあります。

`videoAbuseReportReasons.list`

エラーのタイプ	エラーの詳細	説明
`forbidden (403)`	`forbidden`	アクセスは禁止されています。リクエストは適切に承認されない可能性があります。

videoCategories

次の表に、videoCategories リソースに関連する呼び出しに対して API が返すエラーメッセージを示します。これらのメソッドは、一般的なリクエストエラーのセクションに記載されているエラーを返すこともあります。

`videoCategories.list`

エラーのタイプ	エラーの詳細	説明
`notFound (404)`	`videoCategoryNotFound`	`id` パラメータで指定された動画カテゴリが見つかりません。有効な値のリストを取得するには、videoCategories.list メソッドを使用します。

動画

次の表に、videos リソースに関連する呼び出しに応じて API が返すエラーメッセージを示します。これらのメソッドは、一般的なリクエストエラーセクションに記載されているエラーを返すこともあります。

`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`	チャンネルの 1 日の動画アップロード数の上限に達している。これは YouTube プラットフォームの制限であり、Google Cloud プロジェクトの API 割り当てとは完全に別です。
`forbidden (403)`	`forbidden`
`forbidden (403)`	`forbiddenLicenseSetting`	リクエストは、動画に無効なライセンスを設定しようとしています。
`forbidden (403)`	`forbiddenPrivacySetting`	リクエストは、動画に無効なプライバシー設定を指定しようとしています。

`videos.list`

エラーのタイプ	エラーの詳細	説明
`badRequest (400)`	`videoChartNotFound`	リクエストされた動画チャートはサポートされていないか、使用できません。
`forbidden (403)`	`forbidden`	リクエストに、動画ファイルまたは処理情報にアクセスするための適切な認可がありません。`fileDetails`、`processingDetails`、`suggestions` の部分は、その動画の所有者のみが利用できます。
`forbidden (403)`	`forbidden`	リクエストは、ユーザー評価情報にアクセスできません。このエラーは、`myRating` パラメータを使用するリクエストが適切に承認されていない場合に発生することがあります。
`notFound (404)`	`videoNotFound`	取得しようとしている動画が見つかりません。リクエストの `id` パラメータの値が正しいことを確認します。

`videos.delete`

エラーのタイプ	エラーの詳細	説明
`forbidden (403)`	`forbidden`	動画を削除しようとしていますが、削除できません。リクエストが適切に認証されていない可能性があります。
`notFound (404)`	`videoNotFound`	削除しようとしている動画は見つかりません。リクエストの `id` パラメータの値が正しいことを確認します。

`videos.update`

エラーのタイプ	エラーの詳細	説明
`badRequest (400)`	`defaultLanguageNotSet`	API リクエストは、動画の詳細のデフォルト言語を指定せずに、ローカライズされた動画の詳細を追加しようとしています。
`badRequest (400)`	`invalidCategoryId`	`snippet.categoryId` プロパティに無効なカテゴリ ID が指定されています。`videoCategories.list` メソッドを使用して、サポートされているカテゴリを取得します。
`badRequest (400)`	`invalidDefaultBroadcastPrivacySetting`	リクエストは、デフォルトのブロードキャストに無効なプライバシー設定を設定しようとしています。
`badRequest (400)`	`invalidDescription`	リクエストメタデータで指定された動画の説明は無効です。
`badRequest (400)`	`invalidPublishAt`	リクエストメタデータで指定された公開予定時刻が無効です。
`badRequest (400)`	`invalidRecordingDetails`	リクエストメタデータの `recordingDetails` オブジェクトに、無効な録音の詳細が指定されています。
`badRequest (400)`	`invalidTags`	リクエストメタデータで指定された動画のキーワードは無効です。
`badRequest (400)`	`invalidTitle`	リクエストメタデータで指定された動画タイトルが無効であるか、空です。
`badRequest (400)`	`invalidVideoMetadata`	リクエストメタデータが無効です。このエラーは、リクエストが `video` リソースの `snippet` 部分を更新するものの、`snippet.title` プロパティと `snippet.categoryId` プロパティの両方に値を設定していない場合に発生します。
`forbidden (403)`	`forbidden`	アクセスが禁止されました。リクエストは適切に承認されない可能性があります。
`forbidden (403)`	`forbiddenEmbedSetting`	リクエストが、動画に対して無効な埋め込み設定を行おうとしています。一部のチャンネルでは、ライブ配信用の埋め込みプレーヤーを提供する権限がない場合があります。詳細情報は、YouTube ヘルプセンターをご覧ください。
`forbidden (403)`	`forbiddenLicenseSetting`	リクエストは、動画に無効なライセンスを設定しようとしています。
`forbidden (403)`	`forbiddenPrivacySetting`	リクエストは、動画に無効なプライバシー設定を指定しようとしています。
`notFound (404)`	`videoNotFound`	更新しようとしている動画は見つかりません。リクエスト本文の `id` フィールドの値を確認して、正しいことを確認します。

`videos.rate`

エラーのタイプ	エラーの詳細	説明
`badRequest (400)`	`emailNotVerified`	ユーザーは評価する前にメールアドレスを確認する必要があります。
`badRequest (400)`	`invalidRating`	リクエストに、`rating` パラメータの予期しない値が含まれていました。
`badRequest (400)`	`videoPurchaseRequired`	レンタル動画を評価できるのは、その動画をレンタルしたユーザーのみです。
`forbidden (403)`	`forbidden`	評価しようとしている動画は評価できません。リクエストが適切に認証されていない可能性があります。
`forbidden (403)`	`videoRatingDisabled`	評価しようとしている動画の所有者が、その動画の評価を無効にしています。
`notFound (404)`	`videoNotFound`	評価しようとしている動画は見つかりません。リクエストの `id` パラメータの値が正しいことを確認します。

`videos.reportAbuse`

エラーのタイプ	エラーの詳細	説明
`badRequest (400)`	`invalidAbuseReason`	リクエストに、`reason_id` フィールドまたは `reason_id` フィールドと `secondary_reason_id` フィールドの組み合わせに予期しない値が含まれていました。
`badRequest (400)`	`rateLimitExceeded`	特定の期間内にユーザーが過剰な数のリクエストを送信した。
`forbidden (403)`	`forbidden`
`notFound (404)`	`videoNotFound`	不正行為を報告しようとしている動画が見つかりません。

透かし

次の表に、watermarks リソースに関連する呼び出しに応じて API が返すエラーメッセージを示します。これらのメソッドは、一般的なリクエストエラーのセクションに記載されているエラーを返すこともあります。

`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.list

comments.setModerationStatus

comments.insert

comments.delete

comments.update

メンバー

members.list