YouTube Live Streaming API - 変更履歴

このページでは、YouTube Live Streaming API の変更内容とドキュメントの更新内容の一覧を示します。

2026 年 10 月 12 日

この改訂での変更内容は次のとおりです:

2026 年 8 月 18 日

この改訂での変更内容は次のとおりです:

  • liveBroadcasts.update メソッドのドキュメントが更新され、収益化関連の新しいエラー preconditionFailed (412)（理由: videoNotEligibleForAdsMonetization）と backendError (503)（理由: backendError）が追加されました。

2026 年 8 月 17 日

この改訂での変更内容は次のとおりです:

  • liveBroadcast リソースの新しい snippet.categoryId プロパティを使用すると、ライブ配信に関連付けられた動画カテゴリを設定、更新、取得できます。

2026 年 7 月 20 日

この改訂での変更内容は次のとおりです:

2026 年 7 月 9 日

この改訂での変更内容は次のとおりです:

  • liveChatBans.insert のドキュメントで、snippet.type プロパティを permanent または temporary にする必要があることが明記されるようになりました。

    liveChatMessage.insert のドキュメントには、questionText が metadata の直接プロパティであり、options がオブジェクトの配列で、各オブジェクトに optionText フィールドが含まれていることが正確に反映されています。

2026 年 6 月 1 日

この改訂での変更内容は次のとおりです:

  • liveBroadcast リソースの contentDetails.availabilityConfig プロパティを使用すると、ライブ配信に地域制限を指定して、ライブ イベントの地域別の提供状況を管理できます。

2026 年 3 月 26 日

この改訂での変更内容は次のとおりです:

  • snippet.type プロパティで新しい値 giftEvent がサポートされるようになりました。

  • liveChatMessage リソースの新しい snippet.giftEventDetails プロパティとその子には、ギフト イベントに関する情報が含まれています。

2026 年 1 月 12 日

API で、ライブ配信のミッドロール挿入点とミッドロール挿入点の自動挿入を有効にできるようになりました。

ブロードキャストがミッドロールの対象である限り、ブロードキャストの所有者はブロードキャストのミッドロールを有効にすることを選択できます。オーナーは、いつでもブロードキャストのミッドロールをオフにすることもできます。

ブロードキャストでミッドロールが有効になっている場合、ブロードキャストの所有者はミッドロールの自動挿入を有効にすることができます。また、ライブ配信の自動広告はいつでもオフにできます。

ブロードキャストのオーナーは、自動広告を有効にする際に、次のいずれかのオプションを選択できます。

  • YouTube によってミッドロールの挿入が最適化されるようにします。このオプションは、次の 3 つのモードをサポートしています。
    • 低: 収益化能力は低く、視聴体験の中断が少ない
    • 中: 収益化能力は中程度、視聴体験のバランスがとれている
    • 高: 収益化能力は高く、視聴体験の中断が多い
  • ミッドロール挿入の戦略と間隔を手動で設定します。この場合、オーナーは次の 2 つのパラメータを設定する必要があります。
    1. 広告キューポイントのスケジュール設定戦略。キューポイントは、すべての視聴者に対して同時に挿入することも、視聴者ごとに異なるタイミングで挿入することもできます。後者の戦略では、YouTube がキューポイントをより高い頻度でスケジュール設定できるようになり、視聴者はキューポイントを受け取る資格がある場合にキューポイントを受け取ることができます。
    2. ミッドロール広告ブレーク間の間隔の長さ。

この機能をサポートするために、ドキュメントに次の API の変更が反映されています。

  • liveBroadcast リソースの monetizationDetails オブジェクトには、ミッドロールの有効化と自動広告の構成のフィールドが含まれています。
  • update メソッドを使用すると、ミッドロール広告を有効または無効にできます。この方法は、ライブ配信の自動広告を設定する場合にも使用できます。このドキュメントでは、ライブ配信の収益化と自動広告の設定を更新する際に発生する可能性のある、いくつかの新しいエラーについて説明しています。

2025 年 7 月 14 日

liveChatMessages.streamList メソッドの説明を更新し、streamList API の使用方法に関するガイダンスを追加しました。

2023 年 10 月 9 日

参考として、どのステッカー ID がどの Super Stickers に関連しているかは、こちらの CSV ファイルで確認できます。この情報を反映するため、liveChatMessage リソースの snippet.superStickerDetails.superStickerMetadata.stickerId プロパティと superChatEvent リソースの snippet.superStickerMetadata.stickerId プロパティの定義が更新されました。

2023 年 9 月 15 日

API で、ライブ配信に広告を挿入する新しい方法がサポートされるようになりました。liveCuepoints を使用すると、ミッドロール挿入点をブロードキャストに手動で挿入できます。さらに、ミッドロール挿入点を一定の間隔でブロードキャストに自動挿入する機能もサポートされるようになりました。

ブロードキャストのオーナーが自動広告を有効にすると、広告の動作に関する次の側面を確認できます。

  • ミッドロール挿入点間の間隔の長さ。
  • 広告キューポイントのスケジュール設定戦略。キューポイントは、すべての視聴者に対して同時に挿入することも、視聴者ごとに異なるタイミングで挿入することもできます。後者の戦略では、YouTube がキューポイントをスケジュールする頻度が高くなり、視聴者はキューポイントを受け取れるときに受け取ることができます。
  • ミッドロール広告が表示されない期間。この機能では、特定の時間までミッドロール広告の挿入を一時停止するようにブロードキャストの所有者が指定します。

この機能をサポートするために、ドキュメントには次の API の変更が反映されています。

  • liveBroadcast リソースに monetizationDetails オブジェクトが含まれるようになりました。オブジェクトのフィールドは、ブロードキャストで広告の自動挿入が有効になっているかどうかを示し、キューポイントをスケジュールするための追加情報を指定します。
  • liveBroadcast.list メソッドの part パラメータは、値 monetizationDetails をサポートしています。
  • update メソッドを使用すると、ライブ配信でミッドロール広告の挿入を一定期間一時停止できます。また、ライブ配信の収益化の詳細を更新する際に発生する可能性のあるいくつかのエラーについても説明しています。

2023 年 8 月 1 日

この改訂での変更内容は次のとおりです:

  • liveBroadcasts.update メソッドで、次のフィールドの値を指定する必要がなくなりました。

    • snippet.title
    • status.privacyStatus

    リクエストでこれらのフィールドを省略すると、変更されません。

