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 |
リソースの 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 つ指定できます。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 |
リクエストのメタデータで、動画内プロモーションのタイミング オフセットが無効です。 |
badRequest (400) |
invalidTimingOffset |
リクエスト メタデータが、動画プレーヤーにプロモート アイテムを表示するタイミングを決定するために指定しているタイミング オフセットが無効です。リクエストが送信したリソースの invideoPromotion.timing.offsetMs プロパティの値を確認します。 |
badRequest (400) |
invalidTimingType |
リクエスト メタデータが、動画プレーヤーにプロモート アイテムを表示するタイミングを決定するために指定しているタイミング メソッドが無効です。リクエストが送信したリソースの invideoPromotion.timing.type プロパティの値を確認します。 |
badRequest (400) |
localizationValidationError |
ローカライズ オブジェクトの値のいずれかが検証に失敗しました。channels.list メソッドを使用して有効な値を取得し、チャンネル リソースのドキュメントのガイドラインに沿って更新してください。 |
badRequest (400) |
tooManyPromotedItems |
invideoPromotion 部分で、許可されているプロモーション アイテムの数を超えています。 |
forbidden (403) |
channelForbidden |
id パラメータで指定されたチャネルがリクエストをサポートしていないか、リクエストが適切に承認されていません。 |
forbidden (403) |
promotedVideoNotAllowed |
API リクエストが更新しようとしているチャンネルが見つかりません。リクエストが送信した channel リソースの id プロパティの値を確認して、チャンネル ID が正しいことを確認します。 |
forbidden (403) |
websiteLinkNotAllowed |
指定されたウェブサイトの 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 プロパティの値を設定します。 |
メンバー
次の表に、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
次の表に、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 |
このリクエストは、再生リスト アイテムの位置に無効な値またはサポートされていない値を設定しようとしています。リソースの 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 |
ローカライズ オブジェクトの値のいずれかが検証に失敗しました。playlists.list メソッドを使用して有効な値を取得し、再生リスト リソースのドキュメントのガイドラインに沿って更新してください。 |
badRequest (400) |
maxPlaylistExceeded |
チャンネルに作成できるプレイリストの最大数に達しているため、プレイリストを作成できません。 |
forbidden (403) |
playlistForbidden |
このオペレーションは禁止されているか、リクエストが適切に承認されていません。 |
invalidValue (400) |
invalidPlaylistSnippet |
リクエストに指定されている再生リスト スニペットは無効です。 |
required (400) |
playlistTitleRequired |
リクエストでは、再生リストのタイトルを指定する必要があります。 |
playlists.update
エラーのタイプ |
エラーの詳細 |
説明 |
badRequest (400) |
defaultLanguageNotSetError |
defaultLanguage は localizations を更新するように設定する必要があります。 |
badRequest (400) |
localizationValidationError |
ローカライズ オブジェクトの値のいずれかが検証に失敗しました。playlists.list メソッドを使用して有効な値を取得し、再生リスト リソースのドキュメントのガイドラインに沿って更新してください。 |
forbidden (403) |
playlistForbidden |
このオペレーションは禁止されているか、リクエストが適切に承認されていません。 |
invalidValue (400) |
invalidPlaylistSnippet |
リクエストに指定されている再生リスト スニペットは無効です。 |
invalidValue (400) |
playlistOperationUnsupported |
API では、指定したプレイリストを更新することはできません。たとえば、アップロードした動画の再生リストのプロパティは更新できません。 |
notFound (404) |
playlistNotFound |
リクエストの id パラメータで指定された再生リストが見つかりません。 |
required (400) |
playlistTitleRequired |
リクエストでは、再生リストのタイトルを指定する必要があります。 |
検索
次の表に、search
リソースに関連する呼び出しに応じて API が返すエラー メッセージを示します。これらのメソッドは、一般的なリクエスト エラー セクションに記載されているエラーを返すこともあります。
search.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 |
ユーザーがアップロードできる動画の数を超えています。 |
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 パラメータが無効な値に設定されている可能性があります。 |
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-10-06 UTC。
[[["わかりやすい","easyToUnderstand","thumb-up"],["問題の解決に役立った","solvedMyProblem","thumb-up"],["その他","otherUp","thumb-up"]],[["必要な情報がない","missingTheInformationINeed","thumb-down"],["複雑すぎる / 手順が多すぎる","tooComplicatedTooManySteps","thumb-down"],["最新ではない","outOfDate","thumb-down"],["翻訳に関する問題","translationIssue","thumb-down"],["サンプル / コードに問題がある","samplesCodeIssue","thumb-down"],["その他","otherDown","thumb-down"]],["最終更新日 2025-10-06 UTC。"],[],["API errors include `forbidden (403)` for access or quota issues, and `notFound (404)` for missing resources. `badRequest (400)` signals invalid parameters or missing data. `unauthorized (401)` means proper authorization is missing. Actions like `insert`, `update`, `delete`, `list` and `rate` are subject to errors, such as invalid input, authorization failures, or resource unavailability. Operations involving channels, captions, playlists, comments, videos, and subscriptions have specific error conditions, like duplicate entries or channel/video not found. Error descriptions often indicate necessary parameter corrections or authorization requirements.\n"]]
コメント
次の表に、
comments
リソースに関連する呼び出しに応じて API が返すエラー メッセージを示します。これらのメソッドは、一般的なリクエスト エラー セクションに記載されているエラーを返すこともあります。comments.list
badRequest (400)
operationNotSupported
forbidden (403)
forbidden
notFound (404)
commentNotFound
id
パラメータとparentId
パラメータの値を確認して、正しいことを確認します。comments.setModerationStatus
badRequest (400)
banWithoutReject
banAuthor
パラメータは、moderationStatus
パラメータの値がrejected
の場合にのみ使用できます。badRequest (400)
operationNotSupported
badRequest (400)
processingFailure
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
snippet.parentId
プロパティで識別されるトップレベルのコメントへの返信としてコメントを挿入できません。commentThread
リソースのsnippet.canReply
プロパティは、現在の閲覧者がスレッドに返信できるかどうかを示します。badRequest (400)
parentCommentIsPrivate
badRequest (400)
parentIdMissing
comment
リソースでsnippet.parentId
プロパティの値が指定されていませんでした。badRequest (400)
processingFailure
comment
リソースの構造をチェックして、有効であることを確認します。forbidden (403)
forbidden
forbidden (403)
ineligibleAccount
notFound (404)
parentCommentNotFound
snippet.parentId
プロパティの値を確認して、正しいことを確認します。comments.delete
badRequest (400)
processingFailure
forbidden (403)
forbidden
notFound (404)
commentNotFound
id
パラメータの値を確認して、正しいことを確認します。comments.update
badRequest (400)
commentTextTooLong
comment
リソースのsnippet.textOriginal
プロパティの文字数が多すぎます。badRequest (400)
invalidCommentMetadata
badRequest (400)
operationNotSupported
badRequest (400)
processingFailure
comment
リソースの構造をチェックして、有効であることを確認します。forbidden (403)
forbidden
forbidden (403)
ineligibleAccount
notFound (404)
commentNotFound
id
プロパティの値を確認して、正しいことを確認します。