変更履歴

このページでは、YouTube Reporting API と YouTube Analytics API の API の変更内容とドキュメントの更新内容の一覧を示します。どちらの API も、デベロッパーが YouTube アナリティクスのデータにアクセスできるようにするものですが、その方法は異なります。

2026 年 11 月 6 日

再生場所のディメンションに関するドキュメントが、YouTube Reporting API と YouTube Analytics API の両方で更新されました。

• YouTube Reporting API の playback_location_type ディメンション テーブルに、値 11（縦型ライブ配信フィードで発生した視聴回数）と 12（YouTube Music の [試聴する] タブで発生した視聴回数）が記録されるようになりました。
• YouTube Analytics API の insightPlaybackLocationType ディメンションの定義に、IMMERSIVE_LIVE_FEED（縦型ライブ配信フィードでの視聴回数）と SHORTS_FEED（YouTube ショート フィードでの視聴回数）が追加されました。

2026 年 11 月 4 日

2027 年 1 月 15 日をもって、コンテンツ所有者向けの週次参照レポートのバージョン 1.0（content_owner_active_references_a1）は非推奨となり、バージョン 1.1（content_owner_active_references_a2）に置き換えられました。2027 年 1 月 15 日までに最新バージョンに移行してください。

2026 年 10 月 30 日

YouTube Reporting API で、コンテンツ所有者向けの次のシステム管理レポートがサポートされるようになりました。

カテゴリ	レポート名	レポートタイプ ID
財務サマリー	チャンネル調整の概要（月単位）	content_owner_channel_adjustments_summary_a1
財務サマリー	有料機能の取引収益（月単位）	content_owner_transactions_paid_features_revenue_a1
財務サマリー	月単位の TVOD トランザクション収益（タイトル別、国別）	tvod_content_owner_country_title_tvod_revenue_a1
財務サマリー	月単位の TVOD トランザクション収益（国別）	tvod_content_owner_country_transactions_tvod_revenue_a1
YouTube ショート	音楽レーベルのショート動画アセットの作成（月単位）	music_content_owner_shorts_asset_creations_a1
YouTube ショート	音楽レーベルのショート動画アセットの視聴回数（月単位）	music_content_owner_shorts_asset_views_a1
YouTube ショート	音楽出版社のアセットを使用したショート動画の作成（月単位）	publisher_content_owner_shorts_asset_creations_a1
YouTube ショート	音楽出版社アセットのショート動画の視聴回数（月単位）	publisher_content_owner_shorts_asset_views_a1
税金	MCN アフィリエイトの税金払い戻しの概要レポート（月単位）	content_owner_affiliate_tax_refund_summary_a1
アセット	週次 SRMF レポート	publisher_content_owner_weekly_srmf
アセット	OAC リクエスト ステータス レポート（日別）	content_owner_oac_request_status_a1
アセット	OAC リクエストの品質に関する日次レポート	content_owner_oac_quality_status_a1

2026 年 9 月 13 日

YouTube Reporting API で、コンテンツ所有者向けの週次参照レポート（content_owner_active_references_a2）のバージョン 1.1 がサポートされるようになりました。

バージョン 1.1 では、次の変更が導入されています。

• status_detail フィールドを追加します。このフィールドには、参照ファイルのステータスに関する追加の詳細または理由が表示されます。
• asset_owners フィールドを更新して、パートナー コードの代わりにコンテンツ所有者の表示名または外部 ID を使用するようにします。

以前のバージョンのレポートであるバージョン 1.0（content_owner_active_references_a1）は、引き続きご利用いただけます。

2026 年 9 月 9 日

YouTube Analytics API と YouTube Reporting API のドキュメントが更新され、以下の追加と明確化が行われました。

• データの更新速度とレイテンシの SLA: データモデルに専用のセクションを追加し、48 ～ 72 時間のデータ処理の遅延、完全に処理された最後の日までの終了日の切り捨てについて説明し、リアルタイムの動画統計情報には YouTube Data API の videos.list メソッドを推奨しました。

• チャンネル レポートの収益指標: チャンネル レポートの承認に関するドキュメントを更新し、チャンネルが YouTube パートナー プログラム（YPP）のメンバーである場合に、https://www.googleapis.com/auth/yt-analytics-monetary.readonly スコープで承認されたチャンネル レポートで推定収益と広告のパフォーマンス指標がサポートされること、および収益化されていないチャンネルは HTTP 403 Forbidden を返すことを明確にしました。

• クエリの制約とパラメータの互換性: レポートの表についてに、無効なディメンション、指標、フィルタの組み合わせや、相互に排他的なディメンション、指標、フィルタの組み合わせは HTTP 400 badRequest（"The query is not supported."）を返すことを明確にする注意事項を追加しました。

• 一括レポートの空のディメンション値: YouTube Reporting API のレポート特性を更新し、video_id や channel_id などのディメンション列に空の文字列が含まれることを説明しました。これは、削除されたリソースの集計指標数を保持し、チャンネルレベルのイベントを表すためです。

2026 年 8 月 27 日

YouTube は、長尺動画、ライブ配信、ショート動画のすべての動画フォーマットで、公開視聴回数のカウント方法を統一します。YouTube では、動画の再生が開始された時点で公開視聴回数としてカウントされます。

収益化の資格要件と主要なパフォーマンス指標のほとんどは、エンゲージメント指標に基づいているため、影響を受けません。クリエイターの収益は、引き続き「ショート動画のエンゲージ ビュー」と「エンゲージ総再生時間」に基づいて計算されます。これらの指標は、YouTube アナリティクスの [詳細モード] で確認できます。

