変更履歴

このページには、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 日の入力と同じ情報です。ただし、コンテンツ所有者は 再生リストのレポートは isCurated 個のディメンションが次の日付まで 2024 年 12 月 31 日まで。このディメンションは、次の日付までチャンネルの再生リストレポートでサポートされます。 2024 年 6 月 30 日

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

    isCurated ディメンションのサポートが終了しました。今後は 2024 年 12 月 31 日以降にサポートされます。そのディメンションの定義が更新されました 必要があります。

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

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

    • continent や subcontinent などのロケーション フィルタは使用できません。 新しいチャンネルの再生リストのレポートで サポートされます
    • redViews 指標と estimatedRedMinutesWatched 指標は廃止されました 新しいチャンネルの再生リストのレポートで サポートされますこれらの指標は YouTube Studio では利用できなかったため、 そのため、この変更により API の機能と Studio アプリケーションの機能の整合性は保たれます。
    • subscribedStatus ディメンションと youtubeProduct ディメンションは廃止されました チャンネル再生リスト レポートのフィルタとしてサポートされています。これらのフィルタは この変更により、 ダウンロードします

  • 再生リストのレポート コンテンツ所有者レポートに関するドキュメントのセクションを更新し、 再生リストレポートでサポートされている指標の種類は次のとおりです。

    • 動画の集計指標 Chronicle 内のすべての動画について集計され、 同じくそのコンテンツ所有者が所有する再生リストです。集計動画指標は isCurated ディメンションを使用しない API リクエストでのみサポートされます。
    • 再生リスト内の指標 再生リスト ページのコンテキストでのユーザー アクティビティとエンゲージメントを反映したもの。これらの指標は [対象] のデータには、所有していない動画の視聴回数も含まれます。ただし、 それらの視聴が再生リストのコンテキストで発生した場合に限ります。
    • サポートされている再生リストの指標 セクションでは、視聴されている動画に関する集計指標と再生リスト内指標を確認できます。 再生リストのレポートでサポートされます。

  • 次の新しい再生リスト内指標が、次の再生リストのレポートでサポートされるようになりました。 コンテンツ所有者です。これらの指標は、データを取得する API リクエストが レポートでは isCurated ディメンションは使用されません。詳しくは、 指標に関するドキュメント 定義があります。

  • views の動作 指標は、再生リスト レポートを取得した API リクエストが isCurated ディメンション:

    • リクエストに isCurated ディメンションが含まれている場合、 views の指標は再生リストの 1 つです 動画の再生が 再生リストが表示されます。
    • リクエストに isCurated ディメンションが含まれていない場合、 views 指標は集計された動画指標で、動画の合計回数を指定します コンテンツ所有者の再生リストにある動画が再生された回数。 再生リスト内での視聴回数。集計の合計には、次の視聴回数のみが含まれます: 再生リストを所有するチャンネルに関連付けられているコンテンツ所有者が所有する動画。

      isCurated ディメンションを使用しないこれらのレポートでは、 playlistViews 指標は動画が視聴された回数を示します 必要があります。この指標は再生リスト内の全動画の視聴回数をカウントし どのチャンネルを所有しているかに関係なく

  • 再生リストレポートごとに、 コンテンツ所有者レポート ドキュメントに、レポートでサポートされている指標を示す表が API リクエストに isCurated ディメンションが含まれているかどうか。詳しくは、このモジュールで 時間ベースの再生リストレポート 例です。

2024 年 1 月 19 日

