YouTube Data API - エラー

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

  1. 一般的なエラー
  2. activities
  3. channelBanners
  4. channels
  5. guideCategories
  6. playlistItems
  7. playlists
  8. search
  9. subscriptions
  10. thumbnails
  11. videoCategories
  12. 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 このリクエストは、再生リスト アイテムの位置に無効な値またはサポートされていない値を設定しようとしています。リソースの snippetposition プロパティの値を確認してください。
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 このリクエストは、再生リスト アイテムの位置に無効な値またはサポートされていない値を設定しようとしています。リソースの snippetposition プロパティの値を確認してください。
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 リソースに関連する呼び出しへの応答として 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 パラメータの値が正しいことを確認してください。