2022 年 11 月 1 日

  • 新しい liveBroadcasts.cuepoint メソッドを使用すると、YouTube でライブ配信を配信しているチャンネル所有者は、その放送にキューポイントを挿入して、ミッドロール挿入点をトリガーできます。このメソッドは、YouTube コンテンツ パートナーのみがライブ配信にキューポイントを挿入できる liveCuepoints.insert メソッドに代わるものです。

    この新しいメソッドの提供状況を反映して、いくつかのガイドが更新されました。

  • 注: これはサポート終了のお知らせです。

    liveCuepoints.insert メソッドは非推奨になりました。liveCuepoints.insert メソッドのサポートは 2023 年 5 月 1 日以降に削除されます。API ユーザーは、代わりに liveBroadcasts.cuepoint メソッドを呼び出すようにアプリケーションを更新する必要があります。

  • liveBroadcasts.control メソッドのドキュメントが削除されました。このメソッドのサポート終了通知は 2020 年 9 月に投稿されました。

2022 年 10 月 1 日

この改訂での変更内容は次のとおりです:

  • liveBroadcasts.update メソッドでは、次のフィールドの値を指定する必要がなくなりました。

    • contentDetails.enableContentEncryption
    • contentDetails.enableDvr
    • contentDetails.enableEmbed
    • contentDetails.recordFromStart
    • contentDetails.startWithSlate

    リクエストでこれらのフィールドを省略すると、変更されません。

  • 廃止された liveBroadcast フィールドのドキュメントを削除しました。

    • contentDetails.enableContentEncryption
    • contentDetails.startWithSlate

2022 年 4 月 1 日

この改訂での変更内容は次のとおりです:

  • snippet.type プロパティで、次の 2 つの新しい値がサポートされるようになりました。

    • membershipGiftingEvent
    • giftMembershipReceivedEvent

  • liveChatMessage リソースの新しい snippet.membershipGiftingDetails プロパティとその子には、メンバーシップ ギフト イベントに関する情報が含まれています。同様に、新しい snippet.giftMembershipReceivedDetails プロパティとその子には、メンバーシップ ギフトの受け取りイベントに関する情報が含まれています。

2021 年 9 月 15 日

この改訂での変更内容は次のとおりです:

  • snippet.type プロパティで、次の 2 つの新しい値がサポートされるようになりました。

    • newSponsorEvent
    • memberMilestoneChatEvent

  • liveChatMessage リソースの新しい snippet.memberMilestoneChatDetails プロパティとその子には、メンバー マイルストーン チャット イベントに関する情報が含まれています。同様に、新しい snippet.newSponsorDetails プロパティとその子には、新しいスポンサー イベントに関する情報が含まれます。

2020 年 12 月 1 日

API の liveBroadcasts.transition メソッドは、新しい 403（Forbidden）エラーをサポートしています。これは、ユーザーが特定の期間内に過剰な数のリクエストを送信したことを示します。エラーの理由は userRequestsExceedRateLimit です。

2020 年 9 月 21 日

  • liveBroadcast リソースの status.madeForKids プロパティの定義が更新され、プロパティが読み取り専用であることが明確になりました。これは API の機能の変更を反映したものではありません。

    ライブ配信を子ども向けとして指定するには、liveBroadcasts.insert メソッドを呼び出して配信を作成するときに、status.selfDeclaredMadeForKids プロパティを true に設定します。

  • 注: この変更には、サポート終了のお知らせと、以前のサポート終了のお知らせの更新が含まれています。

    liveBroadcasts.control メソッドは 2020 年 10 月 1 日以降に非推奨となります。この日以降、このメソッドに対するすべての呼び出しで禁止（403）エラーが返され、このメソッドは後で完全に削除されます。クライアントは、YouTube の取り込みサーバーに送信される動画にオーバーレイを追加することで、独自のスレートを実装できます。

    2020 年 4 月 16 日に発表された非推奨のお知らせの非推奨日は、当初の予定では 2020 年 9 月 1 日でしたが、延期され、2020 年 10 月 1 日以降となります。したがって、その非推奨のお知らせに含まれる機能と liveBroadcasts.control メソッドはすべて同時に非推奨になります。

2020 年 7 月 17 日

注: これは、以前の非推奨のお知らせの更新です。

2016 年 4 月に非推奨となった liveStream リソースの cdn.format フィールドは、2020 年 8 月 17 日をもってサポートを終了します。このフィールドを引き続き使用しているリクエストは、この日付以降に失敗します。

コードで cdn.format フィールドがまだ使用されている場合は、cdn.frameRate プロパティと cdn.resolution プロパティを使用して、フレームレートと解像度を個別に指定するように更新する必要があります。

2020 年 7 月 6 日

HLS を使用した YouTube ライブ コンテンツの配信ガイドが更新され、いくつかの変更が加えられました。

また、新しい取り込みプロトコルの比較では、YouTube がサポートする取り込みプロトコル、各プロトコルでサポートされるコーデック、各プロトコルの適切なユースケースに関する追加情報が一覧表示されています。

2020 年 4 月 16 日

このアップデートには、新しいプロパティとサポート終了のお知らせが含まれています。

  • liveBroadcast リソースで contentDetails.enableAutoStop プロパティがサポートされるようになりました。このプロパティは、チャンネル所有者がバインドされた動画ストリームで動画のストリーミングを停止してから約 1 分後に、ブロードキャストを自動的に停止するかどうかを示します。

    ブロードキャストのライフサイクルのドキュメントが更新され、contentDetails.enableAutoStart プロパティまたは contentDetails.enableAutoStop プロパティを true に設定した場合に、YouTube ライブ イベントの作成と管理のステップバイステップのプロセスがどのように変化するかが説明されています。

  • 注: これはサポート終了のお知らせです。これらの変更は、2020 年 9 月 1 日以降に適用されます。変更が有効になる実際の日付は、以下で非推奨日と呼びます。

    この更新では、互換性を破る可能性のある変更について説明します。この問題は、チャンネルのデフォルトの liveStream リソースと liveBroadcast リソースを使用して YouTube でライブ コンテンツをストリーミングする API クライアント アプリケーションに影響します。具体的には、永続的なブロードキャストとストリームに関連付けられたブロードキャスト ID とストリーム ID は、新しいブロードキャストの開始に使用できなくなります。

    次のいずれかに該当する場合、アプリケーションは影響を受けます。

    • liveBroadcast リソースの isDefaultBroadcast プロパティの値を確認します。このプロパティは、非推奨日以降は返されません。
    • liveStream リソースの isDefaultStream プロパティの値を確認します。このプロパティは、非推奨日以降は返されません。
    • liveBroadcasts.list メソッドを呼び出し、broadcastType パラメータ値を persistent または all に設定します。このパラメータは、これらの変更の一環として非推奨になります。サポート終了日以降:
      • broadcastType パラメータ値が persistent の場合、liveBroadcasts.list メソッドは結果を返しません。
      • broadcastType パラメータ値が all の場合、liveBroadcasts.list メソッドは、その時刻より前に存在していた永続ブロードキャストを返しません。

    背景として、過去数年間、YouTube ではチャンネルでライブ配信が有効になると、チャンネルのデフォルトのストリームとデフォルトのブロードキャストが自動的に作成されていました。デフォルト ストリームは無期限に存在し、開始時刻や終了時刻が関連付けられておらず、削除できませんでした。同様に、デフォルトのブロードキャストは永続的と見なされていました。これは常に存在し、特定のイベントにバインドされていませんでした。

    サポート終了日以降:

    • YouTube でデフォルトのストリームとブロードキャストが作成されなくなります。デフォルトのリソースに依存するのではなく、API クライアントは liveBroadcast リソースと liveStream リソースを作成して管理し、それらのリソースをバインドできる必要があります。
    • チャンネルのデフォルトのブロードキャストとデフォルトのストリームがアクティブなライブ状態である場合、つまり、サポート終了が有効になった時点でチャンネルがライブ配信に使用している場合、進行中のブロードキャストは影響を受けません。ただし、ブロードキャストが終了すると、チャンネルはデフォルトのブロードキャストとデフォルトのストリームを再度使用できなくなります。
    • チャンネルのデフォルトのブロードキャストとデフォルトのストリームがアクティブにライブ配信されていない場合、サポート終了が有効になった後、YouTube はそれらのリソースを使用して動画をブロードキャストしようとする試みを無視します。

    アプリケーションが影響を受ける場合は、以下のドキュメントを参照して、この変更後もアプリケーションが想定どおりに動作するように更新してください。

    • 新しい移行ガイドでは、現在デフォルトのブロードキャストとストリームを使用している API クライアントでデベロッパーが対処する必要がある手順について説明しています。
    • ブロードキャストのライフサイクル ガイドでは、YouTube でライブイベントを作成して管理する方法を、手順を追って説明します。各ステップでは、特定のアクションを完了するために必要な API 呼び出しなどの処理について説明します。YouTube がデフォルトのストリームとブロードキャストのサポートを終了した後は、アプリケーションでこのプロセスに従う必要があります。