YouTube Analytics (Targeted Queries) API にチャンネル再生リストに関連する更新がいくつか加えられました できます。今回のアップデートには、サポートが終了したディメンションに加え、以下の新しい指標や更新された指標が含まれています。

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

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

    isCurated を削除するときに下位互換性を維持するには playlistViews 指標を取得するようにコードも更新する必要があります。 「views」指標の代わりに使用（再生リストレポートのみ）。views以降 指標は再生リストのレポートで引き続きサポートされます。意味は異なりますが、この API では 指標名を更新しなければ、引き続きデータが返されます。もちろん、アプリケーションを変更することもできます。 views と playlistViews の両方を取得して表示します。

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

    • continent や subcontinent などのロケーション フィルタは使用できません。 新しいチャンネルの再生リストのレポートで サポートされます
    • redViews 指標と estimatedRedMinutesWatched 指標は廃止されました 新しいチャンネルの再生リストのレポートで サポートされますこれらの指標は YouTube Studio では利用できなかったため、 そのため、この変更により API の機能と Studio アプリケーションの機能の整合性は保たれます。
    • subscribedStatus ディメンションと youtubeProduct ディメンションは廃止されました チャンネル再生リスト レポートのフィルタとしてサポートされています。これらのフィルタは この変更により、 ダウンロードします

  • 再生リストのレポート セクションを更新し、チャネル レポートに関するドキュメントをより詳しく 再生リストレポートでサポートされている指標の種類は次のとおりです。

    • 動画の集計指標 Chronicle 内のすべての動画について集計され、 そのチャンネルが所有する再生リストです。集計動画指標は isCurated ディメンションを使用しない API リクエストでのみサポートされます。
    • 再生リスト内の指標 再生リスト ページのコンテキストでのユーザー アクティビティとエンゲージメントを反映したもの。これらの指標は [対象] のデータには、所有していない動画の視聴回数も含まれます。ただし、 それらの視聴が再生リストのコンテキストで発生した場合に限ります。
    • サポートされている再生リストの指標 セクションでは、視聴されている動画に関する集計指標と再生リスト内指標を確認できます。 再生リストのレポートでサポートされます。

  • チャンネルの再生リストレポートで、次の再生リスト内の指標が新たにサポートされました。 これらの指標は、コンテンツ所有者レポートではまだサポートされていません。これらの指標は レポートを取得する API リクエストで、 isCurated ディメンション。詳しくは、 指標に関するドキュメント 定義があります。

  • views の動作 指標は、再生リスト レポートを取得した API リクエストが isCurated ディメンション:

    • リクエストに isCurated ディメンションが含まれている場合、 views の指標は再生リストの 1 つです 動画の再生が 再生リストが表示されます。
    • リクエストに isCurated ディメンションが含まれていない場合、 views 指標は集計された動画指標で、動画の合計回数を指定します チャンネルの再生リストにあるその動画が視聴された回数。 再生リスト内での視聴回数。集計の合計には、次の視聴回数のみが含まれます: 再生リストを所有するチャンネルが所有する動画。

      isCurated ディメンションを使用しないこれらのレポートでは、 playlistViews 指標は動画が視聴された回数を示します 必要があります。この指標は再生リスト内の全動画の視聴回数をカウントし どのチャンネルを所有しているかに関係なく

  • 再生リストレポートごとに、チャンネル レポート ドキュメントに、レポートでサポートされている指標を示す表が API リクエストに isCurated ディメンションが含まれているかどうか。詳しくは、このモジュールで 時間ベースの再生リストレポート 例です。

2023 年 12 月 4 日

YouTube Analytics (Targeted Queries) API が更新され、2 つのクエリを統合 insightTrafficSourceType ディメンション値を使用します。これまでは、再生リストの一部として再生される動画を区別するディメンションが必要でした。 （PLAYLIST）と再生リスト内のすべての動画を一覧表示するページからの視聴回数 （YT_PLAYLIST_PAGE）。今後は、どちらのタイプのビューも PLAYLIST ディメンション値。

2022 年 12 月 15 日

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

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

  • 新しい creatorContentType ディメンションは、ユーザー アクションに関連する YouTube コンテンツのタイプを示します。 表示されます。サポートされている値は LIVE_STREAM、SHORTS、 STORY、VIDEO_ON_DEMAND。

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

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

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

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 ディメンションの有効な値のセットは、8 月以降に変更されます 2022 年 11 月 11 日。これは、API 実装の下位互換性のない変更である可能性があります。従来の 戻る YouTube API サービス利用規約の「互換性のない変更」のセクションに記載されている変更について、今回の変更は 発効の 6 か月前に発表します。API 実装を更新してください を新しい値のセットにシームレスに移行できるようにする必要があります。

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

  • YouTube Analytics (Targeted Queries) API では、 現在 gender 個のディメンション female と male の 2 つの値をサポートしています。2022 年 8 月 11 日以降、 ディメンションでは、female、male、および user_specified。
  • YouTube Reporting (Bulk Reports) API では、 現在 gender 個のディメンション は、FEMALE、MALE、GENDER_OTHER の 3 つの値をサポートしています。 2022 年 8 月 11 日以降、サポートされている値のセットは FEMALE に変更されます。 MALE、USER_SPECIFIED。

2022 年 2 月 9 日

