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 アカウントに代わって操作を実行している場合、このエラーの対象は Google アカウントになります。
forbidden (403) authenticatedUserAccountSuspended 認証済みユーザーの YouTube アカウントは一時停止されています。この認証済みユーザーが別の Google アカウントに代わって操作を実行している場合、このエラーの対象は 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 はサービス アカウントをサポートしていないため、サービス アカウントを使用して認証しようとすると、このエラーが表示されます。

youtubeSignupRequired エラーについては、Google アカウントのサポートを紹介する YouTube API のブログ投稿でも詳しく説明しています。このブログ記事では、API バージョン 2.1 でのエラーについて説明していますが、エラーの意味は現在でも変わっていません。

アクティビティ

チャンネルのお知らせメッセージ機能は、YouTube でサポートを終了しました。activities.insert メソッドはサポートされなくなりました。

次の表は、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

次の表は、captions リソースに関連する呼び出しへのレスポンスとして API から返されるエラー メッセージをまとめたものです。これらのメソッドは、一般的なエラーのセクションに記載されているエラーを返す場合もあります。

captions.delete

エラーのタイプ エラーの詳細 説明
forbidden (403) forbidden リクエストに関連付けられている権限では、字幕トラックを削除できません。リクエストが適切に認証されない可能性があります。
notFound (404) captionNotFound 字幕トラックが見つかりませんでした。リクエストの id パラメータの値が正しいことを確認してください。

captions.download

エラーのタイプ エラーの詳細 説明
forbidden (403) forbidden リクエストに関連付けられている権限では、字幕トラックをダウンロードできません。リクエストが適切に認証されていないか、動画の注文でこの字幕への第三者による提供が有効になっていない可能性があります。
invalidValue (400) couldNotConvert 字幕トラック データをリクエストされた言語や形式に変換できませんでした。リクエストされた tfmttlang の値が有効であり、リクエストされた字幕トラックの snippet.statusfailed でないことを確認します。
notFound (404) captionNotFound 字幕トラックが見つかりませんでした。リクエストの id パラメータの値が正しいことを確認してください。

captions.insert

エラーのタイプ エラーの詳細 説明
badRequest (400) contentRequired リクエストに字幕トラックのコンテンツが含まれていません。
conflict (409) captionExists 指定された動画には、指定された snippet.languagesnippet.name の字幕トラックがすでに存在します。1 つの動画で同じ言語のトラックを複数使用することは可能ですが、各トラックに異なる名前を付ける必要があります。

エラーへの対処方法は複数あります。挿入する前に、既存のトラックを削除してから新しいトラックを挿入したり、新しいトラックの名前を変更したりできます。
forbidden (403) forbidden リクエストに関連付けられている権限では、字幕トラックをアップロードするには不十分です。リクエストが適切に認証されない可能性があります。
invalidValue (400) invalidMetadata リクエストに無効なメタデータ値が含まれているため、トラックを作成できません。リクエストで snippet.language プロパティ、snippet.name プロパティ、snippet.videoId プロパティに有効な値が指定されていることを確認します。snippet.isDraft プロパティを含めることもできますが、必須ではありません。
notFound (404) videoNotFound videoId パラメータによって識別される動画が見つかりませんでした。

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 リソースに関連する呼び出しへのレスポンスとして 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 そのリソースの 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 指定したチャネルのうち少なくとも 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 そのリソースの 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 指定したチャネルのうち少なくとも 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 次のフィルタのうち最大で 1 つを指定できます:idmySubscriberscategoryIdminemanagedByMeforUsernameonBehalfOfContentOwner パラメータによるコンテンツ所有者認証の場合は、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 localizations を更新するには、defaultLanguage を設定する必要があります。
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 ローカライズ オブジェクトに含まれる値の 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 指定された recentUploadedBy チャネル ID が見つかりませんでした。
notFound (404) unknownVideoId プロモート アイテムとして指定された動画 ID が見つかりません。
required (400) requiredItemIdType リクエスト メタデータでは、invideoPromotion 部分にアイテムタイプを指定する必要があります。
required (400) requiredItemId リクエスト メタデータでは、invideoPromotion 部分のアイテム ID を指定する必要があります。
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 リソースに関連する呼び出しへのレスポンスとして API から返されるエラー メッセージをまとめたものです。これらのメソッドは、一般的なエラーのセクションに記載されているエラーを返す場合もあります。

commentThreads.list