2020 年 3 月 31 日

注: これはサポート終了のお知らせです。

sponsor リソースと sponsors.list メソッドは非推奨となり、member リソースと members.list メソッドに置き換えられました。

sponsors.list メソッドは、2020 年 9 月 30 日以降はサポートされなくなります。API クライアントは、sponsors.list メソッドの呼び出しを更新して、代わりに members.list メソッドを使用する必要があります。新しいリソースの詳細については、YouTube Data API の変更履歴をご覧ください。

2020 年 3 月 11 日

HLS を介した YouTube ライブ コンテンツの配信ガイドの取り込みエンドポイントのセクションが更新され、プライマリ取り込み URL とバックアップ取り込み URL を形成する際に、エンコーダが file= パラメータ値を完成させるために使用するプロセスが明確になりました。

2020 年 2 月 4 日

HLS を介した YouTube ライブ コンテンツの配信ガイドが更新され、DELETE リクエストは任意であり、YouTube の HLS エンドポイントでは無視されることが記載されました。パフォーマンス上の理由から、YouTube はクライアントが DELETE リクエストを送信しないことを推奨しています。

2020 年 1 月 10 日

API で、YouTube が「子ども向け」と呼ぶ、子ども向けコンテンツを識別できるようになりました。YouTube ヘルプセンターで、「子ども向け」コンテンツについて詳しくご確認ください。

  • liveBroadcast リソースは、コンテンツ クリエイターと視聴者が「子ども向け」コンテンツを識別できるようにする 2 つの新しいプロパティをサポートしています。
    • selfDeclaredMadeForKids プロパティを使用すると、コンテンツ クリエイターはライブ配信が子ども向けコンテンツかどうかを指定できます。このプロパティは、liveBroadcasts.insert メソッドでブロードキャストを作成するときに設定できます。このプロパティは、チャンネル所有者が API リクエストを承認した場合にのみ、liveBroadcast リソースを含む API レスポンスに含まれます。
    • madeForKids プロパティを使用すると、API ユーザーはブロードキャストの「子ども向け」ステータスを取得できます。たとえば、ステータスは selfDeclaredMadeForKids プロパティの値に基づいて決定される場合があります。チャンネル、動画、ブロードキャストの視聴者の設定について詳しくは、YouTube ヘルプセンターをご覧ください。
  • YouTube Data API では、channel リソースも新しい selfDeclaredMadeForKids プロパティと madeForKids プロパティをサポートしています。

また、YouTube API サービスの利用規約とデベロッパー ポリシーも更新しました。詳しくは、YouTube API サービス利用規約 - 改訂履歴をご覧ください。YouTube API サービスの利用規約とデベロッパー ポリシーの変更は、太平洋時間 2020 年 1 月 10 日に有効になります。

2019 年 8 月 20 日

HLS を介した YouTube ライブ コンテンツの配信ガイドの要件セクションが更新され、次の 2 つの変更が加えられました。

  • 各メディア プレイリストに、確認済みのセグメントと未処理のセグメントの両方を含めることがベスト プラクティスであると説明されています。この方法により、サーバー側でメディア プレイリストが失われた場合にセグメントがスキップされる可能性が低くなります。たとえば、各メディア プレイリストに最大 2 つの確認済みセグメントと最大 5 つの未処理セグメントを含めることができます。
  • メディア セグメントごとにメディア プレイリストを送信することが必須になりました。これにより、メディア プレイリストが失われた場合に、サーバーを迅速に復旧できます。この方法は、以前は推奨事項として記載されていました。

2019 年 6 月 28 日

YouTube で HLS 取り込みがサポートされるようになりました。これに伴い、liveStream リソースの ingestionType プロパティは、HLS を使用して YouTube に取り込まれたストリームを識別する新しい値 hls をサポートします。

新しいHLS を使用した YouTube ライブ コンテンツの配信ガイドでは、HLS を使用してエンコーダから YouTube にライブ コンテンツを配信するためのガイドラインを提供しています。このガイドは、エンコーダ ベンダーが製品に HLS 配信のサポートを追加するのに役立つことを目的としています。

2019 年 4 月 4 日

