YouTube Data API - エラー

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

一般的なエラー
activities
channelBanners
channels
guideCategories
playlistItems
playlists
search
subscriptions
thumbnails
videoCategories
videos

一般的なエラー

以下の表に、特定の API メソッド固有ではない API エラーメッセージをまとめます。

`Core API errors`

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

`Common request errors`

エラータイプ	エラーの詳細	説明
`badRequest`	`incompatibleParameters`	リクエストに 1 つのリクエストでは同時に使用できないパラメータが複数指定されています。
`badRequest`	`invalidFilters`	リクエストに無効なフィルタパラメータが指定されています。
`badRequest`	`invalidPageToken`	リクエストに無効なページトークンが指定されています。
`badRequest`	`missingRequiredParameter`	リクエストに必要なパラメータがありません。
`badRequest`	`unexpectedParameter`	リクエストに想定外のパラメータが指定されています。
`forbidden`	`accountDelegationForbidden`	この認証済みユーザーは、指定された Google アカウントに代わって操作を実行することはできません。
`forbidden`	`authenticatedUserAccountClosed`	認証済みユーザーの YouTube アカウントは閉じられています。この認証済みユーザーが別の Google アカウントに代わって操作を実行している場合、このエラーの対象は Google アカウントになります。
`forbidden`	`authenticatedUserAccountSuspended`	認証済みユーザーの YouTube アカウントは一時停止されています。この認証済みユーザーが別の Google アカウントに代わって操作を実行している場合、このエラーの対象は Google アカウントになります。
`forbidden`	`authenticatedUserNotChannel`	このリクエストでは、認証済みユーザーがチャンネルを決定する必要がありますが、決定されていません。認証されたリクエストが `onBehalfOfContentOwner` 委任パラメータを使用している場合は、`onBehalfOfContentOwnerChannel` パラメータの設定も必要です。
`forbidden`	`channelClosed`	リクエストで特定されているチャンネルは閉じられています。
`forbidden`	`channelNotFound`	リクエストで特定されているチャンネルは見つかりません。
`forbidden`	`channelSuspended`	リクエストで特定されているチャンネルは中断されています。
`forbidden`	`cmsUserAccountNotFound`	その CMS ユーザーは、指定されたコンテンツの所有者に代わって操作を実行することを許可されていません。
`forbidden`	`insufficientCapabilities`	その CMS ユーザーの能力は十分ではありません。
`notFound`	`contentOwnerAccountNotFound`	指定されたコンテンツの所有者アカウントが見つかりませんでした。

`Request context errors`

エラータイプ	エラーの詳細	説明
`badRequest`	`invalidLanguage`	`hl` パラメータに指定された値は、有効な言語コードではありません。
`badRequest`	`invalidMine`	そのリクエストでの `mine` パラメータの使用はサポートされていません。
`badRequest`	`invalidPart`	リクエストの `part` パラメータに、同時に書き込むことのできない複数の部分が指定されています。
`badRequest`	`invalidRegionCode`	`regionCode` パラメータに無効な地域コードが指定されています。
`badRequest`	`unexpectedPart`	リクエストの `part` パラメータに想定外の値が指定されています。
`badRequest`	`unknownPart`	リクエストの `part` パラメータに未知の値が指定されています。
`badRequest`	`unsupportedLanguageCode`	`hl` パラメータに指定された値は、サポートされている言語コードではありません。
`badRequest`	`unsupportedRegionCode`	`regionCode` パラメータにサポートされていない地域コードが指定されています。
`unauthorized`	`authorizationRequired`	リクエストに `mine` パラメータが使用されていますが、このリクエストは適切に認証されていません。
`unauthorized`	`youtubeSignupRequired`	このエラーは、ユーザーの Google アカウントのリンクが解除されていることを示します。つまり、このユーザーは Google アカウントは持っていますが、YouTube チャンネルは持っていません。このようなユーザーは、動画の評価や `watch_later` 再生リストへの動画の追加など、ユーザー認証が必要な機能にはアクセスできます。しかし、たとえば、動画をアップロードするには、YouTube チャンネルが必要です。Gmail アカウントまたは Android デバイスを持っているユーザーは確実に Google アカウントを持っていますが、その Google アカウントがまだ YouTube のチャンネルにリンクされていない可能性はあります。これは、OAuth 2.0 Service Account フローを使おうとしたときによく見られるエラーです。YouTube では Service Account はサポートされていないため、Service Account を使って認証しようとすると、このエラーが表示されます。 `youtubeSignupRequired` エラーの詳細は、Google アカウントのサポートを紹介している YouTube の API ブログ記事でも説明されています。このブログ記事では、API バージョン 2.1 でのエラーについて説明していますが、エラーの意味は現在でも変わっていません。

