変更履歴

このページでは、YouTube Reporting API と YouTube Analytics API の API の変更点とドキュメントの更新について説明します。どちらの API を使用しても、デベロッパーは YouTube アナリティクスのデータにアクセスできますが、その方法は異なります。この変更履歴を配信登録してください登録

2024 年 5 月 6 日

YouTube Analytics(Targeted Queries)API では、チャンネルに関する 3 つの新しいレポートがサポートされています。

  • DMA 別のユーザー アクティビティ レポートは、指定マーケット エリア(DMA)ごとのユーザー アクティビティの統計情報を示す地域別レポートです。このレポートでは、filters パラメータ値を country==US に設定する必要があります。

  • 同時視聴者数レポートには、1 つのライブ配信動画の部分ごとに同時視聴者数が表示されます。

  • メンバーの解約レポートには、ユーザーがチャンネル メンバーシップを解約した理由を示す統計情報が表示されます。

    このレポートでは、ユーザーがチャンネル メンバーシップを解約した理由を指定する新しい membershipsCancellationSurveyReason ディメンションを使用します。また、その理由で解約されたチャンネル メンバーシップの数を示す新しい指標 membershipsCancellationSurveyResponses も使用します。

さらに、視聴者維持率レポートが拡張され、次の 3 つの新しい指標をサポートするようになりました。

2024 年 4 月 7 日

YouTube Analytics(Targeted Queries)API に、コンテンツ所有者の再生リストレポートに関連する更新がいくつか加えられました。更新内容は、2024 年 1 月 19 日に発表されたチャンネル再生リスト レポートに関連する更新と同じです。

次の変更履歴エントリには、2024 年 1 月 19 日のエントリとほぼ同じ情報が表示されます。ただし、コンテンツ所有者の再生リスト レポートでは、2024 年 12 月 31 日まで isCurated ディメンションがサポートされます。また、チャンネル再生リスト レポートでは、2024 年 6 月 30 日までこのディメンションがサポートされます。

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

    コンテンツ所有者の再生リストレポートの isCurated ディメンションのサポートが終了しました。2024 年 12 月 31 日以降、サポートは終了します。それに応じて、このディメンションの定義が更新されました。

    isCurated ディメンションを削除するときに下位互換性を維持するには、再生リストレポートの場合のみ、views 指標ではなく playlistViews 指標を取得するようにコードを更新する必要があります。意味は異なりますが、再生リスト レポートでは views 指標が引き続きサポートされているため、指標名を更新しなくても API はデータを返します。もちろん、viewsplaylistViews の両方を取得して表示するようにアプリケーションを変更することもできます。

    isCurated ディメンションに加えて、次の API 機能は新しいレポートではサポートされなくなりました。

    • 地域フィルタ(continentsubcontinent など)は、新しいチャンネル再生リスト レポートではサポートされていません。
    • redViews 指標と estimatedRedMinutesWatched 指標は、新しいチャンネル再生リスト レポートでサポートされなくなりました。これらの指標は YouTube Studio では利用できなかったため、Studio アプリケーションで使用できる機能と API の機能が一致します。
    • subscribedStatus ディメンションと youtubeProduct ディメンションは、チャンネル再生リスト レポートのフィルタとしてサポートされなくなりました。これらのフィルタは YouTube Studio では利用できなかったため、この変更により、Studio アプリケーションで使用できる機能と API の機能が一致します。
  • コンテンツ所有者レポートのドキュメントで再生リストレポートのセクションを更新し、再生リストレポートでサポートされている指標の種類についてより詳しく説明しています。

    • 動画の集計指標は、コンテンツ所有者の再生リストに含まれ、かつそのコンテンツ所有者も所有しているすべての動画について集計された、ユーザー アクティビティとインプレッションの指標です。集計された動画指標は、isCurated ディメンションを使用しない API リクエストでのみサポートされます。
    • 再生リスト内の指標は、再生リストページのコンテキストにおけるユーザー アクティビティとエンゲージメントを反映します。これらの指標には、再生リスト内の所有者ではない動画の視聴回数も含まれますが、それはその視聴回数が再生リストのコンテキスト内で発生した場合に限られます。
    • サポートされる再生リストの指標のセクションでは、再生リストのレポートでサポートされる、集計された動画の指標と再生リスト内の指標を示します。
  • コンテンツ所有者の再生リストのレポートでは、次の再生リスト内指標が新たにサポートされています。なお、これらの指標は、レポートを取得する API リクエストで isCurated ディメンションを使用しない場合にのみサポートされます。各指標の定義については、metricsのドキュメントをご覧ください。

  • views 指標の動作は、再生リストレポートを取得する API リクエストで isCurated ディメンションを使用したかどうかに依存するようになりました。

    • リクエストに isCurated ディメンションが含まれている場合、views 指標は再生リスト内の指標で、コンテンツ所有者の再生リスト内で動画が視聴された回数を示します。
    • リクエストに isCurated ディメンションが含まれていない場合、views 指標は集計された動画指標となり、コンテンツ所有者の再生リスト内の動画が再生された合計回数が示されます。それらの再生が再生リストのコンテキスト内で発生したかどうかは関係ありません。合計には、再生リストを所有するチャンネルに関連付けられているコンテンツ所有者が所有する動画の視聴回数のみが含まれます。

      isCurated ディメンションを使用しないこれらのレポートでは、playlistViews 指標は再生リスト内で動画が再生された回数を示します。この指標は、動画を所有するチャンネルに関係なく、再生リスト内のすべての動画の視聴回数をカウントします。
  • 各再生リスト レポートについて、コンテンツ所有者レポートのドキュメントには、API リクエストに isCurated ディメンションが含まれているかどうかに応じて、そのレポートでサポートされている指標を示す表が追加されました。例については、時間ベースの再生リストレポートを定義するセクションをご覧ください。

2024 年 1 月 19 日

YouTube Analytics(Targeted Queries)API には、チャンネル再生リストのレポートに関連する更新がいくつか含まれています。この更新には、サポートが終了したディメンションと、いくつかの新しい指標および更新された指標が含まれています。

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

    チャネル レポートの isCurated ディメンションのサポートが終了しました。2024 年 6 月 30 日以降はサポートされなくなります。それに応じて、このディメンションの定義が更新されました。

    isCurated ディメンションを削除するときに下位互換性を維持するには、再生リストレポートの場合のみ、views 指標ではなく playlistViews 指標を取得するようにコードを更新する必要があります。意味は異なりますが、再生リスト レポートでは views 指標が引き続きサポートされているため、指標名を更新しなくても API はデータを返します。もちろん、viewsplaylistViews の両方を取得して表示するようにアプリケーションを変更することもできます。

    isCurated ディメンションに加えて、次の API 機能は新しいレポートではサポートされなくなりました。

    • 地域フィルタ(continentsubcontinent など)は、新しいチャンネル再生リスト レポートではサポートされていません。
    • redViews 指標と estimatedRedMinutesWatched 指標は、新しいチャンネル再生リスト レポートでサポートされなくなりました。これらの指標は YouTube Studio では利用できなかったため、Studio アプリケーションで使用できる機能と API の機能が一致します。
    • subscribedStatus ディメンションと youtubeProduct ディメンションは、チャンネル再生リスト レポートのフィルタとしてサポートされなくなりました。これらのフィルタは YouTube Studio では利用できなかったため、この変更により、Studio アプリケーションで使用できる機能と API の機能が一致します。
  • チャンネル レポートのドキュメントの再生リストレポートのセクションが更新され、再生リストレポートでサポートされている指標の種類について詳しく説明されています。

    • 動画の集計指標は、チャンネルの再生リストに含まれ、かつそのチャンネルも所有しているすべての動画について集計された、ユーザー アクティビティとインプレッションの指標です。集計された動画指標は、isCurated ディメンションを使用しない API リクエストでのみサポートされます。
    • 再生リスト内の指標は、再生リストページのコンテキストにおけるユーザー アクティビティとエンゲージメントを反映します。これらの指標には、再生リスト内の所有者ではない動画の視聴回数も含まれますが、それはその視聴回数が再生リストのコンテキスト内で発生した場合に限られます。
    • サポートされる再生リストの指標のセクションでは、再生リストのレポートでサポートされる、集計された動画の指標と再生リスト内の指標を示します。
  • チャンネルの再生リストのレポートでは、次の新しい再生リスト内指標がサポートされています。これらの指標は、コンテンツ所有者レポートではまだサポートされていません。なお、これらの指標は、レポートを取得する API リクエストで isCurated ディメンションを使用しない場合にのみサポートされます。各指標の定義については、metricsのドキュメントをご覧ください。

  • views 指標の動作は、再生リストレポートを取得する API リクエストで isCurated ディメンションを使用したかどうかに依存するようになりました。

    • リクエストに isCurated ディメンションが含まれている場合、views 指標は再生リスト内の指標で、チャンネルの再生リスト内で動画が再生された回数を示します。
    • リクエストに isCurated ディメンションが含まれていない場合、views 指標は集計された動画指標となり、チャンネルの再生リスト内の動画が視聴された合計回数を示します。これは、その視聴が再生リスト内で行われたかどうかは関係ありません。合計には、再生リストを所有するチャンネルが所有する動画の視聴回数のみが含まれます。

      isCurated ディメンションを使用しないこれらのレポートでは、playlistViews 指標は再生リスト内で動画が再生された回数を示します。この指標は、動画を所有するチャンネルに関係なく、再生リスト内のすべての動画の視聴回数をカウントします。
  • 各再生リスト レポートについて、チャンネル レポートのドキュメントには、API リクエストに isCurated ディメンションが含まれているかどうかに応じて、そのレポートでサポートされている指標を示す表が追加されました。例については、時間ベースの再生リストレポートを定義するセクションをご覧ください。

2023 年 12 月 4 日

YouTube アナリティクス(ターゲット クエリ)API が更新され、2 つの insightTrafficSourceType ディメンション値を結合できるようになりました。これまで、このディメンションは、再生リストの一部として再生された動画(PLAYLIST)と、再生リスト内のすべての動画を一覧表示するページから発生した視聴(YT_PLAYLIST_PAGE)を区別していました。今後、どちらのタイプの視聴回数も PLAYLIST ディメンション値に関連付けられます。

2022 年 12 月 15 日

YouTube Analytics(Targeted Queries)API では、2 つの新しいディメンションと 1 つの新しいレポートがサポートされています。

  • 新しいレポートでは、都市ごとのユーザー アクションを確認できます。このレポートは、チャンネルコンテンツ所有者が利用できます。このレポートには、YouTube が推定したユーザー アクションが発生した都市を示す新しい city ディメンションが含まれています。

  • 新しい creatorContentType ディメンションは、データ行のユーザー アクティビティ指標に関連付けられている YouTube コンテンツの種類を識別します。サポートされている値は LIVE_STREAMSHORTSSTORYVIDEO_ON_DEMAND です。

    creatorContentType ディメンションは、チャンネルとコンテンツ所有者のすべての動画レポートで、オプションのディメンションとしてサポートされています。

  • YouTube Analytics API のサンプル リクエスト ガイドに、2 つの新しいディメンションの例が追加されました。

  • 7DayTotals ディメンションと 30DayTotals ディメンションへの参照は、ドキュメントから削除されました。これらのディメンションのサポート終了は 2019 年 10 月に発表されました。

2022 年 8 月 26 日

YouTube Analytics(Targeted Queries)API と YouTube Reporting(Bulk Reports)API はどちらも、新しいトラフィック ソースの詳細値をサポートしています。

  • YouTube Analytics API(Targeted Queries)API では、insightTrafficSourceType ディメンションの値が SUBSCRIBER の場合、insightTrafficSourceDetail 値を podcasts に設定できます。これは、トラフィックがポッドキャストのリンク先ページから参照されたことを示します。
  • YouTube Reporting(Bulk Reports)API では、traffic_source_type ディメンションの値が 3 の場合、traffic_source_detail 値を podcasts に設定できます。これは、トラフィックがポッドキャストのリンク先ページから参照されたことを示します。

2022 年 2 月 11 日