YouTube パートナー プログラムの資格要件に変更はありません。YouTube パートナー プログラムの参加基準は、以前は「有効な公開ショート動画の視聴回数」と「有効な公開動画の総再生時間」でしたが、今後は「対象となるショート動画の視聴回数」と「対象となる動画の総再生時間」となります。

詳しくは、YouTube コンテンツのパフォーマンスを把握するをご覧ください。

指標	ステータス	トリガー	用途
表示	更新	動画が最初のフレームから再生された（自動再生、ポインタを合わせる、クリックまたはタップして再生を含む）。	標準の公開視聴回数。
エンゲージ ビュー	変更なし	最初のフレーム以降も再生が継続されるか、ユーザーがクリックまたはタップして再生します。	YouTube パートナー プログラムによる収益化、主要なアナリティクス（クリック率、平均視聴時間）の大部分、エンゲージメント レポート。
サムネイルのインプレッション数	変更なし	サムネイルは、操作や自動再生なしで表示されます。	フィードレベルの露出とパッケージングを測定します。

API ドキュメントの更新: YouTube Analytics API の指標と YouTube Reporting API の指標のドキュメントで、engagedViews 指標の定義を更新しました。

2026 年 6 月 25 日

YouTube Analytics API（ターゲット クエリ）のドキュメントが更新され、コンテンツ所有者向けの都市別のユーザー アクティビティ レポートが削除されました。このレポートはコンテンツ所有者には対応していません。コンテンツ所有者が都市別のユーザー アクティビティをクエリすると、空の結果が返されます。

2026 年 3 月 9 日

ageGroup（YouTube Analytics API）と age_group（YouTube Reporting API）のディメンションに、YouTube が 18 歳未満と推定するユーザーが含まれるようになりました。

2026 年 1 月 15 日

YouTube Reporting API で、チャンネルとコンテンツ所有者のリーチ レポートがサポートされるようになりました。リーチ レポートには、動画のサムネイルのインプレッション数とクリック率の統計情報が表示されます。

• channel_reach_basic_a1 レポートと channel_reach_combined_a1 レポートは、チャンネルで利用できます。
• content_owner_reach_basic_a1 レポートと content_owner_reach_combined_a1 レポートは、コンテンツ所有者が利用できます。

これらのレポートでは、次の新しい指標がサポートされています。

• video_thumbnail_impressions
• video_thumbnail_impressions_ctr

2025 年 9 月 22 日

以前にお知らせしたレポートのサポート終了日が、2025 年 9 月 30 日から 2025 年 10 月 31 日に延期されました。ショート動画の視聴回数の変更に合わせて更新された以前のバージョンのレポートは、それまで引き続きご利用いただけます。ただし、申し立てレポート v1.0（content_owner_active_claims_a1）と申し立てレポート v1.1（content_owner_active_claims_a2）は、9 月 30 日にサポートが終了します。

2025 年 6 月 24 日

2025 年 3 月 26 日に発表されたとおり、新しいショート動画の視聴回数の変更の一環として、一括レポート API が更新されます。以下の変更が加えられました。

• ビューを含む各レポート（レポートの大部分）について、新しいレポート バージョンが作成されました。影響を受ける各レポートのバージョンが 1 つずつ増えています（バージョン a2 からバージョン a3 など）。
• ショート動画の場合、ショート動画の再生または繰り返し再生が開始された回数が視聴回数としてカウントされるようになります。動画については変更はありません。
• 更新されたレポートには、以前の視聴回数算定方法を反映した新しい列 engaged_views が追加されます。

これらの変更は、Bulk Reports API については 2025 年 6 月 30 日から有効になります。それに応じてレポート処理を調整してください。

以前のバージョンのレポートは、2025 年 9 月 30 日までご利用いただけます。2025 年 9 月 30 日以降、以前のバージョンは非推奨となります。必ず最新バージョンに移行してください。

最後に、レポートを処理する際は、ベスト プラクティスに沿って、レポートの今後の変更によって処理パイプラインが破損しないようにしてください。

次の表に、各レポートタイプの新しいレポート バージョンを示します。

YouTube アナリティクスのバルクデータ レポート

チャンネル レポート - 動画レポート
レポート名	以前のバージョン	最新バージョン
ユーザー アクティビティ	channel_basic_a2	channel_basic_a3
州別のユーザー アクティビティ	channel_province_a2	channel_province_a3
再生場所	channel_playback_location_a2	channel_playback_location_a3
トラフィック ソース	channel_traffic_source_a2	channel_traffic_source_a3
デバイスの種類とオペレーティング システム	channel_device_os_a2	channel_device_os_a3
字幕	channel_subtitles_a2	channel_subtitles_a3
組み合わせ	channel_combined_a2	channel_combined_a3

チャンネル レポート - 再生リストレポート
レポート名	以前のバージョン	最新バージョン
ユーザー アクティビティ	playlist_basic_a1	playlist_basic_a2
州別のユーザー アクティビティ	playlist_province_a1	playlist_province_a2
再生場所	playlist_playback_location_a1	playlist_playback_location_a2
トラフィック ソース	playlist_traffic_source_a1	playlist_traffic_source_a2
デバイスの種類とオペレーティング システム	playlist_device_os_a1	playlist_device_os_a2
組み合わせ	playlist_combined_a1	playlist_combined_a2

