YouTube Live Streaming API - Errors

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

fanFundingEvents

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

fanFundingEvents.list

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

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 つのプロパティのいずれか 1 つのみが含まれるようにリソースを変更して、リクエストを再送信します。
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/2474026https://www.youtube.com/features をご覧ください。
rateLimitExceeded (403) userRequestsExceedRateLimit ユーザーが特定の期間内に送信したリクエストの数が多すぎます。
required (400) idRequired 必須の id パラメータでは、キューポイントを挿入するブロードキャストを指定する必要があります。
required (400) cueTypeRequired 必須の cueType フィールドは API リクエスト本文で指定する必要があります。
notFound (404) liveBroadcastNotFound id パラメータで指定されたブロードキャストが存在しません。
invalidValue (400) conflictingTimeFields insertionOffsetTimeMswalltimeMs のいずれか 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 指定した禁止は削除できません。このエラーは、別のモデレーターの禁止を解除しようとしているモデレーターがリクエストを承認した場合に発生することがあります。
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 の更新頻度よりも頻繁に送信され、帯域幅が不必要に浪費される場合に発生します。

liveCuepoints

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

liveCuepoints.insert

エラーのタイプ エラーの詳細 説明
invalidValue (400) conflictingTimeFields offsetTimeMswalltime のいずれか 1 つのみを指定できます。

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 プロパティに値を指定しなかった場合、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.formatcdn.frameRatecdn.ingestionTypecdn.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 チャンネルでスポンサーシップが有効になっていない。