gender ディメンションの有効な値のセットは、2022 年 8 月 11 日以降に変更されます。これは、API 実装における下位互換性のない変更である可能性があります。この変更は、YouTube API サービス利用規約の下位互換性のない変更セクションに従い、有効になる 6 か月前に発表されます。新しい値セットにシームレスに移行できるように、2022 年 8 月 11 日より前に API 実装を更新してください。

具体的な変更は次のとおりです。

  • YouTube アナリティクス(Targeted Queries)API において、gender ディメンションは現在、femalemale の 2 つの値をサポートしています。2022 年 8 月 11 日以降、このディメンションでは femalemaleuser_specified の 3 つの値がサポートされるようになります。
  • YouTube Reporting(Bulk Reports)API では、現在 gender ディメンションは FEMALEMALEGENDER_OTHER の 3 つの値をサポートしています。2022 年 8 月 11 日以降、サポートされている値のセットは FEMALEMALEUSER_SPECIFIED に変更されます。

2022 年 2 月 9 日

2021 年 12 月 13 日の時点で、ループするクリップのトラフィックを除外するように 2 つの指標が更新されました。この変更は、YouTube アナリティクス(Targeted Queries)API と YouTube Reporting(Bulk Reports)API の両方に影響します。

2022 年 2 月 2 日

この YouTube Reporting(Bulk Reports)API では、視聴がライブ リダイレクトで発生したことを示す新しいトラフィック ソース ディメンション値がサポートされます。

  • YouTube Reporting(Bulk Reports)API では、traffic_source_type ディメンションで値 28 がサポートされます。

このトラフィック ソース タイプの場合、traffic_source_detail ディメンションは、視聴者の参照元のチャンネル ID を示します。

2020 年 9 月 23 日

この YouTube Analytics(Targeted Queries)API と YouTube Reporting(Bulk Reports)API はどちらも、視聴者が YouTube ショートの視聴中に縦にスワイプすることで参照されたことを示す新しいトラフィック ソースのディメンション値をサポートしています。

  • YouTube Analytics API(Targeted Queries)API では、insightTrafficSourceType ディメンションは値 SHORTS をサポートします。
  • YouTube Reporting(Bulk Reports)API では、traffic_source_type ディメンションで値 24 がサポートされます。

トラフィック ソースの詳細ディメンション(YouTube Analytics API の insightTrafficSourceDetail、YouTube Reporting API の traffic_source_detail)は、この新しいトラフィック ソース タイプでは入力されません。

2020 年 7 月 20 日

この更新では、YouTube アナリティクス(Targeted Queries)API に影響する 2 つの変更について説明します。

  • YouTube アナリティクスのレポート グループの最大サイズが 200 から 500 エンティティに引き上げられました。
  • reports.query メソッドの filters パラメータは、YouTube アナリティクスのデータを取得する際に適用する必要があるフィルタのリストを指定します。このパラメータは、videoplaylistchannel フィルタに複数の値を指定する機能をサポートし、これらのフィルタに指定できる ID の最大数が 200 から 500 に増えました。

2020 年 2 月 13 日

このアップデートには、YouTube Analytics(Targeted Queries)API と YouTube Reporting(Bulk Reports)API に関連する以下の変更が含まれています。今回の変更について詳しくは、YouTube ヘルプセンターをご覧ください。

どちらの API でも、通知に使用されるトラフィック ソースの詳細値のセットが変わります。ターゲット クエリでは、通知は insightTrafficSourceType=NOTIFICATION として報告されます。一括レポートでは、通知は traffic_source_type=17 として報告されます。

新しい値では、以前は uploaded として報告されていた、アップロードされた動画やライブ配信に関連する通知が 2 つのカテゴリに分類されます。

  • uploaded_push - 動画のアップロード時にチャンネル登録者に送信されたプッシュ通知から発生した視聴回数
  • uploaded_other - 動画のアップロード時にチャンネル登録者に送信される、プッシュ通知以外の通知(メールや受信トレイ通知など)から発生した視聴回数。

これらの値は、2020-01-13(2020 年 1 月 13 日)から始まる期間に対して返されます。

なお、これらの値は通知そのものを表すものではなく、特定の YouTube の視聴につながったトラフィック ソースを表すものです。たとえば、レポートの行に views=3traffic_source_type=17NOTIFICATION)、traffic_source_detail=uploaded_push と表示されている場合、その行は、動画のアップロード時に送信されたプッシュ通知を視聴者がクリックしたことによる視聴回数が 3 回であることを示します。

2019 年 10 月 15 日

この更新には、YouTube アナリティクス(Targeted Queries)API に関連する次の変更が含まれています。

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

    YouTube は、7DayTotals ディメンションと 30DayTotals ディメンションのサポートを終了します。2020 年 4 月 15 日までは、これらのディメンションを使用してデータを取得できます。この日以降、7DayTotals または 30DayTotals ディメンションを使用してレポートを取得しようとすると、エラーが返されます。

    なお、ユーザーは、day ディメンションを使用してクエリを実行し、7 日間または 30 日間のデータを集計または導出することで、これらのディメンションの一部のデータを再現できます。次に例を示します。

    • 7 日間の視聴回数は、その期間の各日の視聴回数を集計して算出されます。
    • 7 日間の視聴者の割合は、1 日あたりの視聴回数にその日の視聴者の割合を掛けた値に、その日の動画を視聴したときにログインしていた視聴者の数で算出されます。次に、ログインしている視聴者数を期間全体に追加し、その期間の合計視聴回数で割ると、期間全体の視聴者率を算出できます。
    • 同じ視聴者であっても、異なる日付のユニーク視聴者として計算される可能性があるため、7 日間のユニーク視聴者数は計算できません。ただし、30DayTotals ディメンションの代わりに month ディメンションを使用すると、30 日間のユニーク視聴者数に関するデータを推定できる場合があります。month ディメンションはカレンダー月を参照しているのに対し、30DayTotals ディメンションは指定された開始日と終了日に基づいて 30 日間の期間を計算します。

2019 年 6 月 27 日

この更新には、YouTube アナリティクス(Targeted Queries)API に関連する次の変更が含まれています。

  • バージョン 1 の API のサポートは完全に終了したため、サポート終了のお知らせや、バージョン 2 への更新方法を説明した移行ガイドなど、バージョン 1 への参照を削除しました。

2018 年 11 月 1 日

この更新には、YouTube アナリティクス(Targeted Queries)API に関連する次の変更が含まれています。

  • API バージョン 1 のサポートが終了しました。サービスの中断を最小限に抑えるため、まだお済みでない場合は、API クライアントを更新して、できるだけ早く API のバージョン 2 をご利用ください。詳しくは、移行ガイドをご覧ください。

    なお、今回のサポート終了のスケジュールについては、当初 2018 年 4 月 26 日にお知らせしたとおりでございます。

2018 年 9 月 17 日

この更新には、YouTube アナリティクス(Targeted Queries)API に関連する次の変更が含まれています。

  • データモデルの概要ドキュメントの新しいデータの匿名化に関するセクションでは、指標が特定のしきい値を満たさない場合、一部の YouTube アナリティクスのデータが制限されることについて説明しています。これは、さまざまなケースで発生する可能性があります。実際には、次のような場合は、すべてのデータ(または一部)がレポートに含まれないことがあります。

    1. 指定した期間に動画やチャンネルのトラフィックが制限されている

      または

    2. 特定のしきい値を満たさないフィルタまたはディメンション(トラフィック ソース、国など)を選択している。

    新しいセクションでは、YouTube アナリティクスのレポートで制限される可能性があるデータの種類についても説明しています。

  • チャンネル レポートコンテンツ所有者レポートのドキュメントを更新し、再生場所、トラフィック ソース、デバイスタイプ/オペレーティング システムのレポートで redViewsestimatedRedMinutesWatched の指標がサポートされなくなったことを反映しました。

2018 年 6 月 18 日

この更新には、YouTube アナリティクス(Targeted Queries)API に対する以下の変更が含まれます。

  • 以下のメソッドのスコープ要件が変更されました。
    • reports.query メソッドへのリクエストには、https://www.googleapis.com/auth/youtube.readonly スコープへのアクセス権が必要です。
    • groupItems.list メソッドへのリクエストは、次のいずれかにアクセスする必要があります。
      • https://www.googleapis.com/auth/youtube スコープ
        または
      • https://www.googleapis.com/auth/youtube.readonly スコープ
        および
        https://www.googleapis.com/auth/yt-analytics.readonly スコープ

      1 つ目の方法では 1 つのスコープ(読み取り / 書き込みスコープ)を使用し、2 つ目の方法では 2 つの読み取り専用スコープを使用します。

2018 年 5 月 23 日

この更新には、YouTube アナリティクス(Targeted Queries)API に対する以下の変更が含まれます。

  • [API の概要] に、集計指標と削除済みアイテムという新しいセクションが追加されました。このセクションでは、削除されたリソース(動画、再生リスト、チャンネルなど)に関連付けられたデータを API レスポンスでどのように処理するかについて説明します。
  • API の概要のベスト プラクティス セクションを更新し、YouTube Data API を使用して、YouTube Analytics API レスポンスで識別されたリソースの追加メタデータを取得できることをお知らせしました。YouTube API サービスのデベロッパー ポリシー(セクション III.E.4.b から III.E.4.d のセクション)に記載されているように、API クライアントは、30 日後にその API から保存済みリソース メタデータを削除または更新する必要があります。

2018 年 5 月 22 日

この更新には、YouTube Reporting(Bulk Reports)API に関連する次の変更が含まれています。

  • 現在、以下の変更は 2018 年 7 月に実施される予定です。新しいポリシーは、すべてのレポートとレポートジョブにグローバルに適用されます。
    • この変更後、ほとんどの API レポート(バックフィル レポートを含む)は、生成後 60 日間利用できます。ただし、過去のデータを含むレポートは、生成後 30 日間利用できます。

      この発表が行われる前は、すべての API レポートは生成後 180 日間利用できました。このポリシー変更の発効に伴い、30 日以上経過した過去のデータレポートにも API 経由でアクセスできなくなります。作成から 60 日以上経過した他のすべてのレポートにもアクセスできなくなります。そのためドキュメントには、ポリシーの変更前に作成されたレポートは、最長 180 日間利用できることが明記されています。

    • 変更後にレポートジョブをスケジュールすると、YouTube はその日以降、ジョブがスケジュールされた時刻の 30 日前までのレポートを生成します。変更前にレポートジョブをスケジュールすると、YouTube はジョブがスケジュールされた時刻の 180 日前までのレポートを生成します。

  • ベスト プラクティス セクションを更新し、YouTube Data API を使用して、レポート内で特定されたリソースに関する追加のメタデータを取得できることをお知らせしました。YouTube API サービスのデベロッパー ポリシー(セクション III.E.4.b から III.E.4.d のセクション)に記載されているように、API クライアントは、30 日後にその API から保存済みリソース メタデータを削除または更新する必要があります。

  • レポートの特性」セクションを更新し、レポートデータがフィルタされていなくても、2018 年 6 月 1 日以降のデータを含むレポートには、レポート生成日の 30 日以上前に削除された YouTube リソースへの参照が含まれないことを記載しました。

  • API の概要の履歴データ セクションが更新され、新しいレポートジョブをスケジュールすると、通常、過去のレポートが数日以内に送信されることを説明します。以前のドキュメントには、このようなレポートが利用可能になるまでに最大 30 日かかると記載されていました。

  • API の概要のバックフィル データ セクションが更新され、バックフィル データが、以前に配信されたデータセットを置き換えるデータセットとしてより明確に定義されるようになりました。

2018 年 4 月 26 日

