YouTube Live Streaming API - Errors

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

fanFundingEvents（ファン ファンディング イベント）

次の表に、fanFundingEvents リソースに関連する呼び出しに応じて API から返されるエラー メッセージを示します。

fanFundingEvents.list

エラーのタイプ エラーの詳細 説明
forbidden (403) insufficientPermissions チャンネルの視聴者ファンディング イベントを表示するのに必要な権限がありません。
invalidValue (400) fanFundingNotEnabledForChannelId チャンネルで視聴者ファンディングが有効になっていない。

ライブ配信

次の表に、liveBroadcasts リソースに関連する呼び出しに応じて API から返されるエラー メッセージを示します。

liveBroadcasts.bind

エラーのタイプ エラーの詳細 説明
backendError internalError バインド中に内部エラーが発生しました。
forbidden (403) liveBroadcastBindingNotAllowed ライブ配信の現在のステータスでは、ストリームにバインドできません。
insufficientPermissions insufficientLivePermissions 要求されたライブ ブロードキャストを取得する権限がありません。詳細については、OAuth2 認証の実装をご覧ください。
insufficientPermissions liveStreamingNotEnabled リクエストを認証したユーザーで、YouTube でライブ動画をストリーミングできません。詳しくは、https://www.youtube.com/features をご覧ください。
notFound (404) liveBroadcastNotFound id パラメータで指定されたブロードキャストは存在しません。
notFound (404) liveStreamNotFound streamId パラメータで指定されたストリームは存在しません。
rateLimitExceeded userRequestsExceedRateLimit 特定の期間内にユーザーが送信したリクエストが多すぎます。
required (400) idRequired バインドするブロードキャストは、必須の id パラメータで識別する必要があります。

liveBroadcasts.delete

エラーのタイプ エラーの詳細 説明
forbidden (403) liveBroadcastDeletionNotAllowed ライブ配信の現在のステータスでは削除できません。
insufficientPermissions insufficientLivePermissions 指定されたライブ ブロードキャストを削除する権限がありません。詳細については、OAuth2 認証の実装をご覧ください。
insufficientPermissions liveStreamingNotEnabled リクエストを認証したユーザーで、YouTube でライブ動画をストリーミングできません。詳しくは、https://www.youtube.com/features をご覧ください。
notFound (404) liveBroadcastNotFound liveBroadcast リソースで指定された id プロパティがブロードキャストを識別しませんでした。

liveBroadcasts.insert