activities

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

`activities.list`

エラータイプ	エラーの詳細	説明
`notFound`	`channelNotFound`	リクエストの `channelId` パラメータで特定されているチャンネル ID が見つかりません。
`notFound`	`homeChannelNotFound`	現在認証されているユーザーの YouTube のトップページフィードが見つかりません。
`unauthorized`	`authorizationRequired`	リクエストに `home` パラメータが使用されていますが、このリクエストは適切に認証されていません。

`activities.insert`

エラータイプ	エラーの詳細	説明
`badRequest`	`bulletinTextRequired`	お知らせメッセージの投稿にテキストを指定するには、リクエストで `snippet` オブジェクトの `description` プロパティを使用する必要があります。
`notFound`	`playlistNotFound`	お知らせメッセージの投稿と動画を関連付けようとしていますが、その動画が見つかりません。`contentDetails.bulletinPosted.playlistId` プロパティの値を確認してください。
`notFound`	`videoNotFound`	お知らせメッセージの投稿と動画を関連付けようとしていますが、その動画が見つかりません。`contentDetails.bulletinPosted.videoId` プロパティの値を確認してください。
`userRateLimitExceeded`	`rateLimitExceeded`	リクエストを完了できません。既に割り当てを超えています。

channelBanners

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

`channelBanners.insert`

エラータイプ	エラーの詳細	説明
`badRequest`	`mediaBodyRequired`	リクエストには、画像コンテンツは含まれていません。

channels

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

`channels.list`

エラータイプ	エラーの詳細	説明
`forbidden`	`channelForbidden`	`id` パラメータで指定されたチャンネルは、リクエストをサポートしていません。または、リクエストが適切に認証されていません。
`notFound`	`categoryNotFound`	`categoryId` パラメータにより特定されているカテゴリが見つかりません。guideCategories.list メソッドを使用して、有効な値のリストを取得してください。
`notFound`	`channelNotFound`	`id` パラメータで指定されたチャンネルが見つかりません。

`channels.update`