この改訂での変更内容は次のとおりです:

  • API リファレンス ドキュメントが更新され、各メソッドの一般的なユースケースがよりわかりやすく説明されるとともに、API Explorer ウィジェットを通じて動的で高品質なコードサンプルが提供されるようになりました。例については、liveBroadcasts.list メソッドのドキュメントをご覧ください。API メソッドを説明するページに、次の 2 つの新しい要素が追加されました。

    • API Explorer ウィジェットを使用すると、認可スコープを選択し、パラメータとプロパティのサンプル値を入力して、実際の API リクエストを送信し、実際の API レスポンスを確認できます。このウィジェットには、入力したスコープと値を使用して動的に更新される完全なコードサンプルを表示する全画面表示もあります。

    • 一般的なユースケース セクションでは、ページで説明されているメソッドの一般的なユースケースを 1 つ以上説明します。たとえば、liveBroadcasts.list メソッドを呼び出して、特定のブロードキャストに関するデータを取得したり、現在のユーザーのブロードキャストに関するデータを取得したりできます。

      このセクションのリンクを使用すると、ユースケースのサンプル値を API Explorer に入力したり、これらの値がすでに入力されている全画面表示の API Explorer を開いたりできます。これらの変更は、独自のアプリケーションに実装しようとしているユースケースに直接適用できるコードサンプルを簡単に確認できるようにすることを目的としています。

    現在、Java、JavaScript、PHP、Python、curl のコードサンプルがサポートされています。

  • コードサンプル ページにも、上記のすべての機能を提供する新しい UI が追加されました。このツールを使用すると、さまざまなメソッドのユースケースを調べたり、API Explorer に値を読み込んだり、API Explorer を全画面表示して Java、JavaScript、PHP、Python のコードサンプルを取得したりできます。

    この変更に伴い、Java、PHP、Python で利用可能なコードサンプルを掲載していたページは削除されました。

2019 年 2 月 25 日

liveChatMessage リソースと superChatEvent リソースの両方に Super Stickers に関する情報を含めることができるようになったことを反映して、これらのリソースのドキュメントが更新されました。Super Stickers は、画像を表示する Super Chat メッセージの一種です。他の Super Chat と同様に、Super Sticker メッセージは YouTube ライブ配信中にファンが購入します。

  • liveChatMessage リソースで、snippet.type プロパティが superStickerEvent に設定され、リソースに Super Stickers に関する情報が含まれていることが示されるようになりました。その場合、リソースには snippet.superStickerDetails オブジェクトも含まれます。このオブジェクトには、Super Sticker に関する追加情報が含まれています。
  • superChatEvent リソースのブール値 snippet.isSuperStickerEvent は、Super Chat メッセージが Super Sticker でもあるかどうかを示します。その場合、snippet.superStickerMetadata オブジェクトには Super Stickers に関する追加の詳細が含まれます。

2018 年 4 月 5 日

superChatEvents.list メソッドの説明を更新し、API レスポンスに fanFundingEvents が含まれなくなったことを反映しました。は 2017 年初頭に非推奨となりました。

2017 年 4 月 3 日

新しい Java コードサンプルが追加されました。このサンプルでは、チャット メッセージを一覧表示、挿入、削除する方法が示されています。サンプルでは、次のメソッドを呼び出します。

2017 年 2 月 13 日

この改訂での変更内容は次のとおりです:

  • 既存のリソースとメソッドの更新

    • onBehalfOfContentOwner パラメータが現在必須であることを反映するように、liveCuepoints.insert メソッドが更新されました。また、メソッドの説明が更新され、そのメソッドの呼び出しは YouTube コンテンツ所有者に関連付けられたアカウントによって承認される必要があることが明記されました。

2017 年 2 月 9 日

この改訂での変更内容は次のとおりです:

  • 既存のリソースとメソッドの更新

    • superChatEvents.list メソッドの新しい hl パラメータを使用すると、特定の言語の規則に従って snippet.displayString プロパティ値をフォーマットするように指定できます。このプロパティの定義もそれに応じて更新されています。

      パラメータ値は、i18nLanguages.list メソッドから返されるリストに含まれる言語コードである必要があります。デフォルト値は en です。これは、デフォルトの動作では、表示文字列が英語で使用される形式でフォーマットされることを意味します。たとえば、デフォルトでは、文字列は $1,00 ではなく $1.00 としてフォーマットされます。

2017 年 2 月 1 日

この改訂での変更内容は次のとおりです:

  • 新しいリソースとメソッド

    • 新しい superChatEvent リソースは、YouTube ライブ配信中にファンが購入した Super Chat メッセージを表します。YouTube ライブのチャット ストリームで、Super Chat は次の 2 つの方法で他のメッセージよりも目立つようになります。

      • Super Chat は色付きでハイライト表示されます。
      • Super Chat は一定時間ティッカーに固定表示されます。

      Super Chat の色、ティッカーに固定表示される時間、メッセージの最大長は、購入金額によって決まります。Super Chat について詳しくは、YouTube ヘルプセンターをご覧ください。

      この API は、過去 30 日間のチャンネルのライブ配信の Super Chat イベントを一覧表示するメソッドをサポートしています。このメソッドは、チャンネルの最後のライブ ストリームの視聴者ファンディング イベント（fanFundingEvents）に関するデータも返します。

  • 既存のリソースとメソッドの更新

    • snippet.type プロパティで superChatEvent 値がサポートされるようになりました。この値は、リソースが Super Chat を表していることを示します。

      また、liveChatMessage リソースの新しい snippet.superChatDetails プロパティとその子には、Super Chat イベントに関する情報が含まれています。

    • liveStream リソースの cdn.resolution プロパティで、値 2160p がサポートされるようになりました。

  • 新しいエラーと更新されたエラー

    • この API は、次の新しいエラーをサポートしています。

      エラーの詳細
      liveBroadcasts.insert、liveBroadcasts.update liveBroadcasts.insert メソッドと liveBroadcasts.update メソッドは、400（Bad Request）エラーを返して、挿入または更新される liveBroadcast リソースの contentDetails.enableEmbed プロパティまたは contentDetails.projection プロパティに無効な値が含まれていることを示します。2 つの新しいエラーのエラー理由は、それぞれ invalidEmbedSetting と invalidProjection です。

2017 年 1 月 12 日

注: これはサポート終了のお知らせです。

新しい Super Chat 機能のリリースに伴い、YouTube は視聴者ファンディング機能を非推奨とし、視聴者ファンディング API は 2017 年 2 月 28 日に無効になります。その日付以降は、次のようになります。

2016 年 8 月 11 日

この改訂での変更内容は次のとおりです:

  • 新たに公開された YouTube API サービス利用規約（以下「更新後の利用規約」）は、YouTube エンジニアリングおよびデベロッパー ブログで詳しく説明されているように、現在の利用規約に多くの更新を加えたものです。2017 年 2 月 10 日より発効する更新された利用規約に加え、この更新には、デベロッパーが遵守すべきポリシーを説明する複数の補足ドキュメントが含まれています。

    新しいドキュメントの完全なセットについては、更新された利用規約の変更履歴をご覧ください。また、更新された規約またはその関連文書の今後の変更についても、その変更履歴で説明します。そのドキュメントのリンクから、変更履歴の変更を一覧表示する RSS フィードに登録できます。

2016 年 5 月 20 日