YouTube アナリティクス(ターゲット クエリ)API バージョン 2(v2)が一般公開されました。新しい API バージョンに関連するプロダクトとドキュメントの変更点は次のとおりです。

  • v2 API は v1 API とほぼ同じです。ただし、以下の変更を反映するにはコードを更新する必要があります。これらの変更の詳細については、新しい移行ガイドをご覧ください。

    • API のバージョンが v1 から v2 に変更されました。
    • API リクエストのベース URL が https://www.googleapis.com/youtube/analytics/v1 から https://youtubeanalytics.googleapis.com/v2 に変更されました。
    • reports.query メソッドのいくつかのパラメータの名前が更新されました。具体的には、ハイフンを含むパラメータ名(v1 API の end-date など)は、v2 API のハイフンではなくキャメルケース(endDate)を使用します。この変更により、API 全体でパラメータ名が統一されます。これは、グループを作成および管理する API のメソッドで、パラメータ名にすでにキャメルケースが使用されているためです。
    • v2 API は、Google のグローバル HTTP バッチ エンドポイント(www.googleapis.com/batch)に送信されるバッチ リクエストをサポートしていません。v2 API でバッチ リクエストを送信する場合は、代わりにエンドポイント https://youtubeanalytics.googleapis.com/v2 を使用する必要があります。

    また、以下の v1 機能も v2 API ではサポートされていません。

    • reports.query メソッドは、altquotaUseruserIp リクエスト パラメータのサポートを終了しました。
    • v2 API には、異なる API へのリクエストで構成されたバッチをサポートするバッチ エンドポイントはありません。(ただし、バッチは、同じ API の異なるメソッドへのリクエストで構成することもできます)。サポートの終了は YouTube Analytics API に固有のものではありません。YouTube はすべての API でグローバル バッチ エンドポイントのサポートを終了します。
    • v2 API は、API v1 でサポートされていた JSON-RPC プロトコルをサポートしていません。繰り返しになりますが、今回のサポート終了は YouTube Analytics API に固有のものではありません。

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

    バージョン 1 の API(v1)は非推奨となり、2018 年 10 月 31 日までサポートされます。この日を過ぎると、v1 API に対するすべてのリクエストは機能しなくなります。API 経由で YouTube アナリティクス データにアクセスできなくなるのを防ぐため、2018 年 10 月 31 日までに v2 API へのアップグレードをお願いいたします。

2018 年 2 月 21 日

この更新には、YouTube アナリティクス(Targeted Queries)API に対する以下の変更が含まれます。

  • 視聴者の年齢層と性別に基づいて視聴の統計情報を集計する視聴者のユーザー属性レポートでは、ユーザー アクションが発生した YouTube サービスを識別する youtubeProduct ディメンションがサポートされなくなりました。

2018 年 1 月 18 日

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

  • YouTube Reporting API(一括レポート)

    • 視聴が発生したデバイスのソフトウェア システムを識別する operating_system ディメンションで、次の値がサポートされるようになりました。
      • 25: KaiOS
  • YouTube Analytics API(ターゲットを絞ったクエリ)

    • operatingSystem」ディメンションでは、ディメンション値「KAIOS」がサポートされています。

2017 年 12 月 20 日

この更新には、YouTube Reporting API に関連する 2 つの変更が含まれています。

  • API サーバーで、レポートをダウンロードするリクエストに対して gzip 圧縮がサポートされるようになりました。gzip 圧縮は、他のタイプの API リクエストではサポートされていません。gzip 圧縮を有効にすると、各 API レスポンスに必要な帯域幅が削減されます。また、アプリケーションで API レスポンスを圧縮解除するには、追加の CPU 時間が必要になりますが、通常はネットワーク リソースの使用量を減らすことで、そのコストを上回ります。

    gzip でエンコードされたレスポンスを受信するには、次の例のように Accept-Encoding HTTP リクエスト ヘッダーを gzip に設定します。

    Accept-Encoding: gzip

    この機能については、API の概要と、report リソースの downloadUrl プロパティの定義で説明しています。

  • age groupgender のディメンションについて、API がこれらのディメンションに対して返す実際の値を示すように修正しました。これはドキュメントの訂正であり、API の機能または動作の変更を反映するものではありません。具体的には、次の値が変更されました。

    • age_group ディメンションの値には大文字を使用します。「AGE」という単語と年齢層の数字の間にはアンダースコアを使用し、ハイフンの代わりにアンダースコアを使用します。そのため、age13-17age18-24 などの値がそれぞれ AGE_13_17AGE_18_24 に修正されています。
    • gender ディメンションの値には大文字を使用します。そのため、femalemalegender_other の各値は、FEMALEMALEGENDER_OTHER に修正されています。

2017 年 8 月 10 日

このドキュメントでは、2016 年 8 月 10 日に、YouTube Analytics API の earnings 指標のサポート終了について発表しました。(これと同時に、同じデータを提供する estimatedRevenue という名前の新しい指標のサポートも追加されました)。

earnings 指標はコア指標であるため、発表日から 1 年間サポートされます。ただし、この 1 年間の期間が終了したため、earnings 指標はサポートされなくなりました。その結果、earnings 指標を指定する API リクエストは 400 HTTP レスポンス コードを返すようになりました。earnings 指標の代わりに estimatedRevenue 指標を使用するようにアプリをまだ更新していない場合は、できるだけ早く更新してください。

API ドキュメントが更新され、earnings 指標への残りの参照が削除されました。

2017 年 7 月 6 日

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

  • YouTube Analytics API(ターゲットを絞ったクエリ)

    • API ドキュメントが更新され、API レスポンスには、クエリ対象のすべての指標が利用可能なリクエストされた期間の最終日までのデータが含まれているという事実が反映されました。

      たとえば、リクエストで終了日が 2017 年 7 月 5 日が指定されていて、リクエストされたすべての指標の値が 2017 年 7 月 3 日までしか利用できない場合、その日がレスポンスにデータが含まれる最後の日付になります。(リクエストされた指標の一部のデータが 2017 年 7 月 4 日時点で使用できる場合でも同様です)。

    • adType ディメンションで、値 reservedBumperInstream がサポートされるようになりました。これは、最長 6 秒間のスキップ不可の動画広告で、動画を視聴する前に再生されることを意味します。この広告フォーマットは auctionBumperInstream 広告と同じですが、このタイプはオークション ベースではなく予約制で販売される広告です。

  • YouTube Reporting API(一括レポート)

    • ad_type ディメンションで、値 20 がサポートされるようになりました。これは、予約ベースで販売するバンパー広告を指します。バンパー広告は、最長 6 秒のスキップ不可の動画広告で、動画が視聴される前に再生されます。このディメンションの値 19 は、予約ベースではなくオークションで販売されるバンパー広告も参照しています。

    • 次の YouTube Reporting API レポートのレポートジョブが削除されました。

      • channel_basic_a1
      • channel_province_a1
      • channel_playback_location_a1
      • channel_traffic_source_a1
      • channel_device_os_a1
      • channel_subtitles_a1
      • channel_combined_a1
      • content_owner_basic_a2
      • content_owner_province_a1
      • content_owner_playback_location_a1
      • content_owner_traffic_source_a1
      • content_owner_device_os_a1
      • content_owner_subtitles_a1
      • content_owner_combined_a1
      • content_owner_asset_basic_a1
      • content_owner_asset_province_a1
      • content_owner_asset_playback_location_a1
      • content_owner_asset_traffic_source_a1
      • content_owner_asset_device_os_a1
      • content_owner_asset_combined_a1

      これらのレポートタイプは 2016 年 9 月 15 日にサポート終了が発表され、2016 年 12 月 15 日を過ぎると生成されなくなりました。以前に生成したレポートは、作成後 180 日間は引き続きご利用いただけます。そのため、一部のレポートには 2017 年 6 月 15 日までアクセス可能でした。ただし、このレポートは利用できなくなるため、レポートに関連付けられたジョブも不要です。

2017 年 5 月 24 日

次の YouTube Reporting API レポートに関するすべてのレポート作成ジョブが削除されました。

  • content_owner_ad_performance_a1
  • content_owner_asset_estimated_earnings_a1
  • content_owner_estimated_earnings_a1

これらのレポートタイプは 2016 年 6 月 22 日にサポート終了が発表され、2016 年 9 月 22 日を過ぎると生成されなくなりました。以前に生成したレポートは、作成後 180 日間は引き続きご利用いただけます。したがって、一部のレポートには 2017 年 3 月 22 日までアクセス可能でした。ただし、このレポートは利用できなくなるため、レポートに関連付けられたジョブも不要です。

2017 年 5 月 22 日

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

  • YouTube Reporting API(一括レポート)

    • 動画の共有に使用されたサービスを識別する sharing_service ディメンションで、次の値がサポートされるようになりました。

      • 85: YouTube Music
      • 86: YouTube Gaming
      • 87: YouTube Kids
      • 88: YouTube TV

      さらに、ドキュメントで値 52 を識別するために使用する名前が Kakao(Kakao Talk)に更新され、値 73(Kakao Story)とより明確に区別できるようになりました。この変更は、API の動作や、これらのサービスと共有される動画の分類の変更を反映するものではありません。

  • YouTube Analytics API(ターゲットを絞ったクエリ)

    • sharingService ディメンションで次の値がサポートされるようになりました。

      • YOUTUBE_GAMING
      • YOUTUBE_KIDS
      • YOUTUBE_MUSIC
      • YOUTUBE_TV

2017 年 3 月 28 日

チャンネル所有者は、クリエイター ツールの YouTube アナリティクスから収益データにアクセスでき、YouTube Analytics API からも収益データにアクセスできるようになります。

2017 年 3 月 17 日

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

  • YouTube Analytics API は、YouTube Red の視聴者数に関連する redViewsestimatedRedMinutesWatched の指標をサポートしています。実際、これらの指標はしばらく前からサポートされており、2016 年 9 月 15 日に発表されたとおり、YouTube Reporting API ではすでに両方の指標がサポートされています。

    • redViews 指標は、YouTube Red メンバーが動画を視聴した回数を示します。
    • estimatedRedMinutesWatched 指標は、YouTube Red メンバーが動画を視聴した時間(分)を示します。

    チャンネル レポートコンテンツ所有者レポートのドキュメントを更新し、どのレポートが 2 つの新しい指標に対応しているかを記載しました。views 指標と estimatedMinutesWatched 指標をすでにサポートしているすべてのレポートでサポートされます。

2017 年 3 月 3 日

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

  • YouTube Reporting API(一括レポート)

    • date ディメンションの定義を修正しました。ディメンション値は、太平洋時間午前 12 時から始まり、指定した日、月、年の午後 11 時 59 分に終わる期間を指します。太平洋時間は UTC-7 または UTC-8 です(時期によって異なります)。

      通常、日付は 24 時間を表しますが、時計が前方に調整されている日付は 23 時間、時計が後方に調整されている日付は 25 時間を表します。(以前のドキュメントには、各日付が固有の 24 時間を表し、太平洋時間は常に UTC-8 であると記載されていました)。

      この修正は実際の API の動作を変更するものではありません。

    • 視聴が発生したデバイスのソフトウェア システムを識別する operating_system ディメンションで、次の値がサポートされるようになりました。
      • 22: Tizen
      • 23: Firefox
      • 24: RealMedia
    • content_owner_basic_a1 レポートタイプのすべてのレポートジョブが削除されました。このタイプのレポートのサポートは 2016 年 8 月 19 日に完全に終了しましたが、以前に生成された content_owner_basic_a1 レポートは、生成後 180 日間は使用可能でした。そのため、一部のレポートは 2017 年 2 月 19 日にはアクセス可能でした。ただし、このレポートは利用できなくなるため、レポートに関連付けられたジョブも不要です。

  • YouTube Analytics API(ターゲットを絞ったクエリ)

    • time periods に関連するディメンションの説明を修正し、ディメンション値が太平洋時間午前 0 時から午後 11 時 59 分までの特定の日、月、年の期間を参照するように修正しました。太平洋時間は UTC-7 または UTC-8 です(時期によって異なります)。

      通常、日付は 24 時間を表しますが、時計が前方に調整されている日付は 23 時間、時計が後方に調整されている日付は 25 時間を表します。(以前のドキュメントには、太平洋時間が UTC-8 であると記載されており、1 日が 24 時間を表していない可能性があることについては記載されていませんでした)。

      この修正は実際の API の動作を変更するものではありません。

    • チャンネル レポートのドキュメントを更新し、チャンネル レポートには現在、収益や広告のパフォーマンスの指標が含まれないことを記載しました。そのため、現在のところ、https://www.googleapis.com/auth/yt-analytics-monetary.readonly スコープではチャンネル レポートの金額データへのアクセス権は付与されていません。

    • operatingSystem ディメンションでは、次の 3 つの新しいディメンション値がサポートされています。
      • FIREFOX
      • REALMEDIA
      • TIZEN

2017 年 2 月 8 日