コンテンツ所有者レポート - 動画レポート
レポート名	以前のバージョン	最新バージョン
ユーザー アクティビティ	content_owner_basic_a3	content_owner_basic_a4
州別のユーザー アクティビティ	content_owner_province_a2	content_owner_province_a3
再生場所	content_owner_playback_location_a2	content_owner_playback_location_a3
トラフィック ソース	content_owner_traffic_source_a2	content_owner_traffic_source_a3
デバイスの種類とオペレーティング システム	content_owner_device_os_a2	content_owner_device_os_a3
字幕	content_owner_subtitles_a2	content_owner_subtitles_a3
組み合わせ	content_owner_combined_a2	content_owner_combined_a3

コンテンツ所有者レポート - 再生リストレポート
レポート名	以前のバージョン	最新バージョン
ユーザー アクティビティ	content_owner_playlist_basic_a1	content_owner_playlist_basic_a2
州別のユーザー アクティビティ	content_owner_playlist_province_a1	content_owner_playlist_province_a2
再生場所	content_owner_playlist_playback_location_a1	content_owner_playlist_playback_location_a2
トラフィック ソース	content_owner_playlist_traffic_source_a1	content_owner_playlist_traffic_source_a2
デバイスの種類とオペレーティング システム	content_owner_playlist_device_os_a1	content_owner_playlist_device_os_a2
組み合わせ	content_owner_playlist_combined_a1	content_owner_playlist_combined_a2

コンテンツ所有者レポート - アセット レポート
レポート名	以前のバージョン	最新バージョン
ユーザー アクティビティ	content_owner_asset_basic_a2	content_owner_asset_basic_a3
州別のユーザー アクティビティ	content_owner_asset_province_a2	content_owner_asset_province_a3
動画の再生場所	content_owner_asset_playback_location_a2	content_owner_asset_playback_location_a3
トラフィック ソース	content_owner_asset_traffic_source_a2	content_owner_asset_traffic_source_a3
デバイスの種類とオペレーティング システム	content_owner_asset_device_os_a2	content_owner_asset_device_os_a3
組み合わせ	content_owner_asset_combined_a2	content_owner_asset_combined_a3

システム管理レポート - 財務（音楽以外）

コンテンツ所有者レポート - YouTube ショート レポート（音楽以外）
レポート名	以前のバージョン	最新バージョン
グローバル広告収益の概要	content_owner_shorts_global_ad_revenue_summary_a1	content_owner_shorts_global_ad_revenue_summary_a2
1 日の広告収入の概要	content_owner_shorts_day_ad_revenue_summary_a1	content_owner_shorts_day_ad_revenue_summary_a2
国別広告収入の概要	content_owner_shorts_country_ad_revenue_summary_a1	content_owner_shorts_country_ad_revenue_summary_a2
広告収入の概要	content_owner_shorts_ad_revenue_summary_a1	content_owner_shorts_ad_revenue_summary_a2

システム管理レポート - 財務以外

コンテンツ所有者レポート - 申し立てレポート
レポート名	以前のバージョン	最新バージョン
有効な申し立て	content_owner_active_claims_a2	content_owner_active_claims_a3

コンテンツ所有者レポート - 動画メタデータ レポート
レポート名	以前のバージョン	最新バージョン
動画のメタデータ	content_owner_video_metadata_a3	content_owner_video_metadata_a4

コンテンツ所有者レポート - アセット レポート
レポート名	以前のバージョン	最新バージョン
アセット	content_owner_asset_a2	content_owner_asset_a3
アセットの競合	content_owner_asset_conflict_a2	content_owner_asset_conflict_a3

2025 年 4 月 24 日

2025 年 3 月 26 日に発表されたとおり、新しいショート動画の視聴回数の変更の一環として、ターゲット クエリ API が更新されます。

• ショート動画の場合、views は、ショート動画の再生または繰り返し再生が開始された回数をカウントするようになりました。
• 新しい指標 engagedViews には、以前の視聴回数のカウント方法が反映されます。engagedViews は、views とともにすべてのレポートで使用できるようになります。

これらの変更は、ターゲット クエリ API については 2025 年 4 月 30 日から有効になります。それに応じてクエリを調整してください。

この変更履歴で、一括レポート API に加えられる変更内容と変更時期を確認してください。

2025 年 4 月 22 日

2024 年 4 月 7 日に発表されたとおり、チャンネル レポートとコンテンツ所有者の再生リスト レポートで isCurated ディメンションが非推奨になりました。2024 年 12 月 31 日をもって、このディメンションのサポートは終了しました。このディメンションは、レポートとドキュメントから削除されました。

2025 年 3 月 26 日

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

2025 年 3 月 31 日より、YouTube ショートの視聴回数のカウント方法が変更されます。以前は、ショート動画が一定の秒数再生された後に視聴回数としてカウントされていました。最低総再生時間の要件がなくなり、ショート動画の再生および繰り返し再生が開始された回数が視聴回数としてカウントされるようになります。詳細

YouTube アナリティクス API（ターゲット クエリ）と YouTube Reporting API（一括レポート）は、以下の変更を反映して更新されます。

• ショート動画の場合、viewsは、ショート動画の再生または繰り返し再生が開始された回数を示します。
• 新しい指標 engagedViews が利用可能になり、以前の視聴回数のカウント方法が反映されます。
• チャンネルの所有者、またはチャンネルのデータにアクセスする権限があるユーザーは、更新された視聴回数とエンゲージ ビューの両方を確認できます。

ターゲット クエリは 4 月 30 日までに、一括レポートは 6 月 30 日までに更新されます。それまでは、以前の方法に基づいて視聴回数がカウントされます。ショート動画とチャンネルの視聴回数は、YouTube Studio のアナリティクスと一致しません。

