このドキュメントでは、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 ではサービス アカウントをサポートしていません。サービス アカウントを使用して認証しようとすると、このエラーが発生します。 youtubeSignupRequired エラーについては、Google アカウントのサポートを紹介する YouTube API のブログ投稿でも詳しく説明しています。このブログ記事では、API バージョン 2.1 でのエラーについて説明していますが、エラーの意味は現在でも変わっていません。 |
アクティビティ
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 パラメータが使用されていますが、適切に承認されていません。 |
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 オブジェクトの言語キーの 1 つが検証で不合格でした。channelSections.list メソッドを使用して有効な値を取得し、a href="/youtube/v3/docs/channelSections#resource">channelSections リソース ドキュメントのガイドラインに沿って値を更新します。 |
badRequest (400) |
notEditable |
このチャンネル セクションは作成できません。 |
badRequest (400) |
styleRequired |
channelSection リソースは、snippet.style フィールドの値を指定する必要があります。 |
badRequest (400) |
targetInvalidCountry |
targeting.countries リスト内の値の 1 つが検証で不合格でした。channelSections.list メソッドを使用して有効な値を取得し、a href="/youtube/v3/docs/channelSections#resource">channelSections リソース ドキュメントのガイドラインに沿って値を更新します。 |
badRequest (400) |
targetInvalidLanguage |
targeting.languages リスト内の値の 1 つが検証で不合格でした。channelSections.list メソッドを使用して有効な値を取得し、a href="/youtube/v3/docs/channelSections#resource">channelSections リソース ドキュメントのガイドラインに沿って値を更新します。 |
badRequest (400) |
targetInvalidRegion |
targeting.regions リスト内の値の 1 つが検証で不合格でした。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 オブジェクトの言語キーの 1 つが検証で不合格でした。channelSections.list メソッドを使用して有効な値を取得し、a href="/youtube/v3/docs/channelSections#resource">channelSections リソース ドキュメントのガイドラインに沿って値を更新します。 |
badRequest (400) |
notEditable |
このチャンネル セクションは編集できません。 |
badRequest (400) |
styleRequired |
channelSection リソースは、snippet.style フィールドの値を指定する必要があります。 |
badRequest (400) |
targetInvalidCountry |
targeting.countries リスト内の値の 1 つが検証で不合格でした。channelSections.list メソッドを使用して有効な値を取得し、a href="/youtube/v3/docs/channelSections#resource">channelSections リソース ドキュメントのガイドラインに沿って値を更新します。 |
badRequest (400) |
targetInvalidLanguage |
targeting.languages リスト内の値の 1 つが検証で不合格でした。channelSections.list メソッドを使用して有効な値を取得し、a href="/youtube/v3/docs/channelSections#resource">channelSections リソース ドキュメントのガイドラインに沿って値を更新します。 |
badRequest (400) |
targetInvalidRegion |
targeting.regions リスト内の値の 1 つが検証で不合格でした。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 パラメータで指定されたカテゴリが見つかりません。guideCategories.list メソッドを使用して、有効な値のリストを取得します。 |
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 |
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 |
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 |
指定された最近アップロードしたチャンネル 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 プロパティの値が正しいことを確認してください。 |
メンバー
次の表は、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 |
localizations を更新するには、defaultLanguage を設定する必要があります。 |
badRequest (400) |
localizationValidationError |
Localizations オブジェクトの値の 1 つが検証で不合格でした。playlists.list メソッドを使用して有効な値を取得し、playlists リソース ドキュメントのガイドラインに沿って値を更新するようにします。 |
badRequest (400) |
maxPlaylistExceeded |
チャンネルの再生リストの数が上限に達しているため、再生リストを作成できません。 |
forbidden (403) |
playlistForbidden |
この操作は禁止されているか、リクエストが適切に承認されていません。 |
invalidValue (400) |
invalidPlaylistSnippet |
リクエストに指定されている再生リスト スニペットは無効です。 |
required (400) |
playlistTitleRequired |
リクエストでは、再生リストのタイトルを指定する必要があります。 |
playlists.update
エラーのタイプ | エラーの詳細 | 説明 |
---|---|---|
badRequest (400) |
defaultLanguageNotSetError |
localizations を更新するには、defaultLanguage を設定する必要があります。 |
badRequest (400) |
localizationValidationError |
Localizations オブジェクトの値の 1 つが検証で不合格でした。playlists.list メソッドを使用して有効な値を取得し、playlists リソース ドキュメントのガイドラインに沿って値を更新するようにします。 |
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
次の表は、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 パラメータに無効な値が設定されています。 |
comments
comments.markAsSpam
メソッドはサポートされなくなりました。次の表は、
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
プロパティの値が正しいことを確認します。