YouTube で DASH 取り込みがサポートされるようになりました。これに伴い、liveStream リソースの ingestionType プロパティは、DASH を使用して YouTube に取り込まれたストリームを識別するための新しい値 dash をサポートしています。

新しいDASH を使用した YouTube ライブ コンテンツの配信ガイドでは、DASH 配信形式を使用してエンコーダから YouTube でライブデータを配信するためのガイドラインを提供しています。これは、エンコーダ ベンダーが自社製品に DASH 配信サポートを追加できるようにすることを目的としています。

2016 年 4 月 18 日

この改訂での変更内容は次のとおりです:

  • 既存のリソースとメソッドの更新

    • liveStream リソースの更新

      • YouTube は、解像度 1440p、30 または 60 フレーム/秒のライブ配信に対応するようになりました。

        また、liveStream リソースには、受信動画データのフレームレートと解像度を指定するための新しいプロパティが含まれています。

        プロパティ
        cdn.frameRate 受信動画データのフレームレート。有効な値は 30fps と 60fps です。
        cdn.resolution 受信動画データの解像度。有効なプロパティ値は、1440p、1080p、720p、480p、360p、240p です。

      • liveStream リソースの cdn.frameRate プロパティと cdn.resolution プロパティの導入に伴い、リソースの cdn.format は非推奨になりました。cdn.format プロパティは、解像度とフレームレートを単一の値で指定します。

        新しくサポートされたフィールドに移行することをおすすめします。それまでの間、cdn.format は引き続き機能します。また、ライブ配信を挿入するリクエストは、cdn.format プロパティ、または cdn.frameRate プロパティと cdn.resolution プロパティのいずれかの値を指定すれば、現時点では成功します。3 つのプロパティすべてに値を指定した場合、値が一致しないと API からエラーが返されることがあります。

        cdn.format プロパティは非推奨になりましたが、API が 1440p ストリームを 30 fps または 60 fps でサポートすることを反映するために、1440p と 1440p_hfr の 2 つの新しい値をサポートするようになりました。

    • liveBroadcast リソースの更新

      • liveBroadcast リソースには、次の新しいプロパティが含まれています。

        プロパティ
        contentDetails.boundStreamLastUpdateTimeMs ブロードキャストの contentDetails.boundStreamId プロパティで参照されるライブ配信が最後に更新された日時。
        contentDetails.projection ブロードキャストの投影形式。プロパティのデフォルト値は rectangular です。このプロパティの有効な値は 360 と rectangular です。

      • liveBroadcast リソースの statistics.totalChatCount プロパティの定義が更新され、プロパティ値は、ブロードキャストに少なくとも 1 つのチャット メッセージがある場合にのみ表示されることが明記されました。

    • liveChatMessage リソースの更新

      • snippet.type プロパティは、次の箇条書きで説明する新しいプロパティに対応する 2 つの新しい値（messageDeletedEvent と userBannedEvent）をサポートしています。snippet.authorChannelId プロパティの定義も更新され、これらの新しいメッセージ タイプでプロパティ値が識別する内容が説明されています。

      • liveChatMessage リソースには、次の新しいプロパティが含まれています。

        プロパティ
        snippet.messageDeletedDetails このオブジェクトには、チャット モデレーターによって削除されたメッセージに関する情報が含まれます。このオブジェクトは、snippet.type プロパティの値が messageDeletedEvent の場合にのみ存在します。
        snippet.userBannedDetails このオブジェクトには、チャットへの参加を禁止されたユーザーに関する情報が含まれます。このオブジェクトには、禁止自体に関する情報（禁止が永続的か一時的かなど）も含まれます。禁止が一時的な場合、オブジェクトのプロパティの 1 つで禁止期間を指定します。

        このオブジェクトは、snippet.type プロパティの値が userBannedEvent の場合にのみ存在します。

  • 新しいエラーと更新されたエラー

    • この API は、次の新しいエラーをサポートしています。

      エラーの詳細
      liveBroadcasts.bind liveBroadcasts.bind メソッドは、特定の時間枠内でユーザーが過剰な数のリクエストを送信したことを示す 403（Forbidden）エラーを返します。エラーの理由は userRequestsExceedRateLimit です。

      liveBroadcasts.insert メソッドと liveBroadcasts.update メソッドは、すでに同じエラーをサポートしています。
      liveStreams.insert liveStreams.insert メソッドは、リクエストが挿入しようとした liveStream リソースの無効なプロパティ値を特定する 4 つの新しい 400（Bad Request）エラーをサポートしています。次のリストに、エラーの理由と、関連付けられているプロパティを示します。
      liveStreams.insert liveStreams.insert メソッドは 2 つの新しい 400（Bad Request）エラーをサポートしています。各エラーは、リクエストが挿入しようとした liveStream リソースに必要な値が存在しないことを示します。次のリストに、エラーの理由と、それに関連付けられているプロパティを示します。
      具体的には、liveStream リソースを挿入するときに、cdn.format プロパティ、または cdn.frameRate プロパティと cdn.resolution プロパティの値を指定する必要があります。
      • 3 つのプロパティのいずれにも値を指定しない場合、API は formatRequired エラーを返します。
      • cdn.resolution の値を指定して cdn.frameRate の値を指定しないと、API は frameRateRequired エラーを返します。
      • cdn.frameRate の値を指定して cdn.resolution の値を指定しないと、API は resolutionRequired エラーを返します。
      liveStreams.update リクエストが次の変更不可能なプロパティの値を変更しようとすると、liveStreams.update メソッドは 403（Forbidden）エラーを返します。 エラー レスポンスの reason は liveStreamModificationNotAllowed です。

2015 年 12 月 18 日

欧州連合（EU）の法律では、EU のエンドユーザーに対して特定の情報を開示し、同意を得ることを義務付けています。そのため、欧州連合に居住するエンドユーザーに対しては、EU ユーザーの同意ポリシーを遵守する必要があります。この要件に関する通知を YouTube API 利用規約に追加しました。

2015 年 12 月 17 日