また、以前に発表された、日別申し立て（バージョン 1.0）レポートのサポート終了が延期されました。

この変更履歴で、API に変更が加えられた時期を確認できます。

2025 年 3 月 3 日

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

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

日別申し立て（バージョン 1.0）レポートは、パートナー向けに非推奨となりました。2025 年 4 月 30 日以降はサポートされなくなります。これに伴い、このレポートの定義が更新されました。代わりに、最新の日次申し立てレポートを使用してください。

2024 年 11 月 15 日

注: 以下の変更は 2024 年 11 月 18 日より有効になります。

YouTube Analytics（ターゲット クエリ）API のドキュメントが更新され、トラフィック ソース レポートについて、クエリ対象の動画数と期間の日数の積が 50,000 を超えると、API の reports.query メソッドがエラーを返すようになったことが記載されました。たとえば、500 個の動画 ID のデータを取得するクエリでは、最大 100 日間のデータをリクエストできます。

この変更は、チャンネルとコンテンツ所有者の両方のレポートに影響します。

リクエストから返される行数を減らすには、クエリを複数のクエリに分割して、指定する動画の数を減らすか、期間を短く設定します。原則として、大規模なデータセットには一括レポートをおすすめします。

2024 年 5 月 6 日

YouTube アナリティクス（ターゲット クエリ）API は、チャンネルに関する 3 つの新しいレポートをサポートしています。

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

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

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

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

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

• startedWatching
• stoppedWatching
• totalSegmentImpressions

2024 年 4 月 7 日

重要: 2024 年 12 月 31 日までに、コンテンツ所有者の再生リスト レポートを更新してください。

YouTube アナリティクス（ターゲット クエリ）API には、コンテンツ所有者の再生リスト レポートに関連するいくつかの更新があります。この更新は、2024 年 1 月 19 日に発表されたチャンネル再生リスト レポートに関する更新と同じです。

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

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

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

  重要: API リクエストから isCurated ディメンションを削除する場合は、アプリケーションに追加の変更を加える必要があります。

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

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

  • continent や subcontinent などの地域フィルタは、新しいチャンネル再生リスト レポートではサポートされていません。
  • 新しいチャンネル再生リスト レポートでは、redViews 指標と estimatedRedMinutesWatched 指標はサポートされなくなりました。これらの指標は YouTube Studio では利用できなかったため、この変更により、API の機能が Studio アプリケーションで利用可能な機能と一致するようになります。
  • subscribedStatus ディメンションと youtubeProduct ディメンションは、チャンネル再生リスト レポートのフィルタとしてサポートされなくなりました。これらのフィルタは YouTube Studio では利用できなかったため、この変更により、API の機能が Studio アプリケーションで利用可能な機能と一致するようになります。

• コンテンツ所有者レポートのドキュメントの再生リスト レポート セクションが更新され、再生リスト レポートでサポートされている指標の種類についてより詳しく説明されるようになりました。

  • 集計された動画指標 コンテンツ所有者の再生リストに含まれるすべての動画（コンテンツ所有者が所有する動画）について集計された、ユーザー アクティビティとインプレッションの指標を提供します。集計された動画指標は、isCurated ディメンションを使用しない API リクエストでのみサポートされます。
  • 再生リスト内の指標は、再生リストページでのユーザーのアクティビティとエンゲージメントを反映しています。これらの指標には、再生リスト内の所有していない動画の視聴回数も含まれますが、これは再生リストのコンテキストで視聴された場合に限られます。
  • サポートされている再生リストの指標セクションでは、再生リスト レポートでサポートされている集計動画指標と再生リスト内指標について説明します。

• コンテンツ所有者の再生リスト レポートでは、次の新しい再生リスト内指標がサポートされています。これらの指標は、レポートを取得する API リクエストで isCurated ディメンションが使用されていない場合にのみサポートされます。各指標の定義については、指標のドキュメントをご覧ください。

  • playlistAverageViewDuration
  • playlistEstimatedMinutesWatched
  • playlistSaves
  • playlistViews

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

  • リクエストに isCurated ディメンションが含まれている場合、views 指標は、コンテンツ所有者の再生リストのコンテキストで動画が視聴された回数を示す再生リスト内指標です。
  • リクエストに isCurated ディメンションが含まれていない場合、views 指標は、コンテンツ所有者の再生リスト内の動画が視聴された合計回数を指定する集計動画指標です。これらの視聴が再生リストのコンテキストで行われたかどうかは関係ありません。集計された合計には、再生リストを所有するチャンネルに関連付けられたコンテンツ所有者が所有する動画の視聴回数のみが含まれます。
    
    isCurated ディメンションを使用しないこれらのレポートでは、playlistViews 指標は、再生リストのコンテキストで動画が視聴された回数を示します。この指標では、再生リスト内のすべての動画の視聴回数がカウントされます（動画を所有するチャンネルは問いません）。

• 各再生リスト レポートについて、コンテンツ所有者レポートのドキュメントに、API リクエストに isCurated ディメンションが含まれているかどうかに応じて、そのレポートでサポートされている指標を示す表が追加されました。例については、時間ベースの再生リスト レポートを定義するセクションをご覧ください。

2024 年 1 月 19 日

重要: 2024 年 6 月 30 日までに、チャンネルの再生リスト レポートを更新してください。