エラーのタイプ エラーの詳細 説明
insufficientPermissions insufficientLivePermissions リクエストにライブ ブロードキャストを作成する権限がありません。
insufficientPermissions livePermissionBlocked リクエストを承認したユーザーは、現時点では YouTube でライブ動画をストリーミングできません。ユーザーがライブ動画をストリーミングできない理由の詳細については、ユーザーのチャンネル設定（https://www.youtube.com/features）で確認できます。
insufficientPermissions liveStreamingNotEnabled リクエストを認証したユーザーで、YouTube でライブ動画をストリーミングできません。詳しくは、https://www.youtube.com/features をご覧ください。
invalidValue (400) invalidAutoStart liveBroadcast リソースに、contentDetails.enableAutoStart プロパティの無効な値が含まれていました。この設定に対応していないブロードキャストもあります。
invalidValue (400) invalidAutoStop liveBroadcast リソースに、contentDetails.enableAutoStop プロパティの無効な値が含まれていました。永続的なブロードキャストの enableAutoStop 設定は変更できません。
invalidValue (400) invalidDescription liveBroadcast リソースが、snippet.description プロパティの有効な値を指定していません。プロパティの値には 5,000 文字まで使用できます。
invalidValue (400) invalidEmbedSetting liveBroadcast リソースに、contentDetails.enable_embed プロパティの無効な値が含まれていました。このブロードキャストを埋め込むことはできません。
invalidValue (400) invalidLatencyPreferenceOptions liveBroadcast リソースに、contentDetails.latencyPreference プロパティの無効な値が含まれていました。このレイテンシ設定では、一部の設定はサポートされていません。
invalidValue (400) invalidPrivacyStatus liveBroadcast リソースに、status.privacy_status プロパティの無効な値が含まれていました。
invalidValue (400) invalidProjection liveBroadcast リソースに、contentDetails.projection プロパティの無効な値が含まれていました。デフォルトのブロードキャストの投影は 360 に設定できません。
invalidValue (400) invalidScheduledEndTime liveBroadcast リソースに、snippet.scheduledEndTime プロパティの無効な値が含まれていました。予定終了時間は、予定開始時刻に従う必要があります。
invalidValue (400) invalidScheduledStartTime liveBroadcast リソースに、snippet.scheduledStartTime プロパティの無効な値が含まれていました。予定の開始日時は、将来の配信スケジュールであって、その時間に確実に配信予定であった時点に近い値にする必要があります。
invalidValue (400) invalidTitle liveBroadcast リソースが、snippet.title プロパティの有効な値を指定していません。プロパティの値は 1 ～ 100 文字で指定してください。
limitExceeded userBroadcastsExceedLimit ユーザーが送信したライブ ブロードキャストやスケジュール済みのブロードキャストが多すぎるため、一部のブロードキャストを停止または削除する必要があります。
rateLimitExceeded userRequestsExceedRateLimit 特定の期間内にユーザーが送信したリクエストが多すぎます。
required (400) privacyStatusRequired liveBroadcast リソースでは、プライバシー ステータスを指定する必要があります。有効な privacyStatus 値をご確認ください。
required (400) scheduledEndTimeRequired liveBroadcast リソースに snippet.scheduledEndTime プロパティを指定する必要があります。
required (400) scheduledStartTimeRequired liveBroadcast リソースに snippet.scheduledStartTime プロパティを指定する必要があります。
required (400) titleRequired liveBroadcast リソースに snippet.title プロパティを指定する必要があります。

liveBroadcasts.list

エラーのタイプ エラーの詳細 説明
insufficientPermissions insufficientLivePermissions リクエストにライブ ブロードキャストを取得する権限がありません。
insufficientPermissions liveStreamingNotEnabled リクエストを認証したユーザーで、YouTube でライブ動画をストリーミングできません。詳しくは、https://www.youtube.com/features をご覧ください。

liveBroadcasts.transition

エラーのタイプ エラーの詳細 説明
backendError errorExecutingTransition ブロードキャストのステータスの変更中にエラーが発生しました。
forbidden (403) errorStreamInactive ブロードキャストにバインドされているストリームが無効な場合、リクエストされた遷移は許可されません。
forbidden (403) invalidTransition ライブ配信は現在のステータスからリクエストされたステータスに移行できません。
forbidden (403) redundantTransition ライブ配信が「リクエストされたステータス」または「リクエストされたステータス」に対してすでに処理中です。
insufficientPermissions insufficientLivePermissions リクエストには、ライブ ブロードキャストを移行する権限がありません。
insufficientPermissions livePermissionBlocked リクエストを承認したユーザーは、現時点では YouTube でライブ動画をストリーミングできません。ユーザーがライブ動画をストリーミングできない理由の詳細については、ユーザーのチャンネル設定（https://www.youtube.com/features）で確認できます。
insufficientPermissions liveStreamingNotEnabled リクエストを認証したユーザーで、YouTube でライブ動画をストリーミングできません。詳しくは、https://www.youtube.com/features をご覧ください。
notFound (404) liveBroadcastNotFound id パラメータで指定されたブロードキャストは存在しません。
rateLimitExceeded (403) userRequestsExceedRateLimit 特定の期間内にユーザーが送信したリクエストが多すぎます。
required (400) idRequired 必須の id パラメータでは、ステータスを移行するブロードキャストを識別する必要があります。
required (400) statusRequired API リクエストでは、status パラメータの値を指定する必要があります。

liveBroadcasts.update