この改訂での変更内容は次のとおりです:

  • 新しいリソースとメソッド

    • この API は、ライブ配信のチャット機能をサポートするいくつかの新しいリソースをサポートしています。YouTube は、アクティブなライブ配信中のチャット機能をサポートしています。これらのリソースとそのメソッドは、チャット メッセージの取得とチャットの管理機能をサポートしています。

      リソース
      liveChatMessage このリソースは、YouTube ライブチャットのメッセージを表します。YouTube では、テキスト メッセージや視聴者ファンディング イベントなど、いくつかの種類のメッセージがサポートされています。一部のメッセージ タイプは、スポンサー限定期間の開始やチャットの終了など、チャットの特定のフェーズを識別します。この API は、チャット メッセージの一覧表示、挿入、削除を行うメソッドをサポートしています。
      liveChatModerators このリソースは、チャット モデレーターを識別します。モデレーターは、チャットからのユーザーの禁止やメッセージの削除など、一部の管理機能を実行できます。この API は、チャット モデレーターを一覧表示、挿入、削除するメソッドをサポートしています。
      liveChatBans このリソースは、特定のチャットへのメッセージの投稿を禁止されているユーザーを識別します。禁止措置は一時的なものと永続的なものがあります。この API は、チャットの禁止を追加、削除するメソッドをサポートしています。
      fanFundingEvents このリソースは、YouTube チャンネルでの視聴者ファンディング イベントを表します。視聴者ファンディングは、視聴者が YouTube クリエイターを 1 回限りの金銭的支援で自発的にサポートできる機能です。

      API の fanFundingEvents.list メソッドは、チャンネルの視聴者ファンディング イベントを一覧表示します。チャンネルが所有するライブ配信中にチャットを通じて開始された視聴者ファンディング イベントでも、配信のチャットに fanFundingEvent メッセージがトリガーされます。

      視聴者ファンディングについて詳しくは、YouTube ヘルプセンターをご覧ください。
      sponsors sponsor リソースは、YouTube チャンネルのスポンサーを識別します。スポンサーはチャンネルに月額料金を支払います。チャンネルのチャットでスポンサーのメッセージの横にバッジが表示されます。また、スポンサーは、チャンネルのスポンサー限定のチャット（開催される場合）にも参加できます。

      API の sponsors.list メソッドは、チャンネルのスポンサーを一覧表示します。ユーザーがチャンネル所有のライブ配信中にチャンネルのスポンサーに登録すると、API はブロードキャストのチャットに newSponsorEvent メッセージも追加します。

      スポンサーシップについて詳しくは、YouTube ヘルプセンターをご覧ください。

  • 既存のリソースとメソッドの更新

    • liveBroadcast リソースには、次の新しいプロパティが含まれています。

      プロパティ
      snippet.liveChatId ブロードキャストの YouTube ライブチャットの ID。この ID を使用して、liveChatMessage リソースのメソッドを使用してチャット メッセージを取得、挿入、削除できます。また、チャット モデレーターの追加や削除、ユーザーのチャットへの参加禁止、既存の禁止措置の解除も行うことができます。
      contentDetails.closedCaptionsType 注: このプロパティは contentDetails.enableClosedCaptions プロパティに置き換わるものです。

      このプロパティは、ブロードキャストで字幕が有効になっているかどうかを示します。有効になっている場合は、提供している字幕の種類を示します。
      • closedCaptionsDisabled: ライブ配信の字幕が無効になっています。
      • closedCaptionsHttpPost: HTTP POST を介して、ライブ配信に関連付けられた取り込み URL に字幕を送信します。
      • closedCaptionsEmbedded: 字幕は、EIA-608 形式または CEA-708 形式（あるいはその両方）を使用して動画ストリームにエンコードされます。
      contentDetails.enableClosedCaptions このプロパティは 2015 年 12 月 17 日をもって非推奨となりました。代わりに contentDetails.closedCaptionsType プロパティを使用してください。このプロパティをすでに使用している API クライアントの場合:
      • プロパティ値を true に設定することは、contentDetails.closedCaptionsType プロパティを closedCaptionsHttpPost に設定することと同じです。
      • プロパティ値を false に設定することは、contentDetails.closedCaptionsType プロパティを closedCaptionsDisabled に設定することと同じです。

    • liveBroadcasts.list メソッドの新しい broadcastType パラメータを使用すると、API レスポンスをフィルタして、イベント ブロードキャスト、永続ブロードキャスト、またはすべてのブロードキャストを含めることができます。

      永続ブロードキャストは、常に存在し、特定のイベントに関連付けられていないブロードキャストです。具体的には、チャンネルのデフォルトのブロードキャストは永続的なブロードキャストであり、YouTube クリエイター ツールのライブ ダッシュボードからアクセスできます。チャンネルの他のブロードキャストはイベント ブロードキャストです。

  • liveStream リソースの status.healthStatus.configurationIssues[].type フィールドに、次の新しいヘルス ステータス エラーが報告されます。

    エラー
    audioTooManyChannels 音声が 3 チャンネル以上ありますが、1 チャンネル（モノラル）と 2 チャンネル（ステレオ）以外はサポートされていません。音声チャンネルの数を修正してください。
    frameRateHigh 現在のフレームレートが高すぎます。フレームレートを %(framerate)s fps 以下に設定してください。

  • 以前のドキュメント更新の公開日を修正しました。

  • 新しいエラーと更新されたエラー

    • 上記の新しいリソースに対して定義されたエラーに加えて、API は次の新しいエラーをサポートしています。

      エラーの詳細
      liveBroadcasts.update
      HTTP レスポンス コードforbidden (403)
      理由closedCaptionsTypeModificationNotAllowed
      説明contentDetails.closedCaptionsType 値は、ブロードキャストが created または ready ステータスのときにのみ変更できます。
      liveBroadcasts.update
      HTTP レスポンス コードinvalidValue (400)
      理由invalidEnableClosedCaptions
      説明liveBroadcast リソースで、contentDetails.enableClosedCaptions プロパティの値が contentDetails.closedCaptionType 設定の値と互換性がありません。2 つのプロパティのうち 1 つのみが含まれるようにリソースを変更してから、リクエストを再送信します。

2015 年 8 月 19 日