YouTube アナリティクス（ターゲット クエリ）API には、チャンネルの再生リスト レポートに関連するいくつかの更新があります。この更新には、非推奨となったディメンションと、いくつかの新しい指標および更新された指標が含まれています。

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

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

  更新（2024 年 4 月 2 日）: isCurated ディメンションは、コンテンツ所有者レポートでも非推奨になりました。これらのレポートでは、2024 年 12 月 31 日以降、このディメンションはサポートされなくなります。
  重要: API リクエストから isCurated ディメンションを削除する場合は、アプリケーションに追加の変更を加える必要があります。

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

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

  • continent や subcontinent などの地域フィルタは、新しいチャンネル再生リスト レポートではサポートされていません。
  • 新しいチャンネル再生リスト レポートでは、redViews 指標と estimatedRedMinutesWatched 指標はサポートされなくなりました。これらの指標は YouTube Studio では利用できなかったため、この変更により、API の機能が Studio アプリケーションで利用可能な機能と一致するようになります。
  • subscribedStatus ディメンションと youtubeProduct ディメンションは、チャンネル再生リスト レポートのフィルタとしてサポートされなくなりました。これらのフィルタは YouTube Studio では利用できなかったため、この変更により、API の機能が Studio アプリケーションで利用可能な機能と一致するようになります。

• チャンネル レポートのドキュメントの再生リスト レポートのセクションが更新され、再生リスト レポートでサポートされている指標の種類についてより詳しく説明されるようになりました。

  • 集計された動画指標 チャンネルの再生リストに含まれるすべての動画（そのチャンネルが所有する動画）について集計された、ユーザー アクティビティとインプレッションの指標を提供します。集計された動画指標は、isCurated ディメンションを使用しない API リクエストでのみサポートされます。
  • 再生リスト内の指標は、再生リストページでのユーザーのアクティビティとエンゲージメントを反映しています。これらの指標には、再生リスト内の所有していない動画の視聴回数も含まれますが、これは再生リストのコンテキストで視聴された場合に限られます。
  • サポートされている再生リストの指標セクションでは、再生リスト レポートでサポートされている集計動画指標と再生リスト内指標について説明します。

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

  • playlistAverageViewDuration
  • playlistEstimatedMinutesWatched
  • playlistSaves
  • playlistViews

• 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 アナリティクス（ターゲット クエリ）API で、2 つの新しいディメンションと 1 つの新しいレポートがサポートされるようになりました。

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

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

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

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

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

2022 年 8 月 26 日

YouTube アナリティクス（ターゲット クエリ）API と YouTube Reporting（一括レポート）API の両方で、新しいトラフィック ソースの詳細値がサポートされるようになりました。

• YouTube Analytics API（ターゲット クエリ）API で、insightTrafficSourceType ディメンションの値が SUBSCRIBER の場合、insightTrafficSourceDetail 値を podcasts に設定できます。これは、トラフィックがポッドキャストのリンク先ページから参照されたことを示します。
• YouTube Reporting（一括レポート）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 アナリティクス（ターゲット クエリ）API では、gender ディメンションは現在、female と male の 2 つの値をサポートしています。2022 年 8 月 11 日以降、このディメンションは female、male、user_specified の 3 つの値をサポートします。
• YouTube Reporting（一括レポート）API では、gender ディメンションは現在、FEMALE、MALE、GENDER_OTHER の 3 つの値をサポートしています。2022 年 8 月 11 日以降、サポートされている値のセットは FEMALE、MALE、USER_SPECIFIED に変更されます。

2022 年 2 月 9 日

2021 年 12 月 13 日より、ループ再生されるクリップのトラフィックを除外するように 2 つの指標が更新されました。この変更は、YouTube アナリティクス（ターゲット クエリ）API と YouTube Reporting（一括レポート）API の両方に影響します。

• YouTube アナリティクス（ターゲット クエリ）API では、2021 年 12 月 13 日以降、averageViewDuration 指標と averageViewPercentage 指標の両方でループ再生されるクリップのトラフィックが除外されます。
• YouTube Reporting（一括レポート）API では、2021 年 12 月 13 日以降、average_view_duration_seconds 指標と average_view_duration_percentage 指標の両方でループ再生クリップのトラフィックが除外されています。

2022 年 2 月 2 日

この YouTube Reporting（一括レポート）API は、ライブ リダイレクトから視聴されたことを示す新しいトラフィック ソース ディメンション値をサポートしています。

• YouTube Reporting（一括レポート）API では、traffic_source_type ディメンションは値 28 をサポートしています。

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

2020 年 9 月 23 日

YouTube Analytics（ターゲット クエリ）API と YouTube Reporting（一括レポート）API の両方で、新しいトラフィック ソース ディメンション値がサポートされています。この値は、視聴者が YouTube ショートの視聴画面で縦方向にスワイプして参照されたことを示します。

• YouTube Analytics API（ターゲット クエリ）API では、insightTrafficSourceType ディメンションは SHORTS の値をサポートしています。
• YouTube Reporting（一括レポート）API では、traffic_source_type ディメンションは値 24 をサポートしています。

この新しいトラフィック ソースの種類では、トラフィック ソースの詳細ディメンション（YouTube Analytics API の insightTrafficSourceDetail、または YouTube Reporting API の traffic_source_detail）は入力されません。

2020 年 7 月 20 日

この更新には、YouTube アナリティクス（ターゲット クエリ）API に影響する 2 つの変更が含まれています。

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

2020 年 2 月 13 日

この更新には、YouTube アナリティクス（ターゲット クエリ）API と YouTube Reporting（一括レポート）API に関連する以下の変更が含まれています。今回の変更の詳細については、YouTube ヘルプセンターでご確認いただけます。

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

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

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

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

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

2019 年 10 月 15 日