YouTube Analytics API で、オプションの include-historical-channel-data パラメータがサポートされるようになりました。このパラメータは、コンテンツ所有者レポートを取得する場合にのみ使用します。

このパラメータを使用すると、API レスポンスにチャンネルの総再生時間と、チャンネルがコンテンツ所有者にリンクされる前の期間の視聴データを含める必要があることを、コンテンツ所有者が示すことができます。デフォルトのパラメータ値は false です。つまり、API レスポンスにはデフォルトで、チャンネルがコンテンツ所有者にリンクされている時点以降の総再生時間と視聴データのみが含まれます。

これらのルールは、API リクエストが複数のチャネルのデータを取得する場合にも適用されます。

  • パラメータ値が false の場合、特定のチャンネルについて返される総再生時間と視聴回数のデータは、そのチャンネルがコンテンツ所有者にリンクされた日付に基づきます。

    なお、コンテンツ所有者にリンクされた日付が異なる可能性があることにご注意ください。API リクエストが複数のチャンネルのデータを取得し、パラメータ値が false の場合、API レスポンスには各チャンネルのリンク日に基づく総再生時間と視聴データが含まれます。
  • パラメータ値が true の場合、API リクエストで指定された開始日と終了日に基づいて、すべてのチャンネルの総再生時間と視聴データが返されます。

2016 年 12 月 15 日

次の YouTube Reporting API レポートはサポートが終了し、ドキュメントから削除されました。各レポートの新しいバージョンをご利用いただけます。(これらのレポートのサポート終了のお知らせは、2016 年 9 月 15 日に行われました)。

API リファレンス ドキュメントの現在のレポートタイプのリストも更新されました。