エラーのタイプ エラーの詳細 説明
forbidden (403) closedCaptionsTypeModificationNotAllowed contentDetails.closedCaptionsType の値は、ブロードキャストのステータスが created または ready の場合にのみ変更できます。
forbidden (403) enableAutoStartModificationNotAllowed contentDetails.enableAutoStart の値は、ストリームが非アクティブで、ブロードキャストのステータスが created または ready の場合にのみ変更できます。
forbidden (403) enableClosedCaptionsModificationNotAllowed contentDetails.enableClosedCaptions 値は、ブロードキャストのステータスが created または ready の場合にのみ変更できます。
forbidden (403) enableDvrModificationNotAllowed contentDetails.enableDvr 値は、ブロードキャストのステータスが created または ready の場合にのみ変更できます。
forbidden (403) enableMonitorStreamModificationNotAllowed contentDetails.monitorStream.enableMonitorStream 値は、ブロードキャストのステータスが created または ready の場合にのみ変更できます。
forbidden (403) recordFromStartModificationNotAllowed contentDetails.recordFromStart 値は、ブロードキャストのステータスが created または ready の場合にのみ変更できます。
insufficientPermissions insufficientLivePermissions リクエストには、指定したライブ配信を更新する権限がありません。詳細については、OAuth2 認証の実装をご覧ください。
insufficientPermissions liveStreamingNotEnabled リクエストを認証したユーザーで、YouTube でライブ動画をストリーミングできません。詳しくは、https://www.youtube.com/features をご覧ください。
invalidValue (400) invalidAutoStart liveBroadcast リソースに、contentDetails.enableAutoStart プロパティの無効な値が含まれていました。永続的なブロードキャストの enableAutoStart 設定は変更できません。
invalidValue (400) invalidAutoStop liveBroadcast リソースに、contentDetails.enableAutoStop プロパティの無効な値が含まれていました。永続的なブロードキャストの enableAutoStop 設定は変更できません。
invalidValue (400) invalidDescription liveBroadcast リソースが、snippet.description プロパティの有効な値を指定していません。snippet.description には最大 5,000 文字を使用できます。
invalidValue (400) invalidEmbedSetting liveBroadcast リソースに、contentDetails.enable_embed プロパティの無効な値が含まれていました。このブロードキャストを埋め込むことはできません。
invalidValue (400) invalidEnableClosedCaptions liveBroadcast リソースの contentDetails.enableClosedCaptions プロパティの値が、contentDetails.closedCaptionType 設定の値と互換性がありません。2 つのプロパティのいずれか一方のみが含まれるようにリソースを変更してから、リクエストを再送信します。
invalidValue (400) invalidLatencyPreferenceOptions liveBroadcast リソースに、contentDetails.latencyPreference プロパティの無効な値が含まれていました。このレイテンシ設定では、一部の設定はサポートされていません。
invalidValue (400) invalidPrivacyStatus liveBroadcast リソースに有効なプライバシー ステータスが指定されていません。有効な privacyStatus 値をご確認ください。
invalidValue (400) invalidProjection liveBroadcast リソースに、contentDetails.projection プロパティの無効な値が含まれていました。永続的なブロードキャストの投影は 360 に設定できません。
invalidValue (400) invalidScheduledEndTime liveBroadcast リソースに、snippet.scheduledEndTime プロパティの無効な値が含まれていました。予定終了時間は、予定開始時刻に従う必要があります。
invalidValue (400) invalidScheduledStartTime liveBroadcast リソースに、snippet.scheduledStartTime プロパティの無効な値が含まれていました。予定の開始日時には、将来の日時を指定してください。
invalidValue (400) invalidTitle liveBroadcast リソースが、snippet.title プロパティの有効な値を指定していません。snippet.title は 1 ～ 100 文字の範囲で指定してください。
notFound (404) liveBroadcastNotFound liveBroadcast リソースで指定された id プロパティがブロードキャストを識別しませんでした。
required (400) broadcastStreamDelayMsRequired liveBroadcast リソースに contentDetails.monitorStream.broadcastStreamDelayMs プロパティが指定されていません。
required (400) enableMonitorStreamRequired liveBroadcast リソースに contentDetails.monitorStream.enableMonitorStream プロパティが指定されていません。
required (400) idRequired liveBroadcast リソースは、id プロパティの値を追加し、指定する必要があります。
required (400) privacyStatusRequired liveBroadcast リソースでプライバシー ステータスが指定されていませんでした。有効な privacyStatus 値をご覧ください。
required (400) scheduledEndTimeRequired liveBroadcast リソースに snippet.scheduledEndTime プロパティが指定されていません。
required (400) scheduledStartTimeRequired liveBroadcast リソースに snippet.scheduledStartTime プロパティが指定されていません。
required (400) titleRequired liveBroadcast リソースに snippet.title プロパティが指定されていません。