このアップデートには、YouTube アナリティクス（ターゲット クエリ）API に関連する次の変更が含まれています。

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

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

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

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

2019 年 6 月 27 日

このアップデートには、YouTube アナリティクス（ターゲット クエリ）API に関連する次の変更が含まれています。

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

2018 年 11 月 1 日

このアップデートには、YouTube アナリティクス（ターゲット クエリ）API に関連する次の変更が含まれています。

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

  このサポート終了のスケジュールは、当初 2018 年 4 月 26 日に発表されたものです。

2018 年 9 月 17 日

このアップデートには、YouTube アナリティクス（ターゲット クエリ）API に関連する次の変更が含まれています。

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

  1. 指定した期間の動画またはチャンネルのトラフィックが少ない

     または

  2. 値が一定のしきい値を満たしていない、トラフィック ソースや国などのフィルタやディメンションを選択した場合です。

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

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

2018 年 6 月 18 日

このアップデートには、YouTube アナリティクス（ターゲット クエリ）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 つのスコープを使用します。2 番目のオプションでは、2 つの読み取り専用スコープを使用します。

2018 年 5 月 23 日

このアップデートには、YouTube アナリティクス（ターゲット クエリ）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（一括レポート）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（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 の異なるメソッドへのリクエストで構成できます）。このサポート終了は、YouTube Analytics API に固有のものではありません。Google は、すべての API でグローバル バッチ エンドポイントのサポートを終了します。
  • v2 API は、API v1 でサポートされていた JSON-RPC プロトコルをサポートしていません。なお、このサポート終了は YouTube Analytics API に固有のものではありません。

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

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

2018 年 2 月 21 日

このアップデートには、YouTube アナリティクス（ターゲット クエリ）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 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 指標のサポート終了が発表されました。（同時に、API には同じデータを提供する 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 月 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 を介してその収益データにアクセスできるようになりました。

• この API は、収益に関連する次の指標をサポートしています。

  • adImpressions
  • cpm
  • estimatedAdRevenue
  • estimatedRedPartnerRevenue
  • estimatedRevenue
  • grossRevenue
  • monetizedPlaybacks
  • playbackBasedCpm

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

  • 基本的なユーザー アクティビティの統計情報
  • 特定の期間における国別のユーザー アクティビティ
  • 国別のユーザー アクティビティ
  • 上位の動画（地域フィルタを適用可能）

• チャンネル所有者は、広告のパフォーマンス レポートも取得できるようになりました。このレポートは、adType ディメンションとオプションの day ディメンションをサポートしています。

• YouTube Analytics API のリクエストの例ガイドに、チャンネルの収益レポートのセクションが追加されました。

2017 年 3 月 17 日

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

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

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

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

2017 年 3 月 3 日

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

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

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

    通常、1 日は 24 時間ですが、時計を 1 時間進める日は 23 時間、時計を 1 時間戻す日は 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 に関連するディメンションの説明を修正し、ディメンション値が、指定された日、月、年の午前 12 時（太平洋時間）から午後 11 時 59 分（太平洋時間）までの期間を指すことを明記しました。時期に応じて、太平洋時間は UTC-7 または UTC-8 になります。

    通常、1 日は 24 時間ですが、時計を 1 時間進める日は 23 時間、時計を 1 時間戻す日は 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 日に発表されました）。

• チャンネル レポート

  • channel_basic_a1 - channel_basic_a2 レポートに置き換えられました。
  • channel_province_a1 - channel_province_a2 レポートに置き換えられました。
  • channel_playback_location_a1 - channel_playback_location_a2 レポートに置き換えられました。
  • channel_traffic_source_a1 - channel_traffic_source_a2 レポートに置き換えられました。
  • channel_device_os_a1 - channel_device_os_a2 レポートに置き換えられました。
  • channel_subtitles_a1 - channel_subtitles_a2 レポートに置き換えられました。
  • channel_combined_a1 - channel_combined_a2 レポートに置き換えられました。

• コンテンツ所有者レポート

  • content_owner_basic_a2 - content_owner_basic_a3 レポートに置き換えられました。
  • content_owner_province_a1 - content_owner_province_a2 レポートに置き換えられました。
  • content_owner_playback_location_a1 - content_owner_playback_location_a2 レポートに置き換えられました。
  • content_owner_traffic_source_a1 - content_owner_traffic_source_a2 レポートに置き換えられました。
  • content_owner_device_os_a1 - content_owner_device_os_a2 レポートに置き換えられました。
  • content_owner_subtitles_a1 - content_owner_subtitles_a2 レポートに置き換えられました。
  • content_owner_combined_a1 - content_owner_combined_a2 レポートに置き換えられました。
  • content_owner_asset_basic_a1 - content_owner_asset_basic_a2 レポートに置き換えられました。
  • content_owner_asset_province_a1 - content_owner_asset_province_a2 レポートに置き換えられました。
  • content_owner_asset_playback_location_a1 - content_owner_asset_playback_location_a2 レポートに置き換えられました。
  • content_owner_asset_traffic_source_a1 - content_owner_asset_traffic_source_a2 レポートに置き換えられました。
  • content_owner_asset_device_os_a1 - content_owner_asset_device_os_a2 レポートに置き換えられました。
  • content_owner_asset_combined_a1 - content_owner_asset_combined_a2 レポートに置き換えられました。

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

2016 年 11 月 11 日

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

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

• 終了画面レポート

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

• 終了画面のディメンション

  • end_screen_element_type: 統計情報に関連付けられている終了画面要素のタイプ。
  • end_screen_element_id: YouTube が終了画面要素を一意に識別するために使用する ID。