2016 年 11 月 11 日

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

    YouTube Reporting API では、3 つの新しい終了画面レポートと、これらのレポート用の新しいディメンションと指標がサポートされています。レポートには、動画の再生が停止した後に表示される終了画面のインプレッションとクリックスルーの統計情報が表示されます。

    • 終了画面のレポート

      • チャンネルの動画の終了画面レポートには、チャンネルのすべての動画の統計情報が含まれます。
      • コンテンツ所有者の動画の終了画面レポートには、コンテンツ所有者のチャンネルの動画の統計情報が含まれます。
      • コンテンツ所有者のアセットの終了画面レポートには、動画に関連付けられているアセットの統計情報が含まれ、その後に終了画面が表示されます。

    • 終了画面のサイズ

    • 終了画面に関する指標

      注: 終了画面に関する指標のデータは、2016 年 5 月 1 日以降のものです。

    • 動画に終了画面を追加する方法について詳しくは、YouTube ヘルプセンターをご覧ください。

    • 以下のレポートはサポートが終了し、ドキュメントから削除されました。各レポートの新しいバージョンをご利用いただけます。(これらのレポートのサポート終了のお知らせは、2016 年 6 月 22 日に行われました)。

    2016 年 11 月 8 日

    この更新には、YouTube Analytics API に次の変更が含まれています。

    • 次のリストの指標は完全に非推奨になり、サポートされなくなりました。2016 年 8 月 10 日にお知らせしたとおり、同じデータを参照する新しい指標はすでにサポートされています。次の表に、非推奨の指標名と新しい指標名を示します。

      サポートが終了した指標 新しい指標
      adEarnings estimatedAdRevenue
      impressionBasedCpm cpm
      impressions adImpressions
      redPartnerRevenue estimatedRedPartnerRevenue

    2016 年 10 月 27 日

    このたび、システム管理の広告収益レポートが自動的に生成されるようになりました。このレポートは、YouTube Studio の [レポート] セクションで該当するレポートにアクセスできるコンテンツ所有者に提供されます。システム管理の新しい API レポートは、手動でダウンロードできるクリエイター ツール レポートからも利用可能なデータにプログラマティックにアクセスできるように設計されています。

    システム管理レポートの概要では、新しいレポートの概要と、API を使用してレポートを取得するプロセスについて説明しています。このプロセスは、YouTube アナリティクスの一括レポートを取得するプロセスとは若干異なります。これは、パートナーがレポートを生成するためにジョブのスケジュールを設定する必要がないためです。

    reportType リソースの id プロパティが更新され、API を使用してアクセスできるシステム管理レポートのリストが含まれるようになりました。

    • 動画ごとの全世界における月間広告収益
    • 動画ごとの国別広告収入(日別)
    • アセットごとの月間全世界の広告収益
    • アセットごとの、国ごとの日別広告収益
    • 申し立て(このレポートに収益データは含まれません)

    2016 年 9 月 27 日

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

    YouTube Analytics API の uniques 指標が非推奨になりました。これは主要な指標ではなく、2016 年 10 月 31 日までサポートされます。

    2016 年 9 月 15 日

    このアップデートには、YouTube Reporting API に関する以下の変更が含まれています。

    • この API では、YouTube Red の視聴者数に関する 2 つの新しい指標がサポートされています。

      • red_views: YouTube Red メンバーが動画を視聴した回数。
      • red_watch_time_minutes: YouTube Red メンバーが動画を視聴した時間(分)。

    • この API では、20 個のレポートの新しいバージョンがサポートされています。新しいバージョンはすべて、新しい red_views 指標と red_watch_time_minutes 指標をサポートしています。

      各レポートについて、新しいレポートタイプ ID の数字は古いレポートタイプ ID の数値よりも 1 つ大きくなります。(これらのレポートの旧バージョンはサポートが終了しています)。詳細については、この変更履歴で後述します。たとえば、channel_basic_a1 レポートはサポートが終了し、channel_basic_a2 レポートに置き換えられました。

      新しいレポートタイプ ID は次のとおりです。

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

      上記の古いバージョンのレポートのいずれかを作成するジョブがすでにある場合は、名前を変更したレポート用に新しいジョブを作成する必要があります。新しいバージョンのレポートのリリースに伴い、次のバージョンのレポートのサポートが終了しました。

      • channel_basic_a1
      • channel_province_a1
      • channel_playback_location_a1
      • channel_traffic_source_a1
      • channel_device_os_a1
      • channel_subtitles_a1
      • channel_combined_a1
      • content_owner_basic_a2
      • content_owner_province_a1
      • content_owner_playback_location_a1
      • content_owner_traffic_source_a1
      • content_owner_device_os_a1
      • content_owner_subtitles_a1
      • content_owner_combined_a1
      • content_owner_asset_basic_a1
      • content_owner_asset_province_a1
      • content_owner_asset_playback_location_a1
      • content_owner_asset_traffic_source_a1
      • content_owner_asset_device_os_a1
      • content_owner_asset_combined_a1

      これらのレポートのジョブがある場合、2016 年 12 月 15 日以降は、そのジョブに関する新しいレポートが生成されることはありません。生成されたレポートは、作成後 180 日間利用できます。

    2016 年 8 月 19 日

    このアップデートには、YouTube Reporting API に関する以下の変更が含まれています。

    • content_owner_basic_a1 レポートのサポートが完全に終了し、ドキュメントから削除されました。YouTube では、この種類の新しいレポートは生成されなくなりますが、すでに生成されているレポートは、生成後 180 日間は使用できます。

      content_owner_basic_a1 レポートは、2016 年 5 月 19 日のリビジョン履歴エントリにあるように、content_owner_basic_a2 レポートに置き換えられます。

    2016 年 8 月 11 日

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

    • 新たに公開された YouTube API サービス利用規約(以下「新しい利用規約」)には、現在の利用規約に加えられたさまざまな更新が含まれています。詳細については、YouTube Engineering and Developers ブログをご覧ください。2017 年 2 月 10 日から適用される利用規約の更新に加えて、この更新には、デベロッパーが準拠する必要があるポリシーの説明に役立つ補足ドキュメントがいくつか含まれています。

      新しいドキュメントの一覧については、更新版利用規約の変更履歴をご覧ください。また、本利用規約または補足書類に対する今後の変更についても、その変更履歴にて説明いたします。ドキュメントのリンクから、その変更履歴の変更内容を一覧表示する RSS フィードを登録できます。

    2016 年 8 月 10 日

    この更新には、次の変更が含まれます。

    • YouTube Analytics API(ターゲットを絞ったクエリ)

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

        次の表に示す指標はサポート終了となります。それと同時に、同じデータを参照する新しい指標が導入されています。つまり、古い指標の名前が変更されますが、YouTube Analytics API では、表に記載されているサポート終了日まで両方の指標名がサポートされます。

        以前の指標名 新しい指標名 サポート日
        earnings estimatedRevenue 2017 年 8 月 10 日
        adEarnings estimatedAdRevenue 2016 年 11 月 4 日
        redPartnerRevenue estimatedRedPartnerRevenue 2016 年 11 月 4 日
        impressionBasedCpm cpm 2016 年 11 月 4 日
        impressions adImpressions 2016 年 11 月 4 日

        なお、earnings 指標はコア指標だったため、この発表日から 1 年間サポートされます。その他の指標(主要指標ではない)は、2016 年 11 月 4 日までの 3 か月間サポートされます。

        たとえば 2016 年 11 月 4 日までは、API リクエストで impressionBasedCpm 指標、cpm 指標、またはその両方を指定できます。ただし、この日以降は cpm 指標のみがサポートされます。

      • insightTrafficSourceType ディメンションでは、次の 2 つの新しいディメンション値がサポートされています。
        • CAMPAIGN_CARD: このトラフィック ソースはコンテンツ所有者レポートでのみサポートされています。これは、コンテンツ所有者が視聴済みコンテンツを宣伝するために使用した、申し立てが行われたユーザー アップロード動画からの視聴であることを示します。
        • END_SCREEN: 別の動画の終了画面から発生した視聴に関するデータ。

        どちらの新しいトラフィック ソースについても、traffic source detail レポートを取得できます。どちらの場合も、insightTrafficSourceDetail ディメンションは、視聴者の参照元の動画を識別します。

      • adType ディメンションで、値 auctionBumperInstream がサポートされるようになりました。これは、最長 6 秒間のスキップ不可の動画広告で、動画を視聴する前に再生されることを意味します。

    • YouTube Reporting API(一括レポート)

      • traffic_source_type ディメンションで次の値がサポートされるようになりました。
        • 19: このトラフィック ソースはコンテンツ所有者レポートでのみサポートされています。これは、コンテンツ所有者が視聴済みコンテンツを宣伝するために使用した、申し立てが行われたユーザー アップロード動画からの視聴であることを示します。
        • 20: 別の動画の終了画面から発生した視聴に関するデータ。

        どちらの新しいトラフィック ソースでも、視聴者の参照元となった動画は traffic_source_detail ディメンションで識別されます。

      • API のコア指標のリストが修正され、estimated_partner_revenue をコア指標として表示し、そのリストから earnings を削除しました。(earnings 指標は、これまで YouTube Reporting API ではサポートされていません)。

      • ad_type ディメンションで、バンパー広告(最長 6 秒のスキップ不可の動画広告で、動画が視聴される前に再生される)を表す値 19 がサポートされるようになりました。

    2016 年 7 月 18 日

    この更新には、次の変更が含まれます。

    • YouTube Analytics API(ターゲットを絞ったクエリ)

      • 以下のチャンネル レポートでサポートされている指標のリストが更新され、カード指標が追加されました。実際、これらのレポートでのカード指標のサポートは 2016 年 6 月 28 日に追加されました。変更の詳細は、その日付の変更履歴の項目で確認できます。次のレポートがあります。
        • 米国の州での基本的なユーザー アクティビティ
        • 特定期間の米国各州におけるユーザー アクティビティ
        • 州別のユーザー アクティビティ
        • 登録済みステータス別のユーザー アクティビティ
        • 州ごとの登録済みステータス別のユーザー アクティビティ
        • 州別の上位の動画
        • チャンネル登録者または未登録の視聴者向けの上位の動画
      • チャンネル視聴者維持率レポートコンテンツ所有者の視聴者維持率レポートの両方で、フィルタのリストを修正し、video フィルタが必須で、group フィルタがサポートされていないことを反映しました。

        以前は、どちらのレポートのドキュメントにも、どちらか一方のフィルタしか使えないか、どちらも使わないとレポートを取得できると誤って記載されていました。

    • YouTube Reporting API(一括レポート)

      • API の概要で、レポートのダウンロード URL の取得方法の説明を更新し、データが利用できない日についてはダウンロード可能なレポートを生成する旨を明記しました。これらのレポートにはヘッダー行が含まれますが、追加データは含まれません。この情報は、同じドキュメントの「レポートの特性」セクションで 2016 年 4 月 12 日にすでに更新されています。
      • content_owner_asset_cards_a1 レポートのディメンションのリストが修正され、レポートで card_id ディメンションが使用されるようになりました。以前のドキュメントでは、ディメンション名が誤って card_title と記載されていました。

    2016 年 6 月 28 日

    YouTube Analytics API のドキュメントが更新され、多数のチャンネル レポートとコンテンツ所有者レポートでカード指標がサポートされるようになりました。新たにサポートされる指標は次のとおりです。

    この指標は、次のタイプのレポートでサポートされています。

    2016 年 6 月 22 日

    このアップデートには、YouTube Reporting API に関する以下の変更が含まれています。最初の変更は API 全般に関するもので、残りの変更はコンテンツ所有者レポートにのみ影響します。

    • API の概要のレポートの特性セクションを更新し、レポートを生成してから 180 日間は API 経由で利用できることを明確にしました。

      以前は、API リクエストの送信日から最大 180 日間、レポートを参照できると記載されていました。技術的には正しいものの、原文はせいぜい混乱を招くものでした。

    • API では、3 つのレポートの新しいバージョンがサポートされています。そのうち 2 つのレポートには、新しい指標と名前が変更された指標も含まれています。

      • content_owner_ad_rates_a1 レポートは、「content_owner_ad_performance_a1」レポートの新しいバージョンです。名前が新しくなったレポートは、従来版と同じになります。

      • 新しいバージョンが含まれる 2 つのレポートの名前が変更されました。

        • content_owner_estimated_earnings_a1 レポートの新しいバージョンの名前は「content_owner_estimated_revenue_a1」です。
        • content_owner_asset_estimated_earnings_a1 レポートの新しいバージョンの名前は「content_owner_asset_estimated_revenue_a1」です。

        名前が新しくなったレポートは、以前のレポートと以下の点で異なります。

      これらのレポートの古いバージョンを作成するジョブがすでにある場合は、名前を変更したレポート用に新しいジョブを作成する必要があります。新しいバージョンのレポートのリリースに伴い、content_owner_ad_performance_a1content_owner_estimated_earnings_a1content_owner_asset_estimated_earnings_a1 レポートのサポートが終了しました。

      これらのレポートのジョブがある場合、2016 年 9 月 22 日以降は、それらのジョブの新しいレポートが生成されることはありません。生成されたレポートは、作成後 180 日間利用できます。

    • reportType リソースの id プロパティの定義が更新され、利用可能なレポートの現在のセットが反映されました。

    • ドキュメントでは、2 つの指標の名前を、レポートに表示される名前に合わせて修正しました。これは単なるドキュメントの修正であり、実際のレポートの内容の変更を反映するものではありません。

      • estimated_partner_adsense_revenue 指標の名前が estimated_partner_ad_sense_revenue に更新されました。ただし、この指標が表示されるのは、今回の更新でサポートが終了する 2 つのレポートのみです。前述のとおり、これらのレポートの新しいバージョンでは、この指標の名前が estimated_partner_ad_auction_revenue に変更されました。
      • estimated_partner_doubleclick_revenue 指標の名前が estimated_partner_double_click_revenue に更新されました。なお、この指標が表示されるのは、今回の更新でサポートが終了する 2 つのレポートのみです。前述のとおり、これらのレポートの新しいバージョンでは、この指標の名前が estimated_partner_ad_reserved_revenue に変更されました。

    • Reporting API のディメンションに関するドキュメントを更新し、elapsed_video_time_percentage プロパティと audience_retention_type プロパティを列挙しなくなりました。これらのディメンションは現在、API を通じて利用できるどのレポートでもサポートされていません。

    2016 年 5 月 19 日

    このアップデートには、YouTube Reporting API に関する以下の変更が含まれています。

    • この API は、新しいバージョンのコンテンツ所有者向けのユーザー アクティビティ レポートをサポートしています。新しいレポートのレポートタイプ ID は content_owner_basic_a2 です。以前のバージョンのレポート content_owner_basic_a1 とは異なり、新しいバージョンでは likes 指標と dislikes 指標がサポートされています。

      content_owner_basic_a1 レポートを作成するジョブがすでに存在する場合でも、content_owner_basic_a2 レポート用に新しいジョブを作成する必要があります。YouTube は、コンテンツ所有者を新しいレポート バージョンに自動的に移行したり、新しいレポート バージョンを生成するジョブを自動的に作成したりすることはありません。一部の実装では、新しい予期しないジョブの外観が互換性を破る変更になることがあります。

      新しいレポートのリリースに伴い、content_owner_basic_a1 レポートは非推奨になりました。そのレポートのジョブがある場合、2016 年 8 月 19 日以降は、そのジョブの新しいレポートが生成されることはありません。生成されたレポートは、作成後 180 日間利用できます。

    • reportTypejobreport リソースはすべて、関連するリソースが非推奨のレポートタイプであるかどうかを識別する新しいプロパティをサポートしています。

      • reportType リソースの deprecateTime プロパティには、レポートタイプのサポートを終了する日時を指定します。このプロパティで設定されるのは、サポート終了が発表されたレポートの値のみで、YouTube がそのタイプのレポートの生成を停止する日付を表します。

        レポートタイプのサポート終了が発表されると、YouTube はそのタイプのレポートをさらに 3 か月間生成します。たとえば、2016 年 5 月 19 日の今回の更新では、content_owner_basic_a1 レポートのサポート終了についてお知らせしています。したがって、そのレポートタイプの deprecateTime は 2016 年 8 月 19 日を指定します。この日を過ぎると、YouTube はそのタイプのレポートの生成を停止します。

      • job リソースの expireTime プロパティは、求人が期限切れになった日時または期限切れになる日時を指定します。このプロパティは、ジョブに関連付けられたレポートタイプが非推奨である場合、またはジョブに対して生成されたレポートが長期間ダウンロードされていない場合に値を持ちます。この日付は、そのジョブの新しいレポートを YouTube が生成しなくなる日付を示します。

      • report リソースの jobExpireTime プロパティは、レポートに関連付けられている求人が期限切れになった日時または期限切れになる日時を指定します。このプロパティの前の項目で説明したように、このプロパティには job リソースの expireTime プロパティと同じ値が含まれます。

    • サポートが終了したレポートのジョブを作成しようとすると、jobs.create メソッドが 400 HTTP レスポンス コード(Bad Request)を返すようになりました。また、このメソッドのドキュメントには、API リクエストが失敗する原因となるその他の理由がいくつか記載されています。

    2016 年 4 月 12 日

    このアップデートには次の変更が含まれます。この変更は YouTube Reporting API にのみ影響します。

    • YouTube では、レポートジョブが最初にスケジュールされた時点から 180 日前までのデータが生成されるようになりました。これまで、Reporting API は過去のデータを配信しませんでした。この変更は、このお知らせより前に作成されたものを含むすべてのジョブに影響します。

      過去のレポートは利用可能になり次第投稿されます。ただし、求人情報のすべての履歴データが投稿されるまでには約 1 か月かかります。つまり、レポートジョブをスケジュールしてから 1 か月後に、約 7 か月分のデータにアクセスできるようになります。(このお知らせの前に作成された求人の履歴データはすべて、お知らせから 1 か月以内に投稿する必要があります)。

      過去のデータは 2015 年 7 月 1 日時点のもののみ利用可能です。そのため、2015 年 12 月 28 日より前に作成されたジョブの過去のデータは 180 日未満になります。

      この変更については、Reporting API の概要に新たに追加された過去のデータセクションをご覧ください。

    • YouTube Reporting API の概要のレポートの特性セクションが更新され、以下の変更が加えられました。

      • ドキュメントには、レポートは生成後 180 日間利用できるため、API クライアントはダウンロードできることが明記されています。以前は、API リクエストが送信された日の 6 か月前まではレポートが利用可能であると記載されていました。

      • データが利用できない日についても API でダウンロード可能なレポートが生成されることを反映してドキュメントを更新しました。これらのレポートにはヘッダー行が含まれますが、追加データは含まれません。

    • YouTube Reporting API では、まもなく、広告収益データや YouTube Premium 定期購入収益データを含む、自動生成されたシステム管理レポート一式がサポートされるようになります。このレポートは、YouTube クリエイター ツールで手動でダウンロードできる収益レポートにすでにアクセスできるコンテンツ所有者にご利用いただけます。したがって、この新しい API 機能では、そのデータにプログラムからアクセスできるようになります。

      システム管理レポートのリリースに先立ち、API で次の変更が発表されています。

      • job リソースの新しい systemManaged プロパティは、このリソースがシステム管理レポートを生成するジョブを記述しているかどうかを示します。YouTube は、YouTube コンテンツ所有者に対してシステム管理レポートを自動的に生成します。コンテンツ所有者は、そのレポートを作成するジョブを変更したり削除したりすることはできません。

      • jobs.list メソッドの新しい includeSystemManaged パラメータは、API レスポンスにシステム管理レポートのジョブを含める必要があるかどうかを示します。パラメータのデフォルト値は false です。

      • jobs.reports.list メソッドの新しい startTimeAtOrAfter パラメータは、レポート内の最も古いデータが指定した日付以降の場合にのみ、API レスポンスにレポートが含まれるように指定します。同様に、startTimeBefore パラメータは、レポート内の最も古いデータが指定した日付より前の場合にのみ、API レスポンスにレポートが含まれることを示します。

        レポートが作成された時刻に関連するメソッドの createdAfter パラメータとは異なり、新しいパラメータはレポート内のデータに関係します。

      • reportType リソースの新しい systemManaged プロパティは、リソースがシステム管理のレポートを記述しているかどうかを示します。

      • reportTypes.list メソッドの新しい includeSystemManaged パラメータは、API レスポンスにシステム管理レポートを含めるかどうかを示します。パラメータのデフォルト値は false です。

    2016 年 3 月 28 日

    YouTube Reporting API と YouTube Analytics API が、いくつかの追加共有サービスの視聴統計情報を返すようになりました。

    • YouTube Reporting API の sharing_service ディメンションでは、次の新しい値がサポートされています。
      • 82: iOS システム アクティビティ ダイアログ
      • 83: Google 受信トレイ
      • 84: Android メッセンジャー
    • YouTube Analytics API では、sharingService ディメンションは次の新しい値をサポートしています。
      • ANDROID_MESSENGER: Android メッセンジャー
      • INBOX: Google 受信トレイ
      • IOS_SYSTEM_ACTIVITY_DIALOG: iOS システム アクティビティ ダイアログ

    2016 年 3 月 16 日

    このアップデートには、YouTube Reporting API と YouTube Analytics API の両方に影響する次の変更が含まれます。

    YouTube Reporting API

    • playback_location_type ディメンションでは、次の 2 つの新しいディメンション値がサポートされています。
      • 7: YouTube のトップページまたはホーム画面、ユーザーの登録チャンネル フィード、YouTube の別のブラウジング機能で行われた視聴に関するデータを示します。
      • 8: YouTube 検索結果ページで直接発生した視聴回数に関するデータ。
    • traffic_source_type ディメンションで、ディメンション値として 18 がサポートされるようになりました。この値は、動画再生が再生リストのすべての動画を一覧表示するページで発生していることを示します。このソースはソースタイプ 14 とは異なります。ソースタイプは、再生リストの一部として動画が再生されている最中に発生した視聴回数を示します。

    YouTube Analytics API

    • insightPlaybackLocationType ディメンションでは、次の 2 つの新しいディメンション値がサポートされています。
      • BROWSE: YouTube のトップページまたはホーム画面、ユーザーの登録チャンネル フィード、YouTube の別のブラウジング機能で行われた視聴に関するデータを示します。
      • SEARCH: YouTube 検索結果ページで直接発生した視聴回数に関するデータ。
    • insightTrafficSourceType ディメンションで、ディメンション値として YT_PLAYLIST_PAGE がサポートされるようになりました。この値は、動画再生が再生リストのすべての動画を一覧表示するページで発生していることを示します。このソースは、再生リストの一部として動画が再生されている間に視聴回数が発生したことを示す PLAYLIST ソースタイプとは異なります。

    2016 年 2 月 8 日

    YouTube Analytics API でサポートされている指標のリストが更新され、この API でサポートされている指標としてカード指標が表示されなくなりました。(その API のレポートには、カード指標のサポートについて記載されたものはありませんでした)。

    なお、YouTube Reporting API を使用してカード指標を取得することは引き続き可能です。YouTube Reporting API は、さまざまなチャンネルコンテンツ所有者のレポートでこれらの指標をサポートしています。

    2016 年 1 月 6 日

    YouTube Reporting API と YouTube Analytics API はどちらも、Chromecast デバイス経由で発生した視聴を明確に識別するようになりました。

    • YouTube Reporting API では、operating_system ディメンションで値 21 を使用して、Chromecast 経由で発生した視聴を識別できます。
    • YouTube Analytics API では、operatingSystem ディメンションで値 CHROMECAST を使用して、Chromecast 経由で発生した視聴を識別します。

    2015 年 12 月 21 日

    ドキュメントでは、annotation_clickable_impressions 指標と annotation_closable_impressions 指標の名前が、レポートで返される名前と一致するように更新されました。以前は、名前は clickable_annotation_impressions および closable_annotation_impressions と記載されていました。

    2015 年 12 月 18 日

    欧州連合(EU)の法律により、EU 域内のエンドユーザーに対して特定の開示を行い、エンドユーザーから同意を得ることが義務付けられています。そのため、欧州連合のエンドユーザーに対しては、EU ユーザーの同意ポリシーを遵守する必要があります。YouTube API 利用規約に、この要件に関するお知らせを追加しました。

    2015 年 12 月 15 日

    このアップデートには以下の変更が含まれており、これらはすべて YouTube Analytics API に影響します。

    • YouTube Analytics API で、新たに 3 つの再生詳細ディメンションがサポートされるようになりました。これらのディメンションは、さまざまなチャンネル レポートとコンテンツ所有者レポートで使用できます。

      • liveOrOnDemand: このディメンションは、レポートのデータが、ライブ配信中に発生したユーザー アクティビティを示しているかどうかを示します。
      • subscribedStatus: このディメンションは、データ内のユーザー アクティビティ指標が、動画または再生リストのチャンネルに登録している視聴者に関連付けられているかどうかを示します。
      • youtubeProduct: このディメンションは、ユーザー アクションが発生した YouTube プロパティを識別します。指定できる値は、YouTube の中核ウェブサイト(または YouTube アプリ)、YouTube Gaming、YouTube Kids です。

      ドキュメントが更新され、新しい再生詳細レポートがチャンネルコンテンツ所有者が利用できるようになりました。また、他の多くのレポートも更新され、これらのディメンションのうち 1 つ以上を必要に応じてディメンションやフィルタとして使用できるようになりました。

    • レポートを説明する表の形式が変更され、各レポートの取得に使用できるディメンション、指標、フィルタの有効な組み合わせを簡単に特定できるようになりました。チャネルの「デバイスタイプ」レポートの新しい形式は以下の表のとおりです。

      目次
      サイズ:
      必須 deviceType
      0 個以上を使用してください dayliveOrOnDemandsubscribedStatusyoutubeProduct
      指標:
      1 つ以上使用 viewsestimatedMinutesWatched
      フィルタ:
      0 または 1 を使用してください countryregionalContinentsubContinent
      0 または 1 を使用してください videogroup
      0 個以上を使用してください operatingSystemliveOrOnDemandsubscribedStatusyoutubeProduct

      必須フィールドとオプション フィールドに関する用語については、チャンネル レポートとコンテンツ所有者レポートのドキュメントをご覧ください。

    • YouTube Analytics API は、複数の値(videoplaylistchannel)をサポートするフィルタから API ユーザーがデータを取得できないエンティティを自動的に削除するようになりました。これまでは、指定したアイテムの少なくとも 1 つに API ユーザーがアクセスできない場合、API サーバーはエラーを返すだけでした。

      たとえば、ユーザーが API リクエストを送信し、video フィルタで 20 個の動画 ID がリストされたとします。ユーザーは 18 本の動画を所有している。一方、動画 ID は別のチャンネルが所有する動画を示し、別の動画 ID は削除されたために存在しない動画を示します。この場合、API サーバーはエラーを返すのではなく、ユーザーがアクセスできない 2 つの動画を削除します。API レスポンスには、API ユーザーが所有する 18 本の動画のデータが含まれます。

    • 空の YouTube アナリティクス group のデータをリクエストすると、API はエラーではなく空のデータセットを返すようになりました。

    • YouTube Analytics API の groupItems.insert メソッドは、エンティティをグループに追加しようとしたものの、そのエンティティへのアクセス権がない場合に、未承認のエラー(403 HTTP レスポンス コード)を返すようになりました。以前は、この API でグループにエンティティを追加することはできましたが、後でそのグループのレポートデータを取得しようとすると、未承認のエラーが返されました。

    • YouTube Analytics API の groups.list メソッドでページ分割がサポートされるようになりました。API レスポンスに使用可能なグループがすべて含まれていない場合、レスポンスの nextPageToken パラメータには、結果の次のページを取得するために使用できるトークンを指定します。メソッドの pageToken パラメータをその値に設定して、追加の結果を取得します。

    2015 年 11 月 10 日

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

    • YouTube Analytics API で redPartnerRevenue 指標がサポートされるようになりました。この指標は、選択したレポート ディメンションで YouTube Red の定期購入から得られた推定収益の合計をレポートします。指標の値は音楽コンテンツと音楽以外のコンテンツの両方からの収益を反映しており、月末に調整される場合があります。

      YouTube Analytics API のコンテンツ所有者レポートのリストが更新され、redPartnerRevenue 指標をサポートする動画レポートを識別できるようになりました。

    • YouTube Analytics API の人気の動画レポートの定義に、このレポートでの収益指標(earningsadEarningsgrossRevenuemonetizedPlaybacksplaybackBasedCpmimpressionsimpressionBasedCpm)もサポートされるようになりました。

    2015 年 10 月 29 日

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

    • YouTube Reporting API の date ディメンションのドキュメントを修正しました。日付が太平洋時間(UTC-8)午前 0 時からの 24 時間を参照するように修正しました。以前の文書には、日付が午前 12 時(GMT)に始まったと記載されていました。

      また、YouTube Analytics API のドキュメントが更新され、日付に関連するすべてのディメンション(day7DayTotals30DayTotalsmonth)が太平洋時間(UTC-8)の午前 12 時から始まっている日付を参照することを明記しました。

    • YouTube Reporting API の jobs.reports.list() メソッドで、createdAfter クエリ パラメータがサポートされるようになりました。このパラメータを指定すると、指定した日時以降に作成されたレポート(バックフィル データを含む新しいレポートを含む)のみが API レスポンスにリストされることを示します。このパラメータ値は、返されたデータに関連付けられた日付ではなく、レポートが作成された時刻に関するものです。

      パラメータ値は、RFC3339 UTC「Zulu」形式のタイムスタンプで、精度はマイクロ秒です。例: "2015-10-02T15:01:23.045678Z"

      YouTube Reporting API のベスト プラクティスも更新され、createdAfter パラメータを使用して同じレポートが繰り返し処理されないようにする方法について説明しています。

    • job リソースの createTime プロパティと、report リソースの startTimeendTimecreateTime プロパティの定義がすべて修正され、プロパティ値がナノ秒ではなくマイクロ秒に正確であることに注目しました。また、すべての定義で、プロパティ値がタイムスタンプであることを正確に反映するようになりました。

    2015 年 10 月 8 日

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

    • YouTube Analytics API の sharingService ディメンションのドキュメントが更新され、可能なディメンション値のリストが追加されました。このリストには、新たにサポートされるサービスがいくつか含まれています。

      YouTube Reporting API の sharing_service ディメンションの定義も更新され、新たにサポートされる値が一覧表示されるようになりました。59 より大きい列挙値は、リスト内の新しい値です。

    2015 年 9 月 24 日

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

    • 新しい YouTube Reporting API は、チャンネルまたはコンテンツ所有者の YouTube アナリティクスのデータを含む一括データレポートを取得します。大規模なデータセットをインポートし、そのデータのフィルタリング、並べ替え、マイニングを行うためのツールを提供するアプリケーション向けに設計されています。

      各 YouTube Reporting API レポートには、事前定義されたディメンションと指標のセットが含まれています。(YouTube Analytics API レポートでも指標とディメンションが使用されます)。レポートでは、データの各行にはディメンション値の組み合わせが一意ではありません。ディメンション値に基づいて行のデータを集計し、個々の動画、国、公開中の動画、登録済みユーザーなどの指標を計算できます。

      API を使用してレポート作成ジョブのスケジュールを設定できます。レポート作成ジョブごとに、YouTube が生成するレポートを指定します。ジョブを設定すると、YouTube によって日次レポートが生成されます。このレポートは非同期でダウンロードできます。各レポートには、固有の 24 時間分のデータが含まれます。

    • YouTube Analytics API と YouTube Reporting API はどちらも異なる API ですが、デベロッパーは YouTube アナリティクス データを取得できます。どちらの API も同様のデータセットへのアクセスを提供しているため、2 つの API のドキュメントは 1 つのドキュメント セットとして公開されます。

      • ドキュメント セットの [ガイド] タブには、API リクエストの承認手順など、両方の API に共通する情報が含まれています。
      • [一括レポート] タブには、YouTube Reporting API に関するリファレンス ドキュメントなどのコンテンツがあります。
      • [ターゲット クエリ] タブには、YouTube Analytics API 向けのリファレンス ドキュメントやその他のコンテンツが表示されます。
      • [サンプル] タブには、2 つの API のいずれかで使用できるコードサンプルが一覧表示されます。
      • [Tools] タブには、デベロッパーが 2 つの API のいずれかを実装するために役立つ追加リソースが一覧表示されます。

    2015 年 8 月 20 日

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

    • API を理解しやすくするために、API ドキュメントが再構成されました。そのため、これらの変更には新機能は含まれていません。

      • ドキュメントには、利用可能なすべてのチャンネル レポートを一覧表示するページと、利用可能なすべてのコンテンツ所有者レポートを一覧表示するページが含まれています。以前は、ドキュメントにはチャンネルの動画レポート、チャンネルの再生リストレポートなどが別々のページになっていました。

      • 新しいデータモデルの概要は、API の仕組みをより明確に紹介することを目的としています。具体的には、YouTube が指標、ディメンション、フィルタを使用してレポートの値を計算する仕組みを詳しく説明することを目的としています。

      • レポートの取得に使用する API の reports.query メソッドについて、個別に説明するようになりました。そのページの情報は、以前他のいくつかのページに表示されていました。新しいページは、レポートを取得するために送信する必要がある情報をより簡単に特定できるように設計されています。

    2015 年 7 月 22 日

    この更新にはいくつかの変更が含まれており、これらはすべてコンテンツ所有者のみに適用されます。

    • 新しい指標「adEarnings」には、Google が販売したすべての広告ソースからの推定総収益(純収益)が含まれます。主要な指標ではありません。API は、すでに earnings 指標をサポートしているすべてのレポートで、adEarnings 指標をサポートします。

      また、指標 earnings の値には、Google 経由販売のすべての広告ソースと広告以外のソースからの総推定収益額が含まれるという事実を反映するよう、指標の定義を修正しました。以前の定義では、この指標には広告ソースからの収益のみが含まれると誤って記載されていました。

    • primaryAdGrossRevenue 指標は非推奨になりました。代わりに、grossRevenue 指標を使用して収益データを取得します。

    • サポートが終了した primaryAdGrossRevenue 指標に加えて、広告パフォーマンス レポートmonetizedPlaybacks 指標と playbackBasedCpm 指標がサポートされなくなりました。ただし、一部の動画レポートは引き続きこれらの指標をサポートしています。

    2015 年 6 月 1 日

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

    • この API では、動画レポート用に videosAddedToPlaylistsvideosRemovedFromPlaylists という 2 つの新しい指標がサポートされるようになりました。チャンネルコンテンツ所有者の動画レポートのリストが更新され、新しい指標に対応したレポートが示されています。

      • videosAddedToPlaylists – クエリの対象となる動画が YouTube 再生リストに追加された回数。対象の動画は、動画所有者の再生リストまたは他のチャンネルの再生リストに追加されている可能性があります。
      • videosRemovedFromPlaylists – クエリ範囲内の動画が YouTube 再生リストから削除された回数。対象の動画は、動画所有者の再生リストまたは他のチャンネルの再生リストから削除された可能性があります。

      どちらの指標にも、[後で見る] 再生リストなどのデフォルトの再生リストが含まれます。ただし、チャンネルのアップロード再生リストやユーザーの再生履歴など、動画が自動的に追加される再生リストはカウントされません。また、これらの指標には追加と削除の絶対数が反映されています。つまり、ユーザーが再生リストに動画を追加し、削除してから再び追加した場合、指標は 2 つの再生リストに追加され、1 つの再生リストから削除されたことを示しています。

      これらの指標のデータは、2014 年 10 月 1 日時点のものです。

    2015 年 3 月 31 日

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

    • favoritesAdded 指標と favoritesRemoved 指標は、今回の発表をもって非推奨となりました。これらはいずれも主要な指標であり、利用規約に規定されている非推奨ポリシーの対象となります。

    2015 年 3 月 16 日

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

    • 新しい currency パラメータを使用すると、収益指標を米ドル(USD)以外の通貨で取得できます。このパラメータが設定されている場合、API は earningsgrossRevenueplaybackBasedCpmimpressionBasedCpm の指標の値を指定された通貨に変換します。返される値は、毎日変化する為替レートを使用して計算された見積もりです。

      パラメータ値は、3 文字の ISO 4217 通貨コードです。デフォルト値は USD です。パラメータ定義には、サポートされている通貨コードのリストが含まれています。

    2015 年 2 月 25 日

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

    • この API では、YouTube アナリティクス グループを作成および管理する機能と、それらのグループのレポートデータを取得する機能がサポートされるようになりました。

      • グループの作成と管理

        この更新により、グループの作成と管理を行うための group リソースと groupItem リソースが導入されます。

        • group リソースは、アナリティクス グループを表します。アナリティクス グループとは、最大 200 個のチャンネル、動画、再生リスト、アセットで構成されるカスタム コレクションです。API は、このリソースに対して listinsertupdatedelete の各メソッドをサポートします。
        • groupItem リソースは、アナリティクス グループ内の項目を表します。API は、このリソースに対して listinsertdelete の各メソッドをサポートします。

        たとえば、groups.insert メソッドを使用してグループを作成し、groupItems.insert メソッドを使用してそのグループにアイテムを追加できます。

      • グループのレポートデータの取得

        ディメンションに関するドキュメントを更新し、group ディメンションを追加しました。このディメンションは、多くのチャンネル レポートコンテンツ所有者レポートのフィルタとして使用できます。group フィルタを使用すると、API はそのグループ内のすべての項目のデータを返します。現在のところ、API ではアセット グループのレポートを作成する機能はサポートされていません。

      YouTube アナリティクス グループについて詳しくは、YouTube ヘルプセンターをご覧ください。

    2015 年 2 月 13 日

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

    • この API では、show ディメンションがサポートされなくなりました。

    2014 年 8 月 28 日

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

    • API で、videoplaylistchannelshow ディメンションをフィルタとして使用する場合に、これらのディメンションに複数の値を指定できるようになりました。複数の値を指定するには、filters パラメータの値に、API レスポンスをフィルタリングする動画、再生リスト、チャンネル、または番組の ID のカンマ区切りのリストを設定します。このパラメータ値には、最大 200 個の ID を指定できます。

      同じフィルタに複数の値を指定した場合は、リクエストで指定したディメンションのリストにそのフィルタを追加することもできます。これは、特定のレポートでサポートされているディメンションとしてフィルタが表示されていない場合でも同じです。ディメンションのリストにフィルタを追加すると、API はフィルタ値を使用して結果をグループ化します。

      この機能の詳細については、filters パラメータの定義をご覧ください。

    2014 年 7 月 16 日

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

    • チャンネル レポートを取得するときに、ids パラメータの値を channel==MINE に設定することで、認証されたユーザーのチャンネルのデータを取得できるようになりました。(ids パラメータを channel==CHANNEL_ID に設定して、指定したチャネルのデータを取得することもできます)。

    • API で再生リスト レポートがサポートされるようになりました。このレポートには、再生リストのコンテキストで発生した動画再生回数に関連する統計情報が含まれます。再生リストのレポートは、チャンネルコンテンツ所有者が対象となります。

      再生リストのレポートはすべて、views 指標と estimatedMinutesWatched 指標をサポートしています。また、一部の再生リスト レポートは averageViewDuration 指標もサポートしています。

      また、再生リストのすべてのレポートで次の新しい指標がサポートされています。なお、これらの各指標には、ウェブ上で発生した再生リストの視聴回数のみが反映されます。

      • playlistStarts: 視聴者が再生リストの再生を開始した回数。
      • viewsPerPlaylistStart: 再生リストが再生されるたびに発生した動画の平均再生回数。
      • averageTimeInPlaylist: 再生リストの開始後に視聴者が再生リスト内の動画を視聴したと推定される平均時間(分単位)。

      再生リスト レポートを取得するリクエストでは、isCurated フィルタを使用する必要があります。このフィルタは 1isCurated==1)に設定する必要があります。

    • API で視聴者維持率レポートがサポートされるようになりました。このレポートでは、動画の視聴者維持率を測定できます。レポートの新しい elapsedVideoTimeRatio ディメンションは、対応する指標値ごとに動画の経過時間を測定します。

      • audienceWatchRatio 指標は、動画内の任意の時点でその動画を視聴している視聴者の絶対比率を示します。この比率は、動画の一部が視聴された回数と、動画の合計視聴回数を比較して算出されます。

        1 回の動画再生で、動画の一部が複数回(またはまったく再生されない)場合があります。たとえば、ユーザーが動画の同じ部分を巻き戻して複数回視聴した場合、その部分の絶対比率は 1 より大きくなる可能性があります。

      • relativeRetentionPerformance 指標は、長さが同程度の他の YouTube 動画と比較して、動画の再生中に視聴者をどの程度維持できているかを示します。値が 0 は、長さが同程度の他の動画よりも視聴者維持率が低いことを示し、値が 1 は、長さが同程度の他の動画よりも視聴者維持率が高いことを示します。中央値が 0.5 の場合、長さが同程度の動画の半分は視聴者の維持率が高く、残りの半分は低いことを示しています。

      また、audienceType フィルタを使用して、オーガニック ビュー、TrueView インストリーム広告の視聴回数、または TrueView インディスプレイ広告の視聴回数に関連付けられたデータのみを返すようにすることもできます。(オーガニック ビューは、動画の検索や関連動画のクリックなどのユーザー操作の直接的な結果です)。

    • API は、アノテーションに関連する新しい指標をいくつかサポートしています。以下の指標は、これまで指標 annotationClickThroughRateannotationCloseRate をサポートしていたレポートを使用して取得できます。

      新しい指標はすべて主要な指標であり、非推奨ポリシーが適用されます。ただし、新しい指標のデータは 2013 年 7 月 16 日時点のものです。(annotationClickThroughRate 指標と annotationCloseRate 指標のデータは 2012 年 6 月 10 日時点のものです)。

    • GOOGLE_SEARCH」は、insightTrafficSourceType ディメンションの個別の値としてレポートされなくなりました。代わりに、Google 検索結果からの参照はトラフィック ソースの種類「EXT_URL」に関連付けられます。そのため、insightTrafficSourceType フィルタを GOOGLE_SEARCH に設定する insightTrafficSourceDetail レポートを取得することもできなくなります。

    2014 年 1 月 31 日

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

    • コンテンツ所有者レポートのドキュメントを更新し、コンテンツ所有者が申し立てを行ったコンテンツ、またはアップロードしたコンテンツについて、subscribersGainedsubscribersLost の指標を取得できるようになったことを反映しました。

      この変更は、コンテンツ所有者向けの最初の基本統計情報レポートに表示されます。このレポートでは claimedStatus フィルタと uploaderType フィルタがサポートされるようになりました。

    2014 年 1 月 16 日

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

    • サンプル リクエストのドキュメントが再設計され、サンプルがカテゴリ別にグループ化されました。チャンネル レポートとコンテンツ所有者レポート用に最近リリースされたものと同様のタブ形式が使用されています。新しい設計では、例は次のカテゴリに分類されます。

      • 基本統計情報
      • 時間ベース
      • 地域
      • 再生場所
      • トラフィック ソース
      • 端末/ OS
      • ユーザー属性
      • ソーシャル
      • 収益/広告(コンテンツ所有者レポートのみ)

    • サンプル リクエストのドキュメントに、チャンネル レポートまたはコンテンツ所有者レポートのいずれかで州固有のデータを取得するための新しい例を追加しました。

      • 米国の州とワシントン D.C. の州別の指標: このレポートでは、チャンネルの動画の視聴回数の州ごとの内訳やその他の統計情報が取得されます。データの対象は米国の州とワシントン D.C です。この例では、province ディメンションを使用し、filters パラメータを使用して、レスポンスに米国の結果のみが含まれるように制限しています。

      • カリフォルニア州の視聴者のユーザー属性(年齢層と性別): このレポートでは、チャンネルの動画を視聴したカリフォルニア州の視聴者の年齢層と性別に関する統計情報を取得します。また、コンテンツ所有者レポートの場合は、コンテンツ所有者が申し立てを行ったコンテンツについて統計情報を取得します。この例では、filters パラメータを使用して、レスポンスに特定の都道府県のデータのみが含まれるようにします。

    • province ディメンションの定義を更新し、dimensions パラメータ値に province が含まれている場合、リクエストは filters パラメータ値に country==US を含めることで、データを米国に限定する必要もあります。

    2014 年 1 月 6 日

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

    • サポートされるチャンネル レポートとコンテンツ所有者レポートをリストするドキュメントのデザインが一新されました。各ドキュメントでは、可能なすべてのレポートを列挙した表を提供するのではなく、レポートをカテゴリ別にグループ化しています。

      • 基本統計情報
      • 時間ベース
      • 地域
      • 再生場所
      • トラフィック ソース
      • 端末/ OS
      • ユーザー属性
      • ソーシャル
      • 人気の動画

      各ドキュメントには、これらのカテゴリがタブのリストとして表示されます。いずれかのタブをクリックすると、そのカテゴリでサポートされているレポートが表示されます。

    • API で、provincecontinentsubContinent の 3 つの新しい地域ディメンションがサポートされるようになりました。

      • province ディメンションを使用すると、米国の州とコロンビア特別区の統計情報を取得できます。API では、このディメンションは次の 2 つの用途をサポートしています。

        • この API は、統計情報を州ごとに分類する 2 つのレポートをサポートしています。どちらのレポートもチャンネルコンテンツ所有者が利用できます。

          • コア統計情報レポートには、視聴回数や推定再生時間(分)など、いくつかの統計情報が表示されます。
          • 時間ベースのレポートには同じ統計情報が表示されますが、データは日別、7 日、30 日、または月単位で集計されます。

        • filters クエリ パラメータを使用すると、レポートに含める情報を特定の州の統計情報のみに制限できます。地域別レポート、再生場所レポート、トラフィック ソース レポート、デバイス レポート、オペレーティング システム レポート、ユーザー属性レポート、人気の動画レポートなど、さまざまなレポートでこの種類のフィルタリングがサポートされています。

      • continent ディメンションは、大陸を識別する国連(UN)統計地域コードを指定します。このディメンションはフィルタとしてのみ使用できます。

      • subContinent ディメンションは、大陸の小地域を識別する国際連合(UN)統計地域コードを指定します。このディメンションはフィルタとしてのみ使用できます。

        各亜地域は 1 つの大陸にのみ関連付けられるため、subContinent フィルタを使用する際に continent フィルタを使用する必要はありません。(実際、リクエストで両方のディメンションを使用すると、API からエラーが返されます)。

    • insightTrafficSourceDetail ディメンションに有効なフィルタ値として insightTrafficSourceTypePROMOTED が含まれないように、ドキュメントを修正しました。

    2013 年 9 月 30 日

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

    • YouTube Analytics API には、利用規約に記載されているサポート終了ポリシーが適用されます。ただし、API のコア以外のディメンションと指標は、非推奨ポリシーの対象ではありません。ディメンションmetricsのページを更新し、主要なディメンションと指標のリストを追加しました。さらに、これらのページの定義は、主要なディメンションと指標を明確に識別できるように更新されています。

    • API で、insightPlaybackLocationType ディメンションの値として EXTERNAL_APP がサポートされるようになりました。この更新に伴い、2013 年 9 月 10 日以降、再生数は MOBILE に分類されなくなります。ただし、この日付より前に発生したモバイルでの再生は引き続きその値に分類されます。

      今回のアップデートにより、モバイルでの再生は、再生が行われるアプリのタイプに応じて WATCHEMBEDDEDEXTERNAL_APP のいずれかに分類されるようになりました。

    • API で、insightTrafficSourceType ディメンションの値として PLAYLIST がサポートされるようになりました。この値は、動画再生が再生リストから参照されたことを示します。これまで、こうした視聴はディメンションの YT_OTHER_PAGE カテゴリを使って分類されていました。

    2013 年 7 月 16 日

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

    • 複数の詳細分析と指標を基準としてレポートを並べ替えられるようになりました。この機能を説明する新しい例として、複数のディメンション/指標によるリクエストの並べ替えがサンプル リクエストのドキュメントに追加されています。リクエストはトラフィック ソース データを取得し、sort パラメータ値は day,-views です。結果は時系列順に並べ替えられますが、各日の結果セット内では最初の行に最も多くの再生回数を生成したトラフィック ソースのデータが含まれ、2 番目の行にはその次に多くの再生回数を生成したソースのデータが含まれる、というように続きます。

    • API で、deviceTypeoperatingSystem という 2 つの新しいディメンションがサポートされるようになりました。これらのディメンションを使用して、視聴者が動画を視聴しているデバイスに関するデータを取得できます。API がサポートするのは、いずれかまたは両方のディメンションを使用するレポートです。

      • deviceType レポートでは、パソコン、モバイル、タブレットなど、さまざまな種類のデバイスの視聴回数と推定総再生時間を取得できます。operatingSystem フィルタを使用して、デバイスタイプのレポートに、特定のオペレーティング システム(AndroidiOS など)を搭載しているデバイスの統計情報のみが含まれるように制限することもできます。

      • operatingSystem レポートでは、Android、iOS、Linux などのさまざまなオペレーティング システムについて、視聴回数と推定総再生時間を取得できます。また、deviceType フィルタを使用して、オペレーティング システム レポートに特定の種類のデバイス(モバイル デバイスやタブレットなど)の統計情報のみが含まれるように制限することもできます。

      新しく追加された端末タイプおよびオペレーティング システムのレポートは、チャンネルおよびコンテンツ所有者に対してのみ使用可能です。

    • サンプル リクエストのドキュメントを更新し、チャンネルとコンテンツ所有者について、それぞれ 3 種類の端末レポートを追加しています。

    • insightPlaybackLocationType ディメンションから値 YT_OTHER が返されることがあります。この値は、ディメンションの他の値のいずれかで分類されていないビューを表します。

    May 23, 2013 年 5 月 23 日

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

    2013 年 5 月 10 日

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

    2013 年 5 月 6 日

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

    • この API では、総再生時間に関する指標(estimatedMinutesWatchedaverageViewDurationaverageViewPercentage)を、視聴回数に関する指標、エンゲージメント指標、収益に関する指標、広告のパフォーマンス指標など、他の指標と組み合わせて取得できるようになりました。

      この変更を反映して、使用可能なチャンネル レポートおよびコンテンツ所有者レポートのリストを更新しています(再生時間の指標はリストに示されている他のレポートの一部として取得できるため、実際にはリストが縮小されています)。

      サンプルの API リクエストのドキュメントも更新しています。

    • insightPlaybackLocationDetail ディメンションと insightTrafficSourceDetail ディメンションを使用するレポートが次のように拡張されました。

      • オプションの country フィルタがサポートされるようになりました。

      • コンテンツ所有者は、次のいずれかの新しい filter の組み合わせを使用して、これらのレポートを取得できるようになりました。これらの組み合わせはすべて、オプションの country フィルタもサポートしています。

        • 再生場所の詳細

          • channel,insightPlaybackLocationType==EMBEDDED
          • show,insightPlaybackLocationType==EMBEDDED
          • claimedStatus,insightPlaybackLocationType==EMBEDDED
          • uploaderType,insightPlaybackLocationType==EMBEDDED
          • uploaderType,claimedStatus,insightPlaybackLocationType==EMBEDDED

        • トラフィック ソースの詳細

          • channel,insightTrafficSourceType
          • show,insightTrafficSourceType
          • claimedStatus,insightTrafficSourceType
          • uploaderType,insightTrafficSourceType
          • uploaderType,claimedStatus,insightTrafficSourceType

    2013 年 5 月 3 日

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

    • 新しいサンプル API リクエストのドキュメントでは、YouTube Analytics API を使用してさまざまな種類のレポートを取得する方法の例を紹介しています。それぞれの例には、リクエストで取得するレポートの簡単な説明と、リクエストのディメンション、指標、フィルタ、並べ替えパラメータが含まれています。

    • insightTrafficSourceType ディメンションで有効な値として SUBSCRIBER がサポートされるようになりました。この値は、動画再生が YouTube トップページ上のフィードから参照されたのか、YouTube のチャンネル登録機能から参照されたのかを識別します。このトラフィック ソースに基づいてフィルタリングした場合、insightTrafficSourceDetail フィールドには、トップページのフィードまたは視聴の参照元となった他のページを指定します。

    2013 年 3 月 28 日

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

    2013 年 3 月 21 日

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

    • 収益の指標と広告の掲載結果の指標に加え、新しい広告の掲載結果レポートをサポートするようになりました。これらの指標とレポートにアクセスできるのは、YouTube パートナー プログラムに参加している YouTube コンテンツ パートナーだけです。

      • 新しくサポートされたレポートでは、再生回数ベースの広告の掲載結果の指標と表示回数ベースの広告の掲載結果の指標をサポートしています。広告の掲載結果レポートの詳細については、コンテンツ所有者レポートのドキュメントを参照してください。

      • 新しくサポートされた指標は、以下のリストに示すとおりです。コンテンツ所有者レポートは、新しい 2 つのレポートなど、これらの指標をサポートするレポートを識別するように更新されています。

        • earnings – Google が販売したすべての広告ソースの推定総収益。
        • grossRevenue – Google または DoubleClick パートナーからの推定総収益。
        • primaryAdGrossRevenue – レポートの対象となる動画再生について、メインの広告タイプ別に合計および分類された Google または DoubleClick パートナーからの推定総収益。
        • monetizedPlaybacks – 少なくとも 1 回の広告インプレッションが表示された再生の数。
        • playbackBasedCpm – 再生回数 1,000 回あたりの推定総収益。
        • impressions – 配信された確認済みの広告インプレッション数。
        • impressionBasedCpm – 広告インプレッション 1,000 回あたりの推定総収益。

        注: 詳細については、指標の定義を参照してください。

      • 収益指標や広告パフォーマンス指標を取得するリクエストでは、新しい https://www.googleapis.com/auth/yt-analytics-monetary.readonly スコープを使用してアクセス権を付与する認証トークンを送信する必要があります。

    • 各タイプのレポートを個別のページで説明するように API ドキュメントを再構成しました。そのため、各タイプのチャンネル レポートコンテンツ所有者レポートは、それぞれ個別のページで説明しされています。

    2013 年 2 月 4 日

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

    • API のリファレンス ガイドに、のセクションを追加しました。このセクションには、Java、JavaScript、Python、Ruby の各クライアント ライブラリを使用して API を呼び出す方法を示したコード サンプルが掲載されています。JavaScript コードサンプルは、サンプル アプリケーションのドキュメントで詳細に説明されているものと同じです。

    2012 年 11 月 14 日

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

    • API リファレンス ガイドAPIs Explorer が追加されました。これにより、API の呼び出し、API リクエストの確認、レスポンスの実際のデータの取得が可能になります。

    • チャンネルとコンテンツ所有者の両方について、新しい複数のレポートをサポートしています。これらのレポートについては、以下で説明します。各レポートは、チャンネル レポートまたはコンテンツ所有者レポートとして使用できます。それに合わせて、ディメンションmetricsのページも更新されています。

      • 再生場所レポートは、各タイプのページまたはアプリケーションで発生した動画再生数を示します。

      • 再生場所の詳細レポートは、指定した動画について最も多くの再生回数を生成した埋め込み動画プレーヤーを示します。このレポートでは再生回数上位の埋め込み動画プレーヤーに関連付けられた URL が特定されるため、再生場所レポートよりも詳細なデータが示されます。

      • トラフィック ソース レポートは、各タイプの参照元から発生した動画再生数を示します。

      • トラフィック ソースの詳細レポートは、指定した動画と指定したトラフィック ソースのタイプについて最も多くの再生回数を生成した参照元を示します。たとえば、このレポートを使用することで、指定した動画に最も多くのトラフィックを送信した動画を特定することができます。このレポートは、複数のトラフィック ソースに対してサポートされています。

      • 再生時間レポートは、視聴者がコンテンツの視聴に費やした合計時間を示します。このレポートでは、特定の期間(1 日、過去 7 日間、過去 30 日間など)または国のデータを集計できます。日または国のいずれかでデータを集計する場合は、ユーザーが視聴した各動画の平均長と各動画の平均再生率も示されます。

    2012 年 10 月 2 日

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

    • すべてのデベロッパーが YouTube Analytics API を利用できるようになりました。最初にアクセス権をリクエストしなくても、APIs console の [サービス] パネルからプロジェクトの API を有効にできます。

    • 新しいスタートガイド セクションでは、YouTube Analytics API を使用するアプリケーションを構築するための前提条件と基本的な手順について概説しています。

    2012 年 9 月 12 日

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

    • 新しいクォータの使用方法についてのセクションには、API クォータの使用量を最適化するガイドラインが掲載されています。API サーバーは各リクエストのクエリ コストを計算し、そのコストが API 使用量クォータから減算されます。クエリ コストはレポートのタイプによって大幅に異なるため、効率的にクォータを使用するように計画する必要があります。アプリケーションは、実際に必要な指標とデータだけをリクエストするように作成してください。

    • 時間ディメンションのセクションを更新し、このようなディメンションによって、アナリティクス レポートでは期間に基づいてデータが集計されることを説明しています。API は、以下の時間ディメンションをサポートしています。

      • 7DayTotals – 各行に 7 日間のデータが含まれるようにレポートのデータが集計されます。
      • 30DayTotals – 各行に 30 日間のデータが含まれるようにレポートのデータが集計されます。
      • month – レポートのデータが暦月ごとに集計されます。

      同様に、使用可能なレポートのセクションを更新し、このようなディメンションを使用するレポートに対する API のサポートを反映しています。

    • レポート エンティティ ディメンションのセクションを更新し、コンテンツ所有者レポートを取得する API リクエストでは、これらのディメンション(videochannelshow)のいずれか、またはサポートされている claimedStatus および uploaderType ディメンションの組み合わせを使用してデータをフィルタリングする必要があることを記載しました。

    • 人気の動画レポートで、新しい 2 つの並べ替えオプションがサポートされるようになりました。これらのレポートはチャンネル レポートまたはコンテンツ所有者レポートとして使用可能であり、国別の指標(再生回数、コメント数、評価数など)が含まれています。また、このような指標が動画別に分類されています。これらのレポートは、動画再生ページに登録したユーザー数または登録解除したユーザー数に基づいて並べ替えられるようになりました。

    • subscribersGainedsubscribersLostmetricsの定義を更新し、動画再生ページ、チャンネル ページ、YouTube ホームページに表示されるガイドなど、さまざまな場所でチャンネル登録者数の増減が可能であることを説明しました。これらの指標を動画専用のレポートで表示した場合、そのレポートには、指定した動画の再生ページの統計情報だけが含まれます。