エラータイプ	エラーの詳細	説明
`badRequest`	`brandingValidationError`	`brandingSettings` オブジェクトに、検証できない値が含まれています。`channels.list` メソッドを使用して、このチャンネルに対して既に行われている設定を取得し、`channels` リソースドキュメントのガイドラインに沿って、プロパティの値を更新してください。
`badRequest`	`invalidBrandingOption`	指定したブランド設定のいずれかが存在しません。`channels.list` メソッドを使用して、有効な値を取得し、`channels` リソースドキュメントのガイドラインに沿って、設定を必ず更新してください。
`badRequest`	`invalidCornerPosition`	プロモートアイテムの表示位置を特定するための、リクエストメタデータにより指定されているコーナー位置が無効です。このリクエストにより送信されたリソースの `invideoPromotion.position.cornerPosition` プロパティの値を確認してください。
`badRequest`	`invalidItemType`	リクエストメタデータにより、invideoPromotion 部に指定されたアイテムタイプが無効です。このリクエストにより送信されたリソースの `invideoPromotion.items[].type` プロパティの値を確認してください。
`badRequest`	`invalidPositionOffset`	動画プレーヤーでのプロモートアイテムの配置方法を決定するための、リクエストメタデータにより指定されている位置タイプが無効です。このリクエストにより送信されたリソースの `invideoPromotion.position.type` プロパティの値を確認してください。
`badRequest`	`invalidTimingOffset`	リクエストメタデータが、動画プレーヤーにプロモートアイテムを表示するタイミングを決定するために指定しているタイミングオフセットが無効です。このリクエストにより送信されたリソースの `invideoPromotion.timing.offsetMs` プロパティの値を確認してください。
`badRequest`	`invalidTimingType`	リクエストメタデータが、動画プレーヤーにプロモートアイテムを表示するタイミングを決定するために指定しているタイミングメソッドが無効です。このリクエストにより送信されたリソースの `invideoPromotion.timing.type` プロパティの値を確認してください。
`forbidden`	`channelForbidden`	`id` パラメータで指定されたチャンネルは、リクエストをサポートしていません。またはリクエストが適切に認証されていません。
`notFound`	`channelNotFound`	`id` パラメータで指定されたチャンネルが見つかりません。または、このチャンネルにはブランドオプションがありません。
`notFound`	`unknownChannelId`	API リクエストが更新しようとしているチャンネルが見つかりません。このリクエストが送信した `channel` リソースの `id` プロパティの値をチェックして、チャンネル ID が正しいことを確認してください。
`notFound`	`unknownVideoId`	プロモートアイテムとして指定された動画 ID が見つかりません。
`required`	`requiredCornerPosition`	リクエストメタデータでコーナーの位置を指定して、プレーヤー内のプロモートアイテムが表示される場所を YouTube が判断できるようにする必要があります。このリクエストが送信するリソースの `invideoPromotion.position.cornerPosition` プロパティの値を設定してください。
`required`	`requiredItemType`	リクエストメタデータで、プロモートアイテムのタイプを指定する必要があります。このリクエストが送信するリソースの `invideoPromotion.items[].type` プロパティの値を設定してください。
`required`	`requiredPositionOffset`	リクエストメタデータで位置タイプを指定して、プロモートアイテムの表示方法を YouTube が判断できるようにする必要があります。このリクエストが送信するリソースの `invideoPromotion.position.type` プロパティの値を設定してください。
`required`	`requiredTimingOffset`	リクエストメタデータでタイミングオフセットを指定して、プロモートアイテムを表示するタイミングを YouTube が判断できるようにする必要があります。このリクエストが送信するリソースの `invideoPromotion.timing.offsetMs` プロパティの値を設定してください。
`required`	`requiredTimingType`	リクエストメタデータでタイミングメソッドを指定して、プロモートアイテムを表示するタイミングを YouTube が判断できるようにする必要があります。このリクエストが送信するリソースの `invideoPromotion.timing.type` プロパティの値を設定してください。
`required`	`requiredVideoId`	リクエストメタデータは動画 ID を指定して、プロモートアイテムを特定する必要があります。

guideCategories

以下の表に、guideCategories リソースに関連する呼び出しへの応答として API から表示されるエラーメッセージをまとめます。これらのメソッドから、一般的なエラーのセクションに記載されているエラーが表示されることもあります。

`guideCategories.list`

エラータイプ	エラーの詳細	説明
`notFound`	`notFound`	`id` パラメータにより特定されるガイドカテゴリは見つかりません。guideCategories.list メソッドを使用して、有効な値のリストを取得してください。

playlistItems

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

`playlistItems.delete`

エラータイプ	エラーの詳細	説明
`forbidden`	`playlistItemsNotAccessible`	リクエストは適切に認証されていないため、指定された再生リストアイテムを削除できません。
`notFound`	`playlistItemNotFound`	リクエストの `id` パラメータで特定される再生リストアイテムが見つかりません。

`playlistItems.insert`

エラータイプ	エラーの詳細	説明
`duplicate`	`videoAlreadyInPlaylist`	再生リストに追加しようとしている動画は既に再生リストに登録されています。
`forbidden`	`playlistContainsMaximumNumberOfVideos`	再生リスト内のアイテム数は、既に許容されている最大数に達しています。
`invalidValue`	`invalidPlaylistItemPosition`	このリクエストは、再生リストアイテムの位置に無効な値またはサポートされていない値を設定しようとしています。リソースの `snippet` で `position` プロパティの値を確認してください。
`invalidValue`	`invalidResourceType`	リソース ID に指定された `type` は、この操作ではサポートされていません。リソース ID は、再生リストに追加するアイテムを特定します（例: `youtube#video`）。
`notFound`	`playlistNotFound`	リクエストの `playlistId` パラメータで特定される再生リストが見つかりません。
`notFound`	`videoNotFound`	再生リストに追加しようとしている動画は見つかりません。`videoId` プロパティの値が正しいことを確認してください。
`required`	`channelIdRequired`	リクエストには、必須プロパティ `channelId` の値が指定されていません。
`required`	`playlistIdRequired`	リクエストには、必須プロパティ `playlistId` の値が指定されていません。
`required`	`resourceIdRequired`	このリクエストには、`snippet` オブジェクトが `resourceId` を指定しているリソースが含まれていなければなりません。

