LiveStreams: insert

動画ストリームを作成します。ストリームを使用すると、動画を YouTube に送信して視聴者にブロードキャストできます。

一般的なユースケース

リクエスト

HTTP リクエスト

POST https://www.googleapis.com/youtube/v3/liveStreams

認可

このリクエストは、少なくとも次のうち 1 つのスコープでの承認が必要です（認証と承認の詳細をご確認ください）。

範囲
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

パラメータ

次の表に、このクエリでサポートされているパラメータを示します。このリストのパラメータはすべてクエリ パラメータです。

パラメータ
必須パラメータ
part string
この操作では、part パラメータは 2 つの目的を果たします。書き込みオペレーションで設定されるプロパティと、API レスポンスに含まれるプロパティを指定します。

パラメータ値に含めることができる part プロパティは、id、snippet、cdn、contentDetails、status です。
オプション パラメータ
onBehalfOfContentOwner string
このパラメータは、適切に承認されたリクエストでのみ使用できます。注: このパラメータは YouTube コンテンツ パートナー専用です。

onBehalfOfContentOwner パラメータは、リクエストの認証情報が、パラメータ値で指定されたコンテンツ所有者の代理である YouTube CMS ユーザーを識別することを示します。このパラメータは、複数の YouTube チャンネルを所有、管理している YouTube コンテンツ パートナーを対象にしています。このパラメータを使用すると、コンテンツ所有者は一度認証されれば、すべての動画やチャンネル データにアクセスできるようになります。チャンネルごとに認証情報を指定する必要はありません。ユーザー認証に使用する CMS アカウントは、指定された YouTube コンテンツ所有者にリンクされていなければなりません。
onBehalfOfContentOwnerChannel string
このパラメータは、適切に承認されたリクエストでのみ使用できます。このパラメータは、適切に承認されたリクエストでのみ使用できます。注: このパラメータは YouTube コンテンツ パートナー専用です。

onBehalfOfContentOwnerChannel パラメータは、動画が追加されるチャンネルの YouTube チャンネル ID を指定します。このパラメータは、リクエストで onBehalfOfContentOwner パラメータの値が指定されている場合に必須で、そのパラメータと組み合わせて使用できます。また、リクエストは、onBehalfOfContentOwner パラメータで指定されたコンテンツ所有者にリンクされた CMS アカウントを使用して承認される必要があります。最後に、onBehalfOfContentOwnerChannel パラメータ値で指定されたチャンネルを、onBehalfOfContentOwner パラメータで指定されたコンテンツ所有者にリンクする必要があります。

このパラメータは、さまざまな YouTube チャンネルを所有および管理している YouTube コンテンツ パートナーを対象としています。このパラメータを使用すると、コンテンツ所有者は一度認証されれば、パラメータ値で指定されたチャンネルの代わりにアクションを実行できるようになります。チャンネルごとに認証情報を指定する必要はありません。

リクエスト本文

リクエストの本文には liveStream リソースを指定します。 このリソースについて:

  • 以下のプロパティの値を指定する必要があります。

    • snippet.title
    • cdn.frameRate
    • cdn.ingestionType
    • cdn.resolution

  • 以下のプロパティの値を設定することができます。

    • snippet.title
    • snippet.description
    • cdn.frameRate
    • cdn.ingestionType
    • cdn.resolution
    • contentDetails.isReusable

レスポンス

成功すると、このメソッドはレスポンスの本文で liveStream リソースを返します。

エラー

次の表に、このメソッドの呼び出しに対して API から返されるエラー メッセージを示します。詳細については、エラー メッセージのドキュメントを参照してください。

エラーのタイプ エラーの詳細 説明
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 プロパティの値を指定する必要があります。

試してみよう:

APIs Explorer を使用してこの API を呼び出し、API のリクエストとレスポンスを確認します。