liveBroadcasts.cuepoint

エラーのタイプ エラーの詳細 説明
insufficientPermissions (403) insufficientLivePermissions ライブ ブロードキャストにキューポイントを挿入するリクエストは許可されていません。
insufficientPermissions (403) liveStreamingNotEnabled リクエストを認証したユーザーで、YouTube にライブ動画をストリーミングできません。詳しくは、https://support.google.com/youtube/answer/2474026 と https://www.youtube.com/features をご覧ください。
rateLimitExceeded (403) userRequestsExceedRateLimit 特定の期間内にユーザーが送信したリクエストが多すぎます。
required (400) idRequired 必須の id パラメータは、キューポイントを挿入するブロードキャストを識別する必要があります。
required (400) cueTypeRequired 必須の cueType フィールドは API リクエストの本文で指定する必要があります。
notFound (404) liveBroadcastNotFound id パラメータで指定されたブロードキャストは存在しません。
invalidValue (400) conflictingTimeFields insertionOffsetTimeMs と walltimeMs のどちらか一方のみを指定できます。両方の値を設定するとエラーになります。どちらの値も設定しない場合、YouTube はデフォルトの insertionOffsetTimeMs 時間（0）を使用します。つまり、キューポイントはできるだけ早く挿入されます。
invalidValue (400) invalidInsertionOffsetTimeMs cuepoint リソースに無効な insertionOffsetTimeMs プロパティ値が指定されています。値は 0 または正の整数にする必要があります。
invalidValue (400) invalidWalltimeMs cuepoint リソースに無効な walltimeMs プロパティ値が指定されています。値は、エポック タイムスタンプを表す整数にする必要があります。
backendError (5xx) serviceUnavailable サービスを利用できません。数分後にもう一度お試しください。

LiveChatBans

次の表に、liveChatBans リソースに関連する呼び出しに応じて API から返されるエラー メッセージを示します。

liveChatBans.delete

エラーのタイプ エラーの詳細 説明
forbidden (403) forbidden 指定した禁止は削除できません。このエラーは、あるモデレーターにより別のモデレーターによって参加禁止が解除されたリクエストが承認されると、発生する可能性があります。
forbidden (403) insufficientPermissions 指定した禁止を削除するために必要な権限がありません。
invalidValue (400) invalidLiveChatBanId id パラメータに無効な値が指定されています。
notFound (404) liveChatBanNotFound 指定した禁止が見つかりません。

liveChatBans.insert

エラーのタイプ エラーの詳細 説明
forbidden (403) insufficientPermissions 指定したチャットからユーザーを禁止するために必要な権限がありません。
forbidden (403) liveChatBanInsertionNotAllowed 指定した禁止を作成できません。このエラーは、そのリクエストがチャット オーナーや別のモデレーターの参加禁止を行おうとした場合に発生することがあります。
invalidValue (400) invalidChannelId 指定されたチャンネル ID が見つかりません。
invalidValue (400) invalidLiveChatId リクエストで指定された snippet.liveChatId 値は無効です。関連する liveBroadcast リソースをチェックして、正しい値であることを確認してください。
notFound (404) liveChatNotFound 指定されたチャットが見つかりません。関連する liveBroadcast リソースを調べて、snippet.liveChatId プロパティが正しい値に設定されていることを確認します。
notFound (404) liveChatUserNotFound 参加禁止のチャット ユーザーが見つかりません。
required (400) bannedUserChannelIdRequired リクエストの本文で送信する liveChatBan リソースは、snippet.bannedUserDetails.channelId プロパティの値を指定する必要があります。
required (400) liveChatIdRequired リクエストの本文で送信する liveChatBan リソースは、snippet.liveChatId プロパティの値を指定する必要があります。

チャット メッセージ

次の表に、liveChatMessages リソースに関連する呼び出しに応じて API から返されるエラー メッセージを示します。