• 終了画面の指標

  注: 終了画面の指標のデータは、2016 年 5 月 1 日以降のものが表示されます。

  • end_screen_element_impressions: 終了画面要素の合計インプレッション数。表示された終了画面要素ごとに 1 回のインプレッションが記録されます。
  • end_screen_element_clicks: 終了画面要素がクリックされた回数。
  • end_screen_element_click_rate: 終了画面要素のクリック率。

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

• 次のレポートはサポートが終了したため、ドキュメントから削除されました。各レポートの新しいバージョンが利用可能です。（これらのレポートのサポート終了のお知らせは、2016 年 6 月 22 日に発表されました）。

  • content_owner_ad_performance_a1 - content_owner_ad_rates_a1 レポートに置き換えられました。
  • content_owner_estimated_earnings_a1 - content_owner_estimated_revenue_a1 レポートに置き換えられました。
  • content_owner_asset_estimated_earnings_a1 - content_owner_asset_estimated_revenue_a1 レポートに置き換えられました。

2016 年 11 月 8 日

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

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

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

2016 年 10 月 27 日

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

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

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

• 動画あたりの 1 か月の世界全体の広告収入
• 動画ごとの日別、国別の広告収入
• アセットあたりの全世界の広告収入（月単位）
• アセットごとの日別、国別の広告収入
• 申し立て（このレポートには収益データは含まれません）

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_a2
    • channel_province_a2
    • channel_playback_location_a2
    • channel_traffic_source_a2
    • channel_device_os_a2
    • channel_subtitles_a2
    • channel_combined_a2

  • コンテンツ所有者の動画レポート

    • content_owner_basic_a3
    • content_owner_province_a2
    • content_owner_playback_location_a2
    • content_owner_traffic_source_a2
    • content_owner_device_os_a2
    • content_owner_subtitles_a2
    • content_owner_combined_a2

  • コンテンツ所有者のアセット レポート

    • content_owner_asset_basic_a2
    • content_owner_asset_province_a2
    • content_owner_asset_playback_location_a2
    • content_owner_asset_traffic_source_a2
    • content_owner_asset_device_os_a2
    • content_owner_asset_combined_a2

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

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

  • 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 日以降、YouTube がそれらのジョブの新しいレポートを生成することはありません。生成されたレポートは、生成後 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 エンジニアリングおよびデベロッパー ブログで詳しく説明されているとおり、現在の利用規約に多くの更新を加えたものです。2017 年 2 月 10 日に発効する更新版の利用規約に加えて、今回の更新には、デベロッパーが遵守する必要のあるポリシーを説明するいくつかのサポート ドキュメントが含まれています。

  新しいドキュメントの完全なセットについては、更新された利用規約の変更履歴をご覧ください。また、更新後の規約または関連ドキュメントに今後変更が加えられた場合も、その変更履歴で説明されます。

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 ディメンションで、バンパー広告を表す値 19 がサポートされるようになりました。バンパー広告とは、動画の再生前に表示される最長 6 秒のスキップ不可の動画広告です。

2016 年 7 月 18 日

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

• YouTube Analytics API（ターゲット クエリ）

  • 次のチャネル レポートでサポートされている指標のリストが更新され、カードの指標が含まれるようになりました。これらのレポートでのカード指標のサポートは、実際には 2016 年 6 月 28 日に追加されました。その日付の変更履歴エントリで、変更の詳細を説明しています。レポートは次のとおりです。
    • 米国の州の基本的なユーザー アクティビティ
    • 特定期間の米国各州におけるユーザー アクティビティ
    • 州別のユーザー アクティビティ
    • 登録ステータス別のユーザー アクティビティ
    • 州別の登録ステータスごとのユーザー アクティビティ
    • 州別の人気動画
    • チャンネル登録者またはチャンネル未登録の視聴者に人気のある動画

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

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

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

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

2016 年 6 月 28 日

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

• cardImpressions
• cardTeaserImpressions
• cardClicks
• cardTeaserClicks
• cardClickRate
• cardTeaserClickRate

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

• 基本的なデータ（チャンネル、コンテンツ所有者）
• 時間ベース（チャンネル、コンテンツ所有者）
• ユーザーの地域（チャンネル、コンテンツ所有者）
• チャンネル登録状況別のユーザー アクティビティ（チャンネル、コンテンツ所有者）
• 人気の動画（チャンネル、コンテンツ所有者）

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 という名前です。

    名前が変更された 2 つのレポートは、以前のレポートと次の点で異なります。

    • 新しい指標 estimated_partner_red_revenue が追加されます。これは、YouTube Red の定期購入による総収益の推定値です。
    • 新しい estimated_partner_transaction_revenue 指標が追加されます。これは、有料コンテンツや視聴者ファンディングなどの取引からの推定収益から、パートナーが請求した払い戻し額を差し引いたものです。
    • estimated_partner_ad_sense_revenue 指標の名前を estimated_partner_ad_auction_revenue に変更します。
    • estimated_partner_double_click_revenue 指標の名前を estimated_partner_ad_reserved_revenue に変更します。

  これらのレポートの古いバージョンを作成するジョブがすでにある場合は、名前が変更されたレポート用に新しいジョブを作成する必要があります。新しいレポート バージョンのリリースに伴い、content_owner_ad_performance_a1、content_owner_estimated_earnings_a1、content_owner_asset_estimated_earnings_a1 の各レポートは非推奨になりました。

  これらのレポートのジョブがある場合、2016 年 9 月 22 日以降、YouTube がそれらのジョブの新しいレポートを生成することはありません。生成されたレポートは、生成後 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 日以降、YouTube がそのジョブの新しいレポートを生成することはありません。生成されたレポートは、生成後 180 日間引き続きご利用いただけます。