エラーのタイプ エラーの詳細 説明
badRequest (400) operationNotSupported ID フィルタは、Google+ に基づくコメントにのみ対応しています。
badRequest (400) processingFailure API サーバーがリクエストを正常に処理できませんでした。これは一時的なエラーの可能性がありますが、通常はリクエストの入力が無効であることを示します。リクエストの本文の commentThread リソースの構造を調べて、有効であることを確認します。
forbidden (403) commentsDisabled videoId パラメータで識別される動画でコメントが無効になっている。
forbidden (403) forbidden 十分な権限がないため、リクエストされた 1 つ以上のコメント スレッドを取得できません。リクエストが適切に認証されない可能性があります。
notFound (404) channelNotFound channelId パラメータまたは allThreadsRelatedToChannelId パラメータによって識別されるチャンネルが見つかりませんでした。
notFound (404) commentThreadNotFound 指定した 1 つ以上のコメント スレッドが見つかりません。リクエストの id パラメータの値が正しいことを確認してください。
notFound (404) videoNotFound videoId パラメータによって識別される動画が見つかりませんでした。

commentThreads.insert

エラーのタイプ エラーの詳細 説明
badRequest (400) channelOrVideoIdMissing 各コメント スレッドは、チャンネルまたは動画にリンクされている必要があります。
  • コメントがチャンネルに適用される場合は、リクエストの本文で指定したリソースで snippet.channelId プロパティの値が指定されていることを確認してください。チャンネルに対するコメントは、チャンネルの [ディスカッション] タブに表示されます。
  • コメントが動画に適用される場合は、リソースで 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 メソッドはサポートされなくなりました。

次の表は、comments リソースに関連する呼び出しへのレスポンスとして API から返されるエラー メッセージをまとめたものです。これらのメソッドは、一般的なエラーのセクションに記載されているエラーを返す場合もあります。

comments.list

エラーのタイプ エラーの詳細 説明
badRequest (400) operationNotSupported ID フィルタは Google+ に基づくコメントにのみ対応しています。
forbidden (403) forbidden 十分な権限がないため、リクエストされた 1 つ以上のコメントを取得できません。リクエストが適切に認証されない可能性があります。
notFound (404) commentNotFound 指定した 1 つ以上のコメントが見つかりません。リクエストの id パラメータと parentId パラメータの値が正しいことを確認してください。

comments.setModerationStatus

エラーのタイプ エラーの詳細 説明
badRequest (400) banWithoutReject banAuthor パラメータは、moderationStatus パラメータ値が rejected の場合にのみ使用できます。
badRequest (400) operationNotSupported Google+ に基づかないコメントについては、限定的な管理機能のみが提供されます。
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 更新できるのは Google+ ベースのコメントのみです。
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 を超えるチャンネルを指定している場合に発生します。

メンバーシップレベル

次の表は、members リソースに関連する呼び出しへのレスポンスとして API から返されるエラー メッセージをまとめたものです。これらのメソッドは、一般的なエラーのセクションに記載されているエラーを返す場合もあります。

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 このリクエストは、再生リスト アイテムの位置に無効な値またはサポートされていない値を設定しようとしています。リソースの snippetposition プロパティの値を確認します。
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 このリクエストは、再生リスト アイテムの位置に無効な値またはサポートされていない値を設定しようとしています。リソースの snippetposition プロパティの値を確認します。
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 localizations を更新するには、defaultLanguage を設定する必要があります。
badRequest (400) localizationValidationError ローカライズ オブジェクトに含まれる値の 1 つが検証で不合格になりました。playlists.list メソッドを使用して有効な値を取得し、再生リストのリソース ドキュメントのガイドラインに従って値を更新してください。
badRequest (400) maxPlaylistExceeded チャンネルの再生リストの数が上限に達しているため、再生リストを作成できません。
forbidden (403) playlistForbidden この操作は禁止されているか、リクエストが適切に認証されていません。
invalidValue (400) invalidPlaylistSnippet リクエストに指定されている再生リスト スニペットは無効です。
required (400) playlistTitleRequired リクエストでは、再生リストのタイトルを指定する必要があります。

playlists.update

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

サブスクリプション

次の表は、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 リソースに関連する呼び出しへのレスポンスとして 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 ユーザーがアップロードできる動画数を超えました。
forbidden (403) forbidden
forbidden (403) forbiddenLicenseSetting リクエストは、動画に無効なライセンスを設定しようとしています。
forbidden (403) forbiddenPrivacySetting リクエストは、動画に無効なプライバシー設定を指定しようとしています。

videos.list

エラーのタイプ エラーの詳細 説明
badRequest (400) videoChartNotFound リクエストされた動画チャートはサポートされていないか、使用できません。
forbidden (403) forbidden リクエストは適切に承認されず、動画ファイルへのアクセスや処理情報へのアクセスが許可されていません。fileDetailsprocessingDetailssuggestions の部分を使用できるのは、その動画の所有者のみです。
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 パラメータが無効な値に設定されています。