この改訂での変更内容は次のとおりです:

  • 新しいリソースとメソッド

    • 注: liveChat リソースとそのメソッドのドキュメントは機密情報であり、一部の YouTube パートナーのみが閲覧できます。

      新しい liveChat リソースには、YouTube でのライブ配信中に投稿されたコメントが含まれます。この API は、このリソースに対して次の 2 つのメソッドをサポートしています。

      メソッド
      liveChats.list ブロードキャストのチャット メッセージを一覧表示します。
      liveChats.insert 新しいチャット メッセージを作成します。

      チャット メッセージは、ブロードキャストがライブ配信されている間のみ取得および投稿できます。

  • 既存のリソースとメソッドの更新

    • liveStream リソースには、次の新しいプロパティが含まれています。

      プロパティ
      snippet.isDefaultStream このストリームがチャンネルのデフォルト ストリームかどうかを示します。チャンネルのデフォルト ストリームは無期限に存在し、開始時刻や終了時刻が関連付けられておらず、削除できません。デフォルト ストリームの仕組みの詳細については、プロパティの定義をご覧ください。
      status.healthStatus このオブジェクトには、ストリーミングの問題の特定、診断、解決に使用できる情報が含まれています。このオブジェクトには、ライブ動画ストリームの健全性を評価するのに役立つ子プロパティが多数含まれています。

      特に、status.healthStatus.configurationIssues[] オブジェクトには、動画ストリームに影響する問題が一覧表示されます。新しいドキュメント LiveStream リソースの構成に関する問題には、API が報告するすべての問題が記載されています。
      contentDetails.isReusable ストリームが再利用可能かどうかを示します。再利用可能とは、複数のブロードキャストにバインドできることを意味します。ブロードキャストが異なる時間に行われる場合、ブロードキャスト事業者が同じストリームを多くの異なるブロードキャストで再利用することは一般的です。

    • liveBroadcast リソースには、次の新しいプロパティが含まれています。

      プロパティ
      snippet.isDefaultBroadcast このブロードキャストがチャンネルのデフォルトのブロードキャストかどうかを示します。YouTube チャンネルでライブ配信が有効になっている場合、YouTube はそのチャンネルのデフォルトのストリームとデフォルトのブロードキャストを作成します。ストリームは、チャンネル所有者がライブ動画を YouTube に送信する方法を定義します。ブロードキャストは、視聴者がデフォルトのストリームを視聴する方法です。デフォルトのブロードキャストの仕組みについて詳しくは、プロパティの定義をご覧ください。
      contentDetails.enableLowLatency このブロードキャストを低レイテンシ ストリーミング用にエンコードするかどうかを示します。低遅延ストリームを使用すると、ブロードキャストを視聴しているユーザーに動画が表示されるまでの時間を短縮できますが、ストリームの視聴者の解像度に影響する可能性もあります。
      statistics.totalChatCount ブロードキャストに関連付けられているチャット メッセージの合計数。このプロパティとその値は、ブロードキャストがユーザーに表示され、チャット機能が有効になっている場合に存在します。ブロードキャストが終了すると、このプロパティは値を指定しなくなります。そのため、このプロパティでは、完了したライブ配信のアーカイブ動画のチャット メッセージ数は特定できません。

  • 新しいエラーと更新されたエラー

    • 新しい liveChat リソース用に定義されたエラーに加えて、API は次の新しいエラーをサポートしています。

      エラーの詳細
      liveStreams.update
      HTTP レスポンス コードforbidden (403)
      理由liveStreamModificationNotAllowed
      説明API では、再利用可能なストリームを再利用不可に変更したり、その逆を行ったりすることはできません。詳しくは、ブロードキャストとストリームについてをご覧ください。

2015 年 5 月 21 日

この改訂での変更内容は次のとおりです:

  • YouTube は、60 フレーム/秒（fps）でのライブ動画ストリーミングに対応しました。これにより、ゲームやその他の動きの速い動画をよりスムーズに再生できるようになります。YouTube で 60 fps のライブ配信を開始すると、高フレームレートでの視聴にまだ対応していないデバイスでも 30 fps で視聴できるようになります。

    liveStream リソースの cdn.format プロパティは、この機能の 2 つの新しい値（720p_hfr と 1080p_hfr）をサポートしています。

    この機能について詳しくは、YouTube クリエイター ブログをご覧ください。

2014 年 8 月 21 日

この改訂での変更内容は次のとおりです:

  • liveBroadcasts.control メソッドの walltime パラメータの定義が更新され、プロパティ値が ISO 8601 形式（YYYY-MM-DDThh:mm:ss.sssZ）で指定されることが明記されました。

  • API で次のエラーがサポートされるようになりました。

    エラーのタイプ エラーの詳細 説明
    insufficientPermissions liveStreamingNotEnabled API リクエストを承認したユーザーが YouTube でライブ動画をストリーミングできない場合、liveBroadcast リソースと liveStream リソースのすべてのメソッドでこのエラーが返されます。ユーザーがライブ動画を配信できない理由について詳しくは、ユーザーのチャンネル設定（https://www.youtube.com/features）で確認できます。
    rateLimitExceeded userRequestsExceedRateLimit liveBroadcasts.insert メソッドと liveStreams.insert メソッドはどちらも、ユーザーが特定の期間内に過剰な数のリクエストを送信したことを示すために、このエラーを返します。

2014 年 5 月 2 日

この改訂での変更内容は次のとおりです:

  • liveStream リソースと liveBroadcasts.bind メソッドの説明が更新され、ブロードキャストは 1 つの動画ストリームにのみバインドできますが、動画ストリームは複数のブロードキャストにバインドできることが明記されました。この変更はドキュメントの修正のみであり、基盤となる API の機能は変更されていません。

  • liveBroadcast リソースの contentDetails.monitorStream.enableMonitorStream プロパティが更新され、プロパティの値が true の場合、ブロードキャストを live 状態に移行する前に testing 状態に移行する必要があることが説明されています。（プロパティの値が false の場合、ブロードキャストに testing ステージを設定できないため、ブロードキャストを直接 live 状態に移行できます。

  • liveCuepoint リソースの settings.offsetTimeMs プロパティが更新され、ブロードキャストにモニター ストリームがない場合は、プロパティの値を指定しないように注意が追加されました。

  • liveBroadcast リソースと liveStream リソースのすべてのメソッドで、onBehalfOfContentOwner パラメータと onBehalfOfContentOwnerChannel パラメータがサポートされるようになりました。これらのパラメータを使用すると、同じコンテンツ所有者に関連付けられているさまざまなチャンネルの API リクエストを、同じ認証情報を使用して完了できます。

  • liveCuepoints.insert メソッドのドキュメントが更新され、そのメソッドを呼び出すときに settings.walltime プロパティの値を設定できることが記載されました。

  • エラーに関するドキュメントで、各エラータイプの HTTP レスポンス コードが指定されるようになりました。

  • API で次のエラーがサポートされるようになりました。

    エラーのタイプ エラーの詳細 説明
    insufficientPermissions livePermissionBlocked liveBroadcasts.insert、liveBroadcasts.transition、liveStreams.insert メソッドは、リクエストを承認したユーザーが YouTube でライブ動画をストリーミングできない場合に、このエラーを返します。ユーザーがライブ動画を配信できない理由について詳しくは、ユーザーのチャンネル設定（https://www.youtube.com/features）で確認できます。

  • liveBroadcasts.insert メソッドの invalidScheduledStartTime エラーが更新され、スケジュールされた開始時刻が現在の日付に十分近く、その時点でライブ配信を確実にスケジュールできる必要があることが明確になりました。

2013 年 12 月 13 日