`playlistItems.list`

エラータイプ	エラーの詳細	説明
`forbidden`	`playlistItemsNotAccessible`	リクエストは適切に認証されていないため、指定された再生リストを取得できません。
`notFound`	`playlistNotFound`	リクエストの `playlistId` パラメータで特定される再生リストが見つかりません。
`notFound`	`videoNotFound`	リクエストの `videoId` パラメータで特定される動画が見つかりません。
`required`	`playlistIdRequired`	このチャンネル登録リクエストでは、必須プロパティ `playlistId` の値が指定されていません。

`playlistItems.update`

エラータイプ	エラーの詳細	説明
`invalidValue`	`invalidPlaylistItemPosition`	このリクエストは、再生リストアイテムの位置に無効な値またはサポートされていない値を設定しようとしています。リソースの `snippet` で `position` プロパティの値を確認してください。
`invalidValue`	`invalidResourceType`	リソース ID に指定された `type` は、この操作ではサポートされていません。リソース ID は、再生リストに追加するアイテムを特定します（例: `youtube#video`）。
`invalidValue`	`invalidSnippet`	このリクエストでは、有効な `snippet` プロパティが指定されていません。
`notFound`	`playlistItemNotFound`	リクエストの `id` プロパティで特定される再生リストアイテムが見つかりません。
`notFound`	`playlistNotFound`	リクエストの `playlistId` パラメータで特定される再生リストが見つかりません。
`required`	`channelIdRequired`	リクエストには、必須プロパティ `channelId` の値が指定されていません。
`required`	`playlistIdRequired`	リクエストには、必須プロパティ `playlistId` の値が指定されていません。
`required`	`playlistItemIdRequired`	リクエストで指定された再生リストアイテムリソースは、`id` プロパティを使用して、更新する再生リストアイテムを特定する必要があります。

playlists

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

`playlists.delete`

エラータイプ	エラーの詳細	説明
`notFound`	`playlistNotFound`	リクエストの `id` パラメータで特定される再生リストが見つかりません。

`playlists.insert`

エラータイプ	エラーの詳細	説明
`invalidValue`	`invalidPlaylistSnippet`	リクエストに指定されている再生リストスニペットは無効です。
`required`	`playlistTitleRequired`	リクエストでは、再生リストのタイトルを指定する必要があります。

`playlists.update`

エラータイプ	エラーの詳細	説明
`invalidValue`	`invalidPlaylistSnippet`	リクエストに指定されている再生リストスニペットは無効です。
`notFound`	`playlistNotFound`	リクエストの `id` パラメータで特定される再生リストが見つかりません。
`required`	`playlistTitleRequired`	リクエストでは、再生リストのタイトルを指定する必要があります。

search

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

`search.list`

エラータイプ	エラーの詳細	説明
`badRequest`	`invalidSearchFilter`	リクエストに含まれている検索フィルタ、または制限、もしくはこの両方の組み合わせが無効です。
`badRequest`	`invalidVideoId`	`relatedToVideo` パラメータに指定されている動画 ID が無効です。

subscriptions

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

`subscriptions.delete`

エラータイプ	エラーの詳細	説明
`badRequest`	`accountClosed`	チャンネル登録を作成しようとしているアカウントは閉じられています。
`badRequest`	`accountSuspended`	チャンネル登録を作成しようとしているアカウントは一時停止されています。
`forbidden`	`subscriptionForbidden`	リクエストが適切に認証されていないか、このチャンネルではサポートされていません。
`notFound`	`subscriptionNotFound`	削除しようとしているチャンネル登録が見つかりません。リクエストの `id` パラメータの値が正しいことを確認してください。

`subscriptions.insert`