2 つの指標が更新され、除外されました クリップのループ トラフィック 2021 年 12 月 13 日この変更は、YouTube Analytics (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 をサポートしています。

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

2020 年 7 月 20 日

今回のアップデートでは、YouTube Analytics (Targeted Queries) API に影響する 2 つの変更が含まれています。

  • YouTube アナリティクス レポートの最大サイズは group のエンティティが 200 から 500 に増えました。
  • reports.query メソッドの filters パラメータは、YouTube アナリティクスを取得する際に適用するフィルタのリストを識別します。 分析できますこのパラメータでは、ラベルに複数の値を指定できます。 video, playlist, と channel フィルタ、 これらのフィルタに指定できる ID の最大数が 200 から 500 に増えました。

2020 年 2 月 13 日

この更新には、YouTube アナリティクス（ターゲット クエリ）に関連する次の変更が含まれています。 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 日）を起点とする期間に対して返されます。

また、これらの値は通知そのものではなく、トラフィックの 参照元を確認できます。たとえば、レポートの行に views=3 と表示されている場合、 traffic_source_type=17（NOTIFICATION）、 traffic_source_detail=uploaded_push の場合、その行は 3 つのビュー 動画のアップロード時に送信されたプッシュ通知を視聴者がクリックしたことで発生しました。

2019 年 10 月 15 日

このアップデートには、YouTube Analytics (Targeted Queries) API に関連する次の変更が含まれています。

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

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

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

    • 7 日間の視聴回数は、その期間の各日の視聴回数を集計することで算出できます。
    • 7 日間の ViewerPercentage は、各日の視聴回数にその日の視聴者維持率を掛けて算出すると、その日に動画を視聴したときにログインした視聴者数が得られます。期間全体におけるログインしている視聴者の数を加算し、その期間の合計視聴回数で割ると、期間全体の ViewerPercentage が得られます。
    • 同じ視聴者が別々の日にユニーク視聴者として計算される可能性があるため、7 日間のユニーク視聴者数は計算できません。ただし、30DayTotals ディメンションではなく month ディメンションを使用すると、30 日間のユニーク閲覧者数に関するデータを推定できる場合があります。month ディメンションは暦月を参照するのに対し、30DayTotals ディメンションは指定された開始日と終了日に基づいて 30 日間の期間を計算します。

2019 年 6 月 27 日

このアップデートには、YouTube Analytics (Targeted Queries) API に関連する次の変更が含まれています。

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

2018 年 11 月 1 日

このアップデートには、YouTube Analytics (Targeted Queries) API に関連する次の変更が含まれています。

  • API のバージョン 1 は非推奨になりました。まだの場合は、サービスの中断を最小限に抑えるために、できるだけ早く API バージョン 2 を使用するよう API クライアントを更新してください。詳しくは、移行ガイドをご覧ください。

    なお、このサポート終了のスケジュールは本来 2018 年 4 月 26 日に発表されました。

2018 年 9 月 17 日

このアップデートには、YouTube Analytics (Targeted Queries) API に関連する次の変更が含まれています。

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

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

      または

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

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

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

2018 年 6 月 18 日

この更新では、YouTube Analytics (Targeted Queries) API に対して次の変更が行われます。

  • 次のメソッドのスコープ要件が変更されました。 <ph type="x-smartling-placeholder">
      </ph>
    • reports.query メソッドへのリクエストは、https://www.googleapis.com/auth/youtube.readonly スコープにアクセスできる必要があります。
    • groupItems.list メソッドへのリクエストでは、次のいずれかにアクセスできる必要があります。 <ph type="x-smartling-placeholder">
        </ph>
      • https://www.googleapis.com/auth/youtube スコープ
        または
      • https://www.googleapis.com/auth/youtube.readonly スコープ
        と
        https://www.googleapis.com/auth/yt-analytics.readonly スコープ

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

2018 年 5 月 23 日

この更新では、YouTube Analytics (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 Analytics (Targeted Queries) API（v2）のバージョン 2 が一般公開されました。新しい 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 メソッドは、alt、quotaUser、userIp の各リクエスト パラメータをサポートしなくなりました。
    • v2 API には、さまざまな API へのリクエストで構成されるバッチをサポートするバッチ エンドポイントは用意されていません。（ただし、バッチは、同じ API の異なるメソッドに対するリクエストで構成できます）。Google はすべての API でグローバル バッチ エンドポイントのサポートを終了するため、これは YouTube Analytics API 固有のものではありません。
    • v2 API は、API v1 でサポートされていた JSON-RPC プロトコルをサポートしていません。繰り返しになりますが、今回のサポート終了は YouTube Analytics API 固有のものではありません。

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

    API（v1）のバージョン 1 は非推奨となり、2018 年 10 月 31 日までサポートされます。この日を過ぎると、v1 API へのすべてのリクエストは機能しなくなります。そのため、この API を使用して YouTube アナリティクスのデータにアクセスできなくなることのないよう、2018 年 10 月 31 日までに必ず v2 API にアップグレードしてください。

2018 年 2 月 21 日

この更新では、YouTube Analytics (Targeted Queries) API に対して次の変更が行われます。

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

2018 年 1 月 18 日

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

  • YouTube Reporting API（一括レポート）

    • ビューが発生したデバイスのソフトウェア システムを識別する operating_system ディメンションで、次の値がサポートされるようになりました。 <ph type="x-smartling-placeholder">
        </ph>
      • 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 group ディメンションと gender ディメンションのドキュメントは、API がこれらのディメンションに対して返す実際の値を示すように修正されました。これはドキュメントの修正であり、API の機能や動作の変更は反映していないことに注意してください。具体的には、次の値が変更されています。

    • 「age_group」ディメンションの値には大文字が使用され、「AGE」という単語と年齢層の数字の間にアンダースコアが含まれ、ハイフンではなくアンダースコアが使用されます。そのため、age13-17 や age18-24 などの値は、それぞれ AGE_13_17 と AGE_18_24 に修正されました。
    • gender ディメンションの値には大文字が使用されます。したがって、female、male、gender_other の値は FEMALE、MALE、GENDER_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 ゲーム
      • 87 さん: YouTube Kids
      • 88: YouTube TV

      また、値 52 の識別に使用される名前が、値 73（Kakao Story）と明確に区別できるように、ドキュメントで Kakao（Kakao Talk）に更新されました。この変更は、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 は、redViews 指標と estimatedRedMinutesWatched 指標をサポートしています。どちらも YouTube Red の視聴者数に関する指標です。実際、この API では以前からこれらの指標がサポートされており、2016 年 9 月 15 日に発表したとおり、YouTube Reporting API ではすでに両方の指標をサポートしています。

    • redViews 指標は、YouTube Premium メンバーによって動画が視聴された回数を示します。
    • estimatedRedMinutesWatched 指標は、YouTube Premium メンバーが動画を視聴した時間（分）を示します。

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

2017 年 3 月 3 日

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

  • YouTube Reporting API（一括レポート）

    • date ディメンションの定義を修正し、太平洋時間午前 0 時から午後 11 時 59 分までをディメンション値としました。指定した日、月、年の太平洋時間。時刻に応じて、太平洋時間は UTC-7 または UTC-8 になります。

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

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

    • ビューが発生したデバイスのソフトウェア システムを識別する operating_system ディメンションで、次の値がサポートされるようになりました。 <ph type="x-smartling-placeholder">
        </ph>
      • 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 つの新しいディメンション値がサポートされています。 <ph type="x-smartling-placeholder">
        </ph>
      • 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 クリエイター ツールの [レポート] セクションで対応するレポートにアクセスできるコンテンツ所有者向けに、システム管理型の広告収益レポートが自動生成されるようになりました。新しいシステム管理 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 Premium メンバーが動画を視聴した回数。
      • red_watch_time_minutes: YouTube Premium メンバーが動画を視聴した時間（分）。

    • この 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 レポートのサポートが完全に終了し、ドキュメントから削除されました。そのタイプのレポートは新たに生成されなくなりますが、すでに生成済みのレポートは生成後 180 日間利用できます。

      2016 年 5 月 19 日の変更履歴エントリで説明されているとおり、content_owner_basic_a1 レポートは content_owner_basic_a2 レポートに置き換えられます。

    2016 年 8 月 11 日

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

    • 新たに公開された YouTube API サービス利用規約（以下「更新後の利用規約」）は、YouTube エンジニアリングとデベロッパー ブログで詳しく説明されており、現在の利用規約に対するさまざまな更新が含まれています。今回の更新には、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 つの新しいディメンション値がサポートされています。 <ph type="x-smartling-placeholder">
          </ph>
        • CAMPAIGN_CARD: このトラフィック ソースは、コンテンツ所有者レポートでのみサポートされています。この指標は、申し立てを行ったユーザー アップロード動画（コンテンツ所有者が視聴したコンテンツの宣伝に使用した動画）からの視聴であることを示しています。
        • END_SCREEN: 別の動画の終了画面から発生した視聴回数に関するデータです。

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

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

    • YouTube Reporting API（一括レポート）

      • traffic_source_type ディメンションで次の値がサポートされるようになりました。 <ph type="x-smartling-placeholder">
          </ph>
        • 19: このトラフィック ソースは、コンテンツ所有者レポートでのみサポートされています。この指標は、申し立てを行ったユーザー アップロード動画（コンテンツ所有者が視聴したコンテンツの宣伝に使用した動画）からの視聴であることを示しています。
        • 20: 別の動画の終了画面から発生した視聴回数に関するデータです。

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

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

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

    2016 年 7 月 18 日

    この更新には以下の変更が含まれます。

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

      • 次のチャンネル レポートでサポートされている指標のリストが更新され、カード指標が追加されました。実際、これらのレポートでは 2016 年 6 月 28 日にカード指標のサポートが追加されました。同日の変更履歴項目ではこの変更について詳しく説明しています。レポートは次のとおりです。 <ph type="x-smartling-placeholder">
          </ph>
        • 米国の州における基本的なユーザー アクティビティ
        • 特定期間の米国各州におけるユーザー アクティビティ
        • 州別のユーザー アクティビティ
        • 登録状況別のユーザー アクティビティ
        • 都道府県の登録ステータス別のユーザー アクティビティ
        • 州別の人気の動画
        • チャンネル登録または登録していない視聴者に人気の動画

      • チャンネルの視聴者維持率レポートとコンテンツ所有者の視聴者維持率レポートの両方のフィルタリストが修正され、video フィルタが必須であることと、group フィルタがサポートされていないことが反映されました。

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

    • 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 に関して以下の変更が含まれます。1 つ目の変更は 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_a1、content_owner_estimated_earnings_a1、content_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 日間利用できます。

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

      • reportType リソースの deprecateTime プロパティには、レポートタイプが廃止される日時を指定します。このプロパティにはサポート終了が発表されたレポートの値のみが含まれます。この値は、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 ディメンションで次の新しい値がサポートされています。 <ph type="x-smartling-placeholder">
        </ph>
      • 82: iOS システム アクティビティ ダイアログ
      • 83: Google 受信トレイ
      • 84: Android Messenger
    • YouTube Analytics API では、sharingService ディメンションは次の新しい値をサポートしています。 <ph type="x-smartling-placeholder">
        </ph>
      • ANDROID_MESSENGER: Android Messenger
      • INBOX: Google 受信トレイ
      • IOS_SYSTEM_ACTIVITY_DIALOG: iOS システム アクティビティ ダイアログ

    2016 年 3 月 16 日

    今回のアップデートには以下の変更が含まれており、YouTube Reporting API と YouTube Analytics API の両方に影響します。

    YouTube Reporting API

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

    YouTube Analytics API

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

    2016 年 2 月 8 日

    YouTube Analytics API でサポートされている指標の一覧が更新され、カード指標が YouTube Analytics 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 つ以上を必要に応じてディメンションやフィルタとして使用できる点が記載されています。

    • レポートを説明する表のフォーマットが変更され、各レポートの取得に使用できるディメンション、指標、フィルタの有効な組み合わせを簡単に識別できるようになりました。以下の表で「Device Type」について説明します。に、新しい形式が表示されます。

      目次
      ディメンション:
      必須 deviceType
      0 以上の値を使用してください day、liveOrOnDemand、subscribedStatus、youtubeProduct
      指標:
      1 つ以上を使用してください views、estimatedMinutesWatched
      フィルタ:
      0 または 1 を使用してください 国、州、大陸、subContinent
      0 または 1 を使用してください 動画、グループ
      0 以上の値を使用してください operatingSystem、liveOrOnDemand、subscribedStatus、youtubeProduct

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

    • YouTube Analytics API は、複数の値（video、playlist、channel）をサポートするフィルタから API ユーザーがデータを取得できないエンティティを自動的にドロップするようになりました。これまでは、指定されたアイテムの少なくとも 1 つについて API ユーザーがデータにアクセスできなかった場合、API サーバーがエラーを返していました。

      たとえば、ユーザーが video フィルタに 20 個の動画 ID をリストする API リクエストを送信したとします。このユーザーが 18 本の動画を所有しています。一方の動画 ID は別のチャンネルが所有する動画を識別する 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 Premium の定期購入から得られた推定収益の合計をレポートします。この指標の値は音楽と音楽以外のコンテンツの両方からの収益を反映しており、月末の調整の対象となります。

      YouTube Analytics API のコンテンツ所有者レポートのリストが更新され、redPartnerRevenue 指標をサポートする動画レポートが特定されました。

    • YouTube Analytics API の人気の動画レポートの定義では、このレポートで収益の指標（earnings、adEarnings、grossRevenue、monetizedPlaybacks、playbackBasedCpm、impressions、impressionBasedCpm）もサポートされるようになりました。

    2015 年 10 月 29 日

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

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

      また、YouTube Analytics API のドキュメントが更新され、日付関連のすべてのディメンション（day、7DayTotals、30DayTotals、month）が太平洋時間の午前 12 時（UTC-8）を起点とする日付が参照されるようになりました。

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

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

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

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

    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 が生成するレポートを識別します。ジョブを設定すると、非同期でダウンロードできる日次レポートが生成されます。各レポートには固有の 24 時間単位のデータが含まれます。

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

      • ドキュメント セットの [Guides] タブには、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 で、動画レポートで videosAddedToPlaylists と videosRemovedFromPlaylists の 2 つの新しい指標がサポートされるようになりました。チャンネルとコンテンツ所有者の動画レポートのリストが更新され、新しい指標に対応したレポートが特定されました。

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

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

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

    2015 年 3 月 31 日

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

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

    2015 年 3 月 16 日

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

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

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

    2015 年 2 月 25 日

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

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

      • グループの作成と管理

        このアップデートでは、グループを作成、管理するための group リソースと groupItem リソースが導入されています。

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

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

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

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

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

    2015 年 2 月 13 日

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

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

    2014 年 8 月 28 日

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

    • API では、video、playlist、channel、show ディメンションをフィルタとして使用する場合に、ディメンションを複数の値で指定できるようになりました。複数の値を指定するには、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 フィルタを使用し、1（isCurated==1）に設定する必要があります。

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

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

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

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

      また、audienceType フィルタを使用して、オーガニック ビュー、TrueView インストリーム広告からの視聴回数、TrueView インディスプレイ広告からの視聴回数に関連するデータのみをレポートで確認することもできます。（オーガニック ビューは、動画の検索や関連動画のクリックといったユーザー操作の直接的な成果です）。

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

      新しい指標はすべてコア指標であり、非推奨ポリシーの対象となります。ただし、新しい指標については 2013 年 7 月 16 日以降のデータを利用できます。（annotationClickThroughRate 指標と annotationCloseRate 指標のデータは 2012 年 6 月 10 日時点のものです）。

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

    2014 年 1 月 31 日

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

    2014 年 1 月 16 日

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

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

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

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

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

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

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

    2014 年 1 月 6 日

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

    • サポートされるチャンネル レポートとコンテンツ所有者レポートの一覧が記載されたドキュメントが再設計されました。すべてのレポートを一覧表示する表を用意するのではなく、各ドキュメントでレポートをカテゴリ別にグループ化します。

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

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

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

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

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

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

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

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

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

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

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

    2013 年 9 月 30 日

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

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

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

      このアップデートにより、モバイルでの再生は、再生が発生するアプリのタイプに応じて、WATCH、EMBEDDED、または EXTERNAL_APP の再生に分類されるようになりました。

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

    2013 年 7 月 16 日

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

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

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

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

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

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

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

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

    May 23, 2013 年 5 月 23 日

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

    2013 年 5 月 10 日

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

    2013 年 5 月 6 日

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

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

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

      サンプルの 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 日

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

    • API で、annotationClickThroughRate と annotationCloseRate という 2 つの新しい指標がサポートされるようになりました。これらの指標は、動画中に表示されるアノテーションに対する視聴者の操作に関連するものです。チャンネル レポートとコンテンツ所有者レポートのリストの両方が更新され、新しい指標に対応したレポートが特定されました。

      • annotationClickThroughRate – クリック可能なアノテーションの合計インプレッション数に対して視聴者がクリックしたアノテーションの割合。
      • annotationCloseRate – アノテーションの総インプレッション数に対する、視聴者が閉じたアノテーションの割合。

    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 リクエストの確認、レスポンス内の実際のデータの取得を行えます。

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

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

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

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

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

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

    2012 年 10 月 2 日

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

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

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

    2012 年 9 月 12 日

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

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

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

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

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

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

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

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