YouTube Live Streaming API - Errors

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

liveBroadcasts

次の表に、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 のいずれか 1 つのみを指定できます。両方の値を設定すると、エラーが発生します。どちらの値も設定しない場合、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 指定された禁止措置は削除できません。このエラーは、別の管理者の禁止を解除しようとしている 1 人の管理者がリクエストを承認した場合に発生することがあります。
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

次の表に、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 の更新頻度よりも頻繁に送信され、帯域幅が無駄になっている場合に発生します。

liveChatMessages.streamlist

エラーのタイプ エラーの詳細 説明
INVALID_ARGUMENT (3) LIVE_CHAT_ENDED 終了したライブチャットのメッセージを取得することはできません。
PERMISSION_DENIED (7) forbidden 指定したライブチャットのメッセージを取得するために必要な権限がありません。
PERMISSION_DENIED (7) liveChatDisabled 指定されたブロードキャストではチャットが有効になっていません。
PERMISSION_DENIED (7) liveChatEnded 指定されたチャットはすでに終了しています。
NOT_FOUND (5) liveChatNotFound 取得しようとしているチャットが見つかりません。リクエストの liveChatId パラメータの値を確認して、正しいことを確認します。
RESOURCE_EXHAUSTED (8) rateLimitExceeded リクエストが、前回の要求から間を置かずに送信されました。このエラーは、メッセージを取得する API リクエストが YouTube の更新頻度よりも頻繁に送信され、帯域幅が無駄になっている場合に発生します。

liveStreams

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

liveStreams.delete

エラーのタイプ エラーの詳細 説明
forbidden (403) liveStreamDeletionNotAllowed 指定されたライブ配信は、まだ完了していないブロードキャストにバインドされているため、削除できません。
insufficientPermissions insufficientLivePermissions リクエストには、指定されたライブ ストリームを削除する権限がありません。詳細については、OAuth 2.0 認証の実装をご覧ください。
insufficientPermissions liveStreamingNotEnabled リクエストを承認したユーザーは、YouTube でライブ動画をストリーミングできません。詳細については、機能の利用資格をご覧ください。
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 プロパティに値を指定しないと、このエラーが返されます。
required (400) ingestionTypeRequired liveStream リソースは、cdn.ingestionType プロパティの値を指定する必要があります。
required (400) resolutionRequired cdn.frameRate プロパティに値を指定しても cdn.resolution プロパティに値を指定しないと、このエラーが返されます。
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 ライブ配信リソースでは、id プロパティの値を指定する必要があります。
required (400) ingestionTypeRequired ライブ配信リソースでは、cdn.ingestionType プロパティの値を指定する必要があります。
required (400) titleRequired ライブ配信リソースでは、snippet.title プロパティの値を指定する必要があります。