エラータイプ	エラーの詳細	説明
`badRequest`	`accountClosed`	チャンネル登録を作成しようとしているアカウントは閉じられています。
`badRequest`	`accountSuspended`	チャンネル登録を作成しようとしているアカウントは一時停止されています。
`badRequest`	`subscriptionDuplicate`	作成しようとしているチャンネル登録は既に存在しています。
`forbidden`	`subscriptionForbidden`	リクエストが適切に認証されていないか、このチャンネルではサポートされていません。
`notFound`	`publisherNotFound`	リクエストの `snippet.resourceId` プロパティで指定されたリソースが見つかりません。
`notFound`	`subscriberNotFound`	リクエストで特定されているチャンネル登録者が見つかりません。
`required`	`publisherRequired`	リクエストで指定されたチャンネル登録リソースは、`snippet.resourceId` プロパティを使用して、登録するチャンネルを特定する必要があります。

`subscriptions.list`

エラータイプ	エラーの詳細	説明
`forbidden`	`accountClosed`	チャンネル登録者のアカウントが閉じられているため、チャンネル登録を取得できませんでした。
`forbidden`	`accountSuspended`	チャンネル登録者のアカウントが一時停止されているため、チャンネル登録を取得できませんでした。
`forbidden`	`subscriptionForbidden`	リクエスト送信者は、リクエストしたチャンネル登録へのアクセスを許可されていません。
`notFound`	`subscriberNotFound`	リクエストで特定されているチャンネル登録者が見つかりません。

thumbnails

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

`thumbnails.set`

エラータイプ	エラーの詳細	説明
`badRequest`	`mediaBodyRequired`	リクエストには、画像コンテンツは含まれていません。
`forbidden`	`forbidden`	この認証済みユーザーには、カスタムの動画のサムネイルをアップロードし、設定する権限がありません。
`forbidden`	`forbidden`	指定された動画には、サムネイルを設定できません。リクエストが適切に認証されていない可能性があります。
`notFound`	`videoNotFound`	サムネイル画像の挿入先動画が見つかりません。リクエストの `videoId` パラメータの値が正しいことを確認してください。

videoCategories

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

`videoCategories.list`

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

videos

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

`videos.insert`

エラータイプ	エラーの詳細	説明
`badRequest`	`invalidCategoryId`	`snippet.categoryId` プロパティで指定されたカテゴリ ID は無効です。`videoCategories.list` メソッドを使用して、サポートされているカテゴリを取得してください。
`badRequest`	`invalidDescription`	リクエストメタデータで指定された動画の説明は無効です。
`badRequest`	`invalidFilename`	`Slug` ヘッダーで指定された動画ファイル名は無効です。
`badRequest`	`invalidRecordingDetails`	リクエストメタデータの `recordingDetails` オブジェクトで指定された録画の詳細は無効です。
`badRequest`	`invalidTags`	リクエストメタデータで指定された動画のキーワードは無効です。
`badRequest`	`invalidTitle`	リクエストメタデータで指定された動画のタイトルは無効です。
`badRequest`	`invalidVideoGameRating`	リクエストメタデータで指定されたビデオゲームの評価は無効です。
`badRequest`	`invalidVideoMetadata`	リクエストメタデータが無効です。
`badRequest`	`mediaBodyRequired`	リクエストに動画コンテンツが含まれていません。
`forbidden`	`forbiddenLicenseSetting`	リクエストは、動画に無効なライセンスを設定しようとしています。
`forbidden`	`forbiddenPrivacySetting`	リクエストは、動画に無効なプライバシー設定を指定しようとしています。

`videos.list`

エラータイプ	エラーの詳細	説明
`badRequest`	`videoChartNotFound`	リクエストされた動画チャートはサポートされていないか、使用できません。
`forbidden`	`forbidden`	リクエストは、ユーザー評価情報にアクセスできません。このエラーは、リクエストが適切に認証されていないため、`myRating` パラメータを使用できない場合に発生することがあります。

`videos.delete`

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

`videos.update`

エラータイプ	エラーの詳細	説明
`badRequest`	`invalidRequest`	リクエストメタデータが無効です。
`forbidden`	`forbidden`
`forbidden`	`forbiddenLicenseSetting`	リクエストは、動画に無効なライセンスを設定しようとしています。
`forbidden`	`forbiddenPrivacySetting`	リクエストは、動画に無効なプライバシー設定を指定しようとしています。
`notFound`	`videoNotFound`	更新しようとしている動画は見つかりません。リクエストの本文にある `id` フィールドの値が正しいことを確認してください。

`videos.rate`

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