liveChatMessages.delete

エラーのタイプ エラーの詳細 説明
forbidden (403) forbidden 指定したメッセージを削除するために必要な権限がありません。
forbidden (403) modificationNotAllowed 指定した liveChatMessage リソースは削除できません。id パラメータは、メッセージを削除できないモデレーターまたは別のユーザーによって作成されたメッセージを識別することがあります。
notFound (404) liveChatMessageNotFound 削除しようとしているメッセージが見つかりません。id パラメータの値が正しいことを確認してください。

liveChatMessages.insert

エラーのタイプ エラーの詳細 説明
forbidden (403) forbidden 指定したメッセージを作成するために必要な権限がありません。
forbidden (403) liveChatDisabled 指定されたチャットはオーナーが無効にしているため、チャットに追加することはできません。
forbidden (403) liveChatEnded 指定されたチャットはライブではなくなりました。
invalidValue (400) messageTextInvalid メッセージ テキスト（snippet.textMessageDetails.messageText）が無効です。
notFound (404) liveChatNotFound API リクエストで特定されたチャットが存在しません。このエラーは、オーナーによってチャットが削除された場合に発生します。
rateLimitExceeded rateLimitExceeded ユーザーが一定期間に投稿したチャット メッセージが多すぎる。
required (400) liveChatIdRequired liveChatMessage リソースには、snippet.liveChatId プロパティの値を設定し、指定する必要があります。
required (400) messageTextRequired liveChatMessage リソースには、snippet.textMessageDetails.messageText プロパティの値を設定し、指定する必要があります。
required (400) typeRequired liveChatMessage リソースには、snippet.type プロパティの値を設定し、指定する必要があります。パラメータ値を text に設定します。

liveChatMessages.list

エラーのタイプ エラーの詳細 説明
forbidden (403) forbidden 指定したチャットのメッセージを取得するために必要な権限がありません。
forbidden (403) liveChatDisabled 指定したブロードキャストではチャットが有効になっていません。
forbidden (403) liveChatEnded 指定されたチャットはライブではなくなりました。
notFound (404) liveChatNotFound 取得しようとしているチャットが見つかりません。リクエストの liveChatId パラメータの値が正しいことを確認してください。
rateLimitExceeded rateLimitExceeded 前回のリクエストの後にリクエストを迅速に送信しました。このエラーは、メッセージを取得するための API リクエストが YouTube のリフレッシュ レートよりも頻繁に送信され、不必要に帯域幅が浪費されている場合に発生します。

liveCuepoints

次の表に、liveCuepoints リソースに関連する呼び出しに応じて API から返されるエラー メッセージを示します。

liveCuepoints.insert

エラーのタイプ エラーの詳細 説明
invalidValue (400) conflictingTimeFields offsetTimeMs と walltime のどちらか一方のみを指定できます。

ライブ配信

次の表に、liveStreams リソースに関連する呼び出しに応じて API から返されるエラー メッセージを示します。

liveStreams.delete

エラーのタイプ エラーの詳細 説明
forbidden (403) liveStreamDeletionNotAllowed 指定したライブ ストリームは、まだ完了していないブロードキャストにバインドされているため削除できません。
insufficientPermissions insufficientLivePermissions 要求されたライブ ストリームを削除する権限がありません。詳細については、OAuth2 認証の実装をご覧ください。
insufficientPermissions liveStreamingNotEnabled リクエストを認証したユーザーで、YouTube でライブ動画をストリーミングできません。詳しくは、https://www.youtube.com/features をご覧ください。
notFound (404) liveStreamNotFound 指定されたライブ ストリームは存在しません。

liveStreams.insert