• reportType、job、report の各リソースはすべて、関連付けられたリソースがサポート終了となったレポートタイプを表しているかどうかを識別する新しいプロパティをサポートしています。

  • 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 Red サブスクリプション収入データを含む、自動生成されたシステム管理レポートのセットをまもなくサポートする予定です。このレポートは、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 Inbox
  • 84: Android Messenger
• YouTube Analytics API では、sharingService ディメンションで次の新しい値がサポートされています。
  • ANDROID_MESSENGER: Android Messenger
  • INBOX: Google Inbox
  • 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 を使用して取得できます。この 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 以上を使用してください day、liveOrOnDemand、subscribedStatus、youtubeProduct
  指標:	1 つ以上使用する views、estimatedMinutesWatched
  フィルタ:	0 または 1 を使用します。 country、province、continent、subContinent 0 または 1 を使用します。 動画、グループ 0 以上を使用してください operatingSystem、liveOrOnDemand、subscribedStatus、youtubeProduct

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

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

  たとえば、ユーザーが video フィルタに 20 個の動画 ID を指定した API リクエストを送信したとします。ユーザーは 18 本の動画を所有しています。ただし、1 つの動画 ID は別のチャンネルが所有する動画を識別し、もう 1 つの 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 指標をサポートする動画レポートが特定されるようになりました。

  • 基本データ
  • 時間ベース
  • ユーザーの地域
  • 人気の動画 - このレポートでは、redPartnerRevenue も並べ替えの指標としてサポートされています。つまり、YouTube Red の収益で並べ替えた動画のリストを取得できます。

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

2015 年 10 月 29 日

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

• YouTube Reporting API の date ディメンションのドキュメントが修正され、日付が太平洋時間（UTC-8）の午前 12 時に始まる 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 が生成するレポートを識別します。ジョブを設定すると、YouTube によって日次レポートが生成され、非同期でダウンロードできるようになります。各レポートには、24 時間の固有の期間のデータが含まれます。

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

  • ドキュメント セットの [ガイド] タブには、API リクエストの承認手順など、両方の API に共通する情報が記載されています。
  • [一括レポート] タブには、YouTube Reporting API 専用のリファレンス ドキュメントなどのコンテンツが用意されています。
  • [ターゲット クエリ] タブには、YouTube Analytics API に特化したリファレンス ドキュメントなどのコンテンツが用意されています。
  • [サンプル] タブには、2 つの API のいずれかで使用できるコードサンプルが一覧表示されます。
  • [ツール] タブには、デベロッパーが 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 で、動画レポートの 2 つの新しい指標（videosAddedToPlaylists と videosRemovedFromPlaylists）がサポートされるようになりました。チャンネルとコンテンツ所有者の動画レポートのリストが更新され、新しい指標をサポートするレポートが特定できるようになりました。

  • 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 日

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

• 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 を超える可能性があります。

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

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

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

  • annotationImpressions: アノテーションのインプレッションの合計数。
  • annotationClickableImpressions: 表示され、クリック可能だったアノテーションの数。
  • annotationClosableImpressions: 表示され、閉じることができたアノテーションの数。
  • annotationClicks: クリックされたアノテーションの合計数。
  • annotationCloses: 終了したアノテーションの合計数。

  新しい指標はすべてコア指標であり、非推奨ポリシーの対象となります。ただし、新しい指標のデータは 2013 年 7 月 16 日以降のものが表示されます。（annotationClickThroughRate 指標と annotationCloseRate 指標のデータは、2012 年 6 月 10 日以降のものが表示されます）。

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

2014 年 1 月 31 日

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

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

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

2014 年 1 月 16 日

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

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

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

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

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

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

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

2014 年 1 月 6 日

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

• サポートされているチャンネル レポートとコンテンツ所有者 レポートを一覧表示するドキュメントのデザインが変更されました。各ドキュメントでは、考えられるすべてのレポートを一覧表示するのではなく、レポートをカテゴリにグループ化しています。

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

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

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

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

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

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

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

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

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

May 23, 2013 年 5 月 23 日

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

• コンテンツ所有者レポートのドキュメントを更新し、人気の動画レポートを収益の降順で並べ替えられることを反映しています。これにより、最も収益の高い動画を特定することができます。このレポートは、[ユーザー アクティビティと収益レポート] セクションの 2 つ目の表に最初に表示されます。

2013 年 5 月 10 日

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

• YouTube では、試験的な API の機能とサービスを識別しなくなりました。代わりに、非推奨ポリシーが適用される YouTube API のリストが提供されるようになりました。

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 で、動画中に表示されるアノテーションに対する視聴者の操作に関連する 2 つの新しい指標（annotationClickThroughRate と annotationCloseRate）がサポートされるようになりました。チャンネル レポートとコンテンツ所有者レポートのリストが更新され、新しい指標をサポートするレポートが特定できるようになりました。

  • 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 は、すべてのデベロッパーが利用できるようになりました。APIs console の [サービス] パネルから、最初にアクセスをリクエストすることなく、プロジェクトの API を有効にできます。

• 新しいスタートガイド セクションでは、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 ホームページに表示されるガイドなど、複数の場所で発生する可能性があることが説明されています。これらの指標を動画専用のレポートで表示した場合、そのレポートには、指定した動画の再生ページの統計情報だけが含まれます。