この改訂での変更内容は次のとおりです:

  • liveBroadcast リソースの新しい status.recordingStatus プロパティは、ブロードキャストの現在のステータスを示します。

  • liveBroadcast リソースの新しい contentDetails.enableClosedCaptions プロパティは、ブロードキャストで字幕を取り込めるかどうかを示します。このプロパティの値は、ブロードキャストの挿入時または更新時に設定できますが、ブロードキャストが testing または live 状態になると更新できません。このプロパティを true に設定すると、ブロードキャストにバインドされている liveStream リソースは、ブロードキャストのクローズド キャプションに使用する取り込み URL を指定します。

  • liveBroadcast リソースの snippet.scheduledEndTime プロパティで、無期限に継続するようスケジュールされたブロードキャストがサポートされるようになりました。この変更により、liveBroadcasts.insert リクエストと liveBroadcasts.update リクエストでこのプロパティは必須ではなくなりました。

    このプロパティの値を指定していない liveBroadcast リソースを取得すると、ライブ配信は無期限に継続されるようにスケジュールされます。同様に、liveBroadcasts.insert メソッドまたは liveBroadcasts.update メソッドを呼び出し、このプロパティの値を指定しない場合、ブロードキャストは無期限に継続するようにスケジュールされます。

  • liveBroadcast リソースの contentDetails.recordFromStart プロパティ（デフォルト値は true）は、ブロードキャスト チャンネルでライブ配信の録画を無効にすることが許可されている場合にのみ、false に設定できるようになりました。

    チャンネルに録画を無効にする権限がない場合に、recordFromStart プロパティが false に設定されたブロードキャストを挿入しようとすると、API は Forbidden エラーを返します。また、チャンネルにその権限がなく、ブロードキャストを更新して recordFromStart プロパティを false に設定しようとすると、API は modificationNotAllowed エラーを返します。

  • liveBroadcast リソースに enableArchive プロパティが含まれなくなりました。このプロパティは、contentDetails.enableDvr プロパティと contentDetails.enableEmbed プロパティの説明に記載されていました。

  • liveBroadcast リソースの status.lifeCycleStatus プロパティの有効な値のリストが更新され、各ステータスの説明が追加されました。

  • liveCuepoint リソースの新しい settings.walltime プロパティは、キューポイントを挿入する日時を指定します。リクエストで、このプロパティと settings.offsetTimeMs プロパティの値を指定するキューポイントを挿入しようとすると、API からエラーが返されます。

  • liveStream リソースの新しい contentDetails オブジェクトには、ストリームに関する情報が含まれています。現在、このオブジェクトのプロパティは contentDetails.closedCaptionsIngestionUrl のみです。これは、動画ストリームに関連付けられた字幕の取り込み URL を指定します。

  • liveStream リソースの status.streamStatus プロパティの有効な値のリストが更新され、各ステータスの説明が追加されました。

  • liveBroadcasts.control メソッドの新しい walltime パラメータを使用すると、スレートの変更が発生する日時を指定できます。リクエストでこのパラメータと offsetTimeMs パラメータの両方の値を指定すると、API はエラーを返します。

  • liveBroadcasts.list リクエストに対する API レスポンスで、kind プロパティの値が youtube#liveBroadcastList から youtube#liveBroadcastListResponse に変更されました。

  • liveStreams.list リクエストに対する API レスポンスで、kind プロパティの値が youtube#liveStreamList から youtube#liveStreamListResponse に変更されました。

  • eventId プロパティは liveBroadcastListResponse と liveStreamListResponse の両方で非推奨になりました。

  • この API では、次の新しいエラーがサポートされています。

    エラーのタイプ エラーの詳細 説明
    invalidValue conflictingTimeFields リクエストで offsetTimeMs パラメータと walltime パラメータの値を指定すると、liveBroadcasts.control メソッドはこのエラーを返します。リクエストでは、両方のパラメータを省略するか、2 つのパラメータのいずれか 1 つに値を指定できます。
    invalidValue invalidWalltime walltime パラメータの値が無効な場合、liveBroadcasts.control メソッドはこのエラーを返します。
    forbidden enableClosedCaptionsModificationNotAllowed contentDetails.enableClosedCaptions 値を更新しようとしたときに、ブロードキャストのステータスが created または ready でない場合、liveBroadcasts.update メソッドはこのエラーを返します。
    invalidValue conflictingTimeFields リクエストで settings.offsetTimeMs プロパティと settings.walltime プロパティの値が指定されている場合、liveCuepoints.insert メソッドはこのエラーを返します。リクエストでは、両方のプロパティを省略するか、2 つのプロパティのいずれかに値を指定できます。

    また、liveStreams.update メソッドは、liveStreams.insert メソッドがサポートするエラーと同様の cdnRequired エラーをサポートしなくなりました。

2013 年 5 月 10 日

この改訂での変更内容は次のとおりです。

2013 年 5 月 2 日

この改訂での変更内容は次のとおりです:

2013 年 3 月 27 日

この改訂での変更内容は次のとおりです:

  • liveBroadcast リソースで次のプロパティが変更されました。

    • startWithSlateCuepoint プロパティの名前が startWithSlate に変更されました。
    • enableArchive プロパティの名前が recordFromStart に変更されました。
    • slateSettings オブジェクトは非推奨となり、ドキュメントから削除されました。slateSettings オブジェクトまたはそのプロパティに関連するエラー メッセージも削除されました。最後に、スタートガイドの「スレートの表示」セクションが削除されました。

  • API は、liveCuepoints.insert メソッドを使用したインライン スレートの挿入をサポートしなくなりました。この変更に伴い、次のドキュメントが更新されました。

2013 年 3 月 18 日

この改訂での変更内容は次のとおりです:

  • API のすべてのエラー メッセージが更新され、発生する可能性のあるエラーがより明確に説明されるようになりました。また、可能な場合は、エラーの修正方法に関するガイダンスも提供されるようになりました。

  • API が新しいエラーを返すことがあります。以下のリストは、エラーと、そのエラーを返す可能性のある API メソッドを示しています。

    • liveBroadcasts.insert - ブロードキャストの予定終了時間は、予定開始時間より後にする必要があります。
    • liveBroadcasts.insert - ブロードキャストで無効なプライバシー ステータスが指定されています。
    • liveBroadcasts.update - リソースに contentDetails.enableArchive プロパティの値が含まれていないか、設定されていません。
    • liveBroadcasts.update - リソースに contentDetails.enableContentEncryption プロパティが含まれていないか、値が設定されていません。
    • liveBroadcasts.update - リソースに contentDetails.enableDvr プロパティの値が含まれていないか、設定されていません。
    • liveStreams.insert - スニペットのタイトルは 1 ～ 128 文字にする必要があります。
    • liveStreams.update - リソースに snippet.title プロパティが含まれていないか、値が設定されていません。

  • liveStream リソースのドキュメントが更新され、以前に示されたように、マルチキャストと WebM が取り込み方法としてサポートされていないことが反映されました。これに伴い、cdn.format プロパティの形式のリストが更新され、cdn.multicastIngestionInfo オブジェクトとその子プロパティがリソースのドキュメントから削除されました。また、http がサポートされている cdn.ingestionType 値のリストから削除されました。