エラーのタイプ エラーの詳細 説明
insufficientPermissions insufficientLivePermissions 要求されたライブ ストリームを作成する権限がありません。
insufficientPermissions livePermissionBlocked リクエストを承認したユーザーは、現時点では YouTube でライブ動画をストリーミングできません。ユーザーがライブ動画をストリーミングできない理由の詳細については、ユーザーのチャンネル設定（https://www.youtube.com/features）で確認できます。
insufficientPermissions liveStreamingNotEnabled リクエストを認証したユーザーで、YouTube でライブ動画をストリーミングできません。詳しくは、https://www.youtube.com/features をご覧ください。
invalidValue (400) invalidDescription liveStream リソースの snippet.description プロパティの値は 10,000 文字以内です。
invalidValue (400) invalidFormat liveStream リソースの cdn.format プロパティの値が無効です。
invalidValue (400) invalidFrameRate liveStream リソースの cdn.frameRate プロパティの値が無効です。
invalidValue (400) invalidIngestionType liveStream リソースの cdn.ingestionType プロパティの値が無効です。
invalidValue (400) invalidResolution liveStream リソースの cdn.resolution プロパティの値が無効です。
invalidValue (400) invalidTitle liveStream リソースの snippet.title プロパティの値は 1 ～ 128 文字にする必要があります。
rateLimitExceeded userRequestsExceedRateLimit 特定の期間内にユーザーが送信したリクエストが多すぎます。
required (400) cdnRequired liveStream リソースには、cdn オブジェクトを含める必要があります。
required (400) frameRateRequired cdn.resolution プロパティに値を指定しても、cdn.frameRate プロパティの値を指定しない場合、API からこのエラーが返されます。
required (400) ingestionTypeRequired liveStream リソースは、cdn.ingestionType プロパティの値を指定する必要があります。
required (400) resolutionRequired cdn.frameRate プロパティに値を指定しても、cdn.resolution プロパティの値を指定しない場合、API からこのエラーが返されます。
required (400) titleRequired liveStream リソースは、snippet.title プロパティの値を指定する必要があります。

liveStreams.list

エラーのタイプ エラーの詳細 説明
insufficientPermissions insufficientLivePermissions 要求されたライブ ストリームを取得する権限がありません。
insufficientPermissions liveStreamingNotEnabled リクエストを認証したユーザーで、YouTube でライブ動画をストリーミングできません。詳しくは、https://www.youtube.com/features をご覧ください。

liveStreams.update

エラーのタイプ エラーの詳細 説明
forbidden (403) liveStreamModificationNotAllowed 指定したライブ ストリームを現在の状態で変更することはできません。詳細については、ブロードキャストのライフサイクルをご覧ください。
forbidden (403) liveStreamModificationNotAllowed API では、ストリームの作成後に cdn.format、cdn.frameRate、cdn.ingestionType、cdn.resolution フィールドの値を変更することはできません。
forbidden (403) liveStreamModificationNotAllowed API では、再利用可能なストリームを再利用できないストリームに変更することや、その逆を行うことはできません。詳しくは、ブロードキャストとストリームについてをご覧ください。
insufficientPermissions insufficientLivePermissions 要求されたライブ ストリームを更新する権限がありません。詳細については、OAuth2 認証の実装をご覧ください。
insufficientPermissions liveStreamingNotEnabled リクエストを認証したユーザーで、YouTube でライブ動画をストリーミングできません。詳しくは、https://www.youtube.com/features をご覧ください。
invalidValue (400) invalidDescription liveStream リソースの snippet.description プロパティの値は 10,000 文字以内で指定できます。
invalidValue (400) invalidTitle liveStream リソースの snippet.title プロパティの値は、1 ～ 128 文字にする必要があります。
notFound (404) liveStreamNotFound 指定されたライブ ストリームは存在しません。
required (400) idRequired liveStream リソースには、id プロパティの値を指定する必要があります。
required (400) ingestionTypeRequired liveStream リソースには、cdn.ingestionType プロパティの値を指定する必要があります。
required (400) titleRequired liveStream リソースには、snippet.title プロパティの値を指定する必要があります。

スポンサー

次の表に、sponsors リソースに関連する呼び出しに応じて API から返されるエラー メッセージを示します。

sponsors.list

エラーのタイプ エラーの詳細 説明
forbidden (403) insufficientPermissions チャンネルのスポンサーを表示するために必要な権限がありません。
invalidValue (400) invalidValueInRequest リクエストに無効な値が含まれています。
invalidValue (400) sponsorshipNotEnabledForChannelId チャンネルのスポンサーシップが有効になっていません。