このページでは、YouTube Analytics API リクエストのサンプルを示します。各例では、取得されるレポートについて簡単に説明した後、対応する dimensions、metrics、filters、sort パラメータ値を示します。（チャンネル レポートとコンテンツ所有者レポートのドキュメントで、API がサポートするレポートを確認できます）。
各例は、Google APIs Explorer にリンクし、表示された値を入力します。これらの例では、デフォルトの開始日と終了日（YYYY-MM-DD）として 2023-09-01 と 2024-03-31 を使用しています。
API Explorer にリンクした後も、レポートを取得するチャンネルまたはコンテンツ所有者を指定する必要があります。API Explorer では、クリックしたクエリに応じて、ids パラメータ値に channel==MINE または contentOwner==CONTENT_OWNER_ID が入力されます。チャンネル レポートの場合は、MINE を認証済みユーザーのチャンネル ID に変更できます。コンテンツ所有者レポートの場合は、CONTENT_OWNER_ID をコンテンツ所有者 ID に置き換える必要があります。
また、API Explorer が OAuth 2.0 を使用して API リクエストを承認できるように、指定されたチャンネルまたはコンテンツ所有者として認証されている必要があります。
複数のディメンション/指標によるリクエストの並べ替え
この API は、複数のディメンションまたは指標を使用してレスポンス データを並べ替える機能をサポートしています。たとえば、次のリクエストは、特定のチャンネルの動画の 1 日あたりのトラフィック ソース データを取得します。結果セットの各行には、特定の種類のトラフィック ソース（EXT_URL など）から発生した視聴回数と推定総再生時間が特定の日付で示されます。
dimensions=day,insightTrafficSourceType
metrics=views,estimatedWatchTime
sort=day,-viewsレスポンスでは、結果は時系列で並べ替えられます。各日の結果セット内では、結果が表示回数の降順で並べ替えられます。つまり、結果セットの最初の行には、リクエストした期間の最初の日において最も多く再生回数を生成したトラフィック ソースのデータが含まれます。2 番目の行には、最初の日において 2 番目に多く再生回数を生成したトラフィック ソースのデータが含まれます。
チャンネル レポート
動画レポート
チャンネルの合計視聴回数、推定再生時間など
このクエリは、チャンネルのコンテンツに関する集計された指標を取得します。レポートは 1 行のデータを返します。この行には、リクエストした各指標の指定した期間における合計が含まれます。
metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDurationチャンネルの国別の視聴回数など
このクエリは、チャンネルの動画に関する特定の国の指標を取得します。レポートは 1 行のデータを返します。この行には、リクエストした各指標の指定した期間における合計が含まれます。
metrics=views,comments,likes,dislikes,estimatedMinutesWatched
filters=country==USトップ 10 – チャンネル内で最も視聴された動画
このクエリは、チャンネル内で最も視聴された上位 10 本の動画を取得します。これは、指定された期間における推定再生時間（分）に基づいた順位です。結果は推定再生時間の降順に並べ替えられます。
注: このレポートでは、sort リクエスト パラメータの値を指定し、maxResults パラメータを 10 以下の整数値に設定する必要があります。
dimensions=video
metrics=estimatedMinutesWatched,views,likes,subscribersGained
maxResults=10
sort=-estimatedMinutesWatched上位 10 件 - チャンネルの視聴回数上位の動画のアノテーションのクリック率
このリクエストは、チャンネルで最も視聴された 10 本の動画の視聴回数、アノテーションのクリック率、アノテーションのクローズ率、アノテーションのインプレッション数を取得します。結果は視聴回数の降順で並べ替えられます。つまり、視聴回数の多い動画が先頭に表示されます。
注: このレポートでは、sort リクエスト パラメータの値を指定し、maxResults パラメータを 10 以下の整数値に設定する必要があります。
dimensions=video
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
maxResults=10
sort=-views再生リストレポート
チャンネルの再生リストの合計視聴回数
このリクエストは、認証されたユーザーのチャンネルの再生リストについて、再生リストの合計開始回数、推定再生時間、視聴回数（動画の集計指標）、再生リストの視聴回数（再生リスト内の指標）、再生リストの開始回数あたりの視聴回数を取得します。
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart特定の再生リストの統計情報
このリクエストでは、特定の再生リストの再生リストの開始回数、推定総再生時間、視聴回数（動画の集計指標）、再生リストの視聴回数（再生リスト内の指標）、再生リストの開始回数あたりの視聴回数を取得します。API Explorer でこのクエリを実行するには、filters パラメータ値の文字列 PLAYLIST_ID を、認証済みユーザーのチャンネル内の再生リストの再生リスト ID に置き換える必要があります。
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
filters=playlist==PLAYLIST_ID複数の再生リストの集計統計情報を取得するには、文字列 PLAYLIST_ID を、認証済みユーザーのチャンネル内の再生リストの最大 500 個の再生リスト ID のカンマ区切りリストに置き換えることもできます。
トップ 10 - チャンネルで最も視聴された再生リスト
このクエリは、指定した期間の再生リストの視聴回数に基づいて、チャンネルで最も視聴された再生リストを 10 件取得します。また、視聴者が各再生リストの再生を開始した回数や、再生リストの開始後に視聴者が再生リスト内の動画を視聴した平均時間など、再生リストに関するその他の指標も取得します。結果は再生リストの視聴回数の降順で並べ替えられます。
注: このレポートでは playlist ディメンションを使用しているため、sort リクエスト パラメータの値を指定するとともに、maxResults パラメータを 10 以下の整数値に設定する必要があります。
dimensions=playlist
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist,playlistSaves
maxResults=10
sort=-playlistViews動画レポート
チャンネルの動画の日別再生時間の指標
このクエリは、チャンネルの動画の日別の視聴回数、総再生時間の指標、新規チャンネル登録者数を取得します。レポートは、リクエストした期間内の日付ごとに 1 行のデータを返します。各行は時系列で並べ替えられます。
dimensions=day
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained
sort=dayチャンネルの動画のアノテーションに関する日別の指標
このリクエストは、チャンネルのコンテンツの日別の視聴回数、アノテーションのクリック率、アノテーションのクローズ率、アノテーションのインプレッションを取得します。結果は時系列で並べ替えられます。
dimensions=day
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
sort=day再生リストレポート
チャンネルの 1 日の再生リスト視聴回数
このリクエストは、認証されたユーザーのチャンネルの日別の視聴回数（動画の集計指標）、再生リストの視聴回数（再生リスト内の指標）、再生リストの開始回数、推定再生時間（分）、再生リストの開始回数あたりの視聴回数を取得します。結果は時系列で並べ替えられます。
dimensions=day
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
sort=day動画レポート
チャンネルの動画の国別再生時間の指標
このクエリは、チャンネルの動画の国別の視聴回数、総再生時間の指標、チャンネル登録者数を取得します。レポートは、チャンネルの動画が再生された国ごとに 1 行のデータを返します。各行は再生時間（分）で降順に並べ替えられます。
dimensions=country
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained
sort=-estimatedMinutesWatchedチャンネルの動画のアノテーションに関する国別の指標
このリクエストは、チャンネルの動画の国別の視聴回数、アノテーションのクリック率、アノテーションのクローズ率、アノテーションのインプレッション数を取得します。結果はアノテーションのクリック率の降順に並べ替えられます。つまり、アノテーションのクリック率が高い国の方がリストの最初に表示されます。
dimensions=country
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
sort=-annotationClickThroughRate米国の州とワシントン DC の州固有の指標
このリクエストでは、チャンネルの動画の視聴回数、推定総再生時間、平均視聴時間の都道府県別の内訳を取得します。データは米国の州とワシントン D.C. を対象とします。結果は州の ISO 3166-2 コードのアルファベット順に並べ替えられます。
dimensions=province
metrics=views,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed;country==US
sort=provinceトップ 10 – 特定の国における再生回数が多い動画
このクエリは、チャンネル内で最も再生された上位 10 本の動画を取得します。これは、指定された国での指定された期間における再生回数に基づいた順位です。結果は視聴回数の降順で並べ替えられます。
注: このレポートでは、sort リクエスト パラメータの値を指定し、maxResults パラメータを 10 以下の整数値に設定する必要があります。
dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=country==US
maxResults=10
sort=-views合計視聴回数が多い米国の都市トップ 10
このクエリは、指定した期間にチャンネルのコンテンツの視聴回数が最も多かった米国の 10 都市のリストを取得します。このフィルタに別の有効な値を選択すると、別の国のデータがリクエストされるようにクエリを変更できます。同様に、subContinent フィルタとその有効な値のいずれかを使用して、クエリを変更して、西ヨーロッパや東南アジアなどのサブコンチネントのデータを取得することもできます。他のフィルタもサポートされています。結果は視聴回数の降順で並べ替えられます。
dimensions=city
metrics=views
filters=country==US
maxResults=10
sort=-viewsコンテンツ タイプ別の総再生回数で上位 10 位の米国の都市
このクエリは、サポートされている各 creatorContentType について、指定した期間にチャンネルのコンテンツの視聴回数が最も多かった米国の 10 都市のリストを取得します。結果は表示回数の降順で並べ替えられます。
dimensions=city,creatorContentType
metrics=views
filters=country==US
maxResults=10
sort=-views合計総再生時間の上位 10 都市（米国の都市）
このクエリは、指定した期間中に、チャンネルのコンテンツの 1 日あたりの総再生時間が最も長かった米国の都市の上位 10 日間のリストを取得します。クエリの結果には、総再生時間、再生された日付、コンテンツが視聴されたと推定される都市が表示されます。結果は総再生時間の降順で並べ替えられます。
dimensions=city,day
metrics=estimatedWatchTime
filters=country==US
maxResults=10
sort=-estimatedWatchTimeトップ 10 - ヨーロッパで視聴回数が特に多い動画
このクエリは、このチャンネルでヨーロッパで特に視聴回数が多い上位 10 本の動画を取得します。これらの動画は、指定した期間の視聴回数に基づいて測定されます。このフィルタに別の有効な値を選択すると、別の大陸のデータがリクエストされるようにクエリを変更できます。同様に、subContinent フィルタとその有効な値のいずれかを使用して、クエリを変更して、西ヨーロッパや東南アジアなどのサブコンチネントのデータを取得することもできます。結果は視聴回数の降順で並べ替えられます。
注: このレポートでは、sort リクエスト パラメータの値を指定し、maxResults パラメータを 10 以下の整数値に設定する必要があります。
dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=continent==150
maxResults=10
sort=-views再生リストレポート
チャンネルの再生リストの国別の総再生時間の指標
このクエリは、国別の視聴回数（動画の集計指標）、再生リストの視聴回数（再生リスト内の指標）、チャンネルの再生リストの総再生時間の指標を取得します。レポートには、チャンネルの再生リストが視聴された国ごとに 1 行のデータが返されます。各行は再生時間（分）で降順に並べ替えられます。
dimensions=country
metrics=views,estimatedMinutesWatched,playlistStarts,averageTimeInPlaylist
sort=-estimatedMinutesWatchedトップ 10 - 米国で最も再生された再生リスト
このクエリは、指定した期間に米国の視聴者が最も頻繁に視聴を開始した再生リストを 10 件取得します。結果は、再生リストの開始数の降順で並べ替えられます。
注: このレポートでは playlist ディメンションを使用するため、sort リクエスト パラメータの値を指定し、maxResults パラメータを 10 以下の整数値に設定する必要があります。
dimensions=playlist
metrics=playlistStarts,views,estimatedMinutesWatched,averageViewDuration
filters=isCurated==1;country==US
maxResults=10
sort=-playlistStarts動画レポート
各再生場所における再生回数と再生時間
このクエリは、特定のチャンネルの動画の再生回数と推定再生時間を取得します。結果は、動画が再生されたページまたはアプリケーションの種類に基づいて集計され、視聴回数の降順で並べ替えられます。
dimensions=insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
sort=-viewsさまざまな再生場所での 1 日の視聴回数と総再生時間
このクエリは、特定のチャンネルの動画について、米国での日別の視聴回数と推定再生時間を取得します。結果は、動画が再生されたページまたはアプリケーションの種類ごとに、日別でグループ化されます。結果は時系列で並べ替えられます。
dimensions=day,insightPlaybackLocationType metrics=estimatedMinutesWatched,views filters=country==US sort=day
トップ 10 – 埋め込み動画の再生を最も多く生成したサードパーティのサイト
このクエリは、特定の動画または動画のグループの視聴回数と推定再生時間を取得します。結果は、動画が埋め込まれていたサードパーティのサイト別にグループ化されます。結果は視聴回数の降順で並べ替えられます。API Explorer でこのクエリを実行するには、filters パラメータ値の文字列 VIDEO_ID を、アップロードした動画の 1 つ以上の動画 ID のカンマ区切りリストに置き換える必要があります。
dimensions=insightPlaybackLocationDetail
metrics=views,estimatedMinutesWatched
filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED
maxResults=10
sort=-views再生リストレポート
再生リストの視聴回数と再生時間（再生場所別）
このクエリは、特定のチャンネルの再生リストの視聴回数（動画の集計指標）、再生リストの視聴回数（再生リスト内の指標）、推定再生時間、再生リストの開始回数を取得します。結果は、動画の再生が発生したページまたはアプリケーションのタイプに基づいて集計され、再生リストの開始時間の降順で並べ替えられます。
dimensions=insightPlaybackLocationType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
sort=-playlistStarts再生リストの 1 日の視聴回数と再生時間（再生場所別）
このクエリは、特定のチャンネルの再生リストについて、米国での日別の再生リストの開始回数、再生回数（動画の集計指標）、再生リストの視聴回数（再生リスト内の指標）、推定総再生時間を取得します。結果は、再生リストの視聴が発生したページまたはアプリの種類ごとに日別にグループ化されます。結果は時系列順に並べ替えられます。
dimensions=day,insightPlaybackLocationType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
filters=country==US
sort=day動画レポート
コンテンツ タイプ別の高評価と低評価
このクエリは、チャンネルのコンテンツの種類ごとに高評価数と低評価数を取得します。
dimensions=creatorContentType
metrics=likes,dislikes動画レポート
特定の国におけるトラフィック ソース別の再生回数および再生時間
このリクエストは、特定の国におけるチャンネルの動画の再生回数と推定再生時間を取得します。各指標はトラフィック ソース別に集計されます。トラフィック ソースとは、ユーザーが動画にアクセスした方法です。
dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=country==USさまざまなトラフィック ソースからの 1 日あたりの視聴回数と総再生時間
このリクエストは、チャンネルの動画の 1 日あたりの視聴回数と 1 日の推定総再生時間を取得します。各指標は日別およびトラフィック ソース別に集計され、時系列で並べ替えられます。
dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched
sort=dayトップ 10 – 動画のトラフィックを最も多く生成した YouTube 検索キーワード
このクエリは、1 つ以上の特定の動画に対する YouTube 検索結果から、最も多くの視聴回数を獲得した 10 個の検索キーワードを取得します。結果は視聴回数の降順で並べ替えられます。API Explorer でこのクエリを実行するには、filters パラメータ値の文字列 VIDEO_ID を、最大 500 個の動画 ID のカンマ区切りリストに置き換える必要があります。
たとえば、単一の動画に対してクエリを実行するか、VIDEO_ID を置換して、その動画のトラフィックが最も多い検索キーワードを特定できます。特定の再生リスト内のすべての動画を一覧表示して、その再生リスト内の動画のいずれかで最も多くのトラフィックを発生させた検索語句を特定することもできます。
dimensions=insightTrafficSourceDetail
metrics=views
filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH
maxResults=10
sort=-viewsトップ 10 – 動画のトラフィックが最も多い外部ウェブサイト
このクエリは、特定の動画または動画のグループで最も多くの視聴回数を獲得した外部ウェブサイトを 10 件取得します。結果は推定再生時間の降順に並べ替えられます。API Explorer でこのクエリを実行するには、filters パラメータ値の文字列 VIDEO_ID を、アップロードした動画の動画 ID をカンマ区切りで最大 500 個指定したリストに置き換える必要があります。
dimensions=insightTrafficSourceDetail
metrics=estimatedMinutesWatched,views
filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL
maxResults=25
sort=-estimatedMinutesWatched再生リストレポート
ある国におけるさまざまなトラフィック ソースの再生リストの視聴回数と総再生時間
このリクエストでは、指定した国での視聴回数（動画に関する集計指標）、再生リストの視聴回数（再生リスト内の指標）、再生リストの開始回数、再生リスト視聴の推定総再生時間を取得します。指標はトラフィック ソース別に集計されます。トラフィック ソースは、ユーザーが再生リストにアクセスした方法を表します。
dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatchedplaylistStarts,playlistViews
filters=country==US各トラフィック ソースの再生リストの視聴回数と総再生時間（日別）
このリクエストは、チャンネルの日別の再生リストの視聴回数（再生リスト内の指標）、再生リストの開始回数、推定総再生時間を取得します。また、合計視聴回数（動画の集計指標）も取得します。各指標は日別およびトラフィック ソース別に集計され、時系列で並べ替えられます。
dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews
sort=day動画レポート
Android オペレーティング システムの端末のタイプに関する日別の指標
このクエリは、Android デバイスで特定のチャンネルの動画について、1 日あたりの視聴回数と推定総再生時間を取得します。結果は、動画が再生された端末のタイプごとに日別でグループ化されます。結果は時系列で並べ替えられます。
dimensions=day,deviceType
metrics=estimatedMinutesWatched,views
filters=operatingSystem==ANDROID
sort=day携帯端末のオペレーティング システムに関する日別の指標
このクエリは、特定のチャンネルの動画について、モバイル デバイスでの 1 日あたりの視聴回数と推定総再生時間を取得します。結果は、動画が再生されたオペレーティング システムごとに日別でグループ化されます。結果は時系列で並べ替えられます。
dimensions=day,operatingSystem
metrics=estimatedMinutesWatched,views
filters=deviceType==MOBILE
sort=dayオペレーティング システムと端末のタイプに関する日別の指標
このクエリは、チャンネルの日別の視聴回数と推定再生時間を取得します。統計結果はオペレーティング システムと端末のタイプによってグループ化されます。結果は時系列で並べ替えられます。
dimensions=day,operatingSystem,deviceType
metrics=estimatedMinutesWatched,views
sort=day再生リストレポート
Android オペレーティング システムでの再生リストの視聴回数に関するデバイスの種類の 1 日あたりの指標
このクエリは、特定のチャンネルの再生リストについて、Android デバイスでの日別の視聴回数（動画の集計指標）、再生リストの視聴回数（再生リスト内の指標）、推定再生時間を取得します。結果は、再生リストの視聴が発生したデバイスの種類ごとに日別にグループ化されます。結果は時系列で並べ替えられます。
dimensions=day,deviceType
metrics=views,estimatedMinutesWatched,playlistViews
filters=operatingSystem==ANDROID
sort=dayモバイル デバイスでの再生リストの視聴回数に関する 1 日の OS 指標
このクエリは、特定のチャンネルの再生リストの日別の視聴回数（動画の集計指標）、再生リストの視聴回数（再生リスト内の指標）、モバイル デバイスでの推定総再生時間を取得します。結果は、再生リストの視聴が発生したオペレーティング システムごとに日別にグループ化されます。結果は時系列で並べ替えられます。
dimensions=day,operatingSystem
metrics=views,estimatedMinutesWatched
filters=deviceType==MOBILE
sort=day動画レポート
カリフォルニア州の視聴者のユーザー属性（年齢層と性別）
このレポートでは、チャンネルの動画の視聴者のうち、カリフォルニア州に居住する視聴者の年齢層と性別に関する統計情報を取得できます。結果は、性別、年齢層の順に並べ替えられます。このクエリは、filters パラメータの値を調整することで、世界中のすべての視聴者、または国、大陸、サブ大陸、米国の他の州のすべての視聴者について同じ統計情報を取得するように変更できます。
dimensions=ageGroup,gender
metrics=viewerPercentage
filters=province==US-CA
sort=gender,ageGroup再生リストレポート
カリフォルニア州の再生リスト視聴者のユーザー属性（年齢層と性別）
このレポートでは、チャンネルの再生リストを視聴したカリフォルニア州の視聴者の年齢層と性別に関する統計情報を取得します。結果は、性別、年齢層の順に並べ替えられます。このクエリは、filters パラメータの値を調整することで、世界中のすべての視聴者、または国、大陸、亜大陸、米国の他の州のすべての視聴者について同じ統計情報を取得するように変更できます。
dimensions=ageGroup,gender
metrics=viewerPercentage
filters=province==US-CA
sort=gender,ageGroup共有に関する指標（動画が共有されているサービス別に集計）
このリクエストは、ユーザーが Share ボタンを使用してチャンネルの動画の共有を行った回数を取得します。結果は共有サービス別（Google+、Twitter など）に集計され、共有回数の降順に並べ替えられます。
dimensions=sharingService
metrics=shares
sort=-shares動画の視聴者維持率の指標
このレポートでは、動画が視聴者の注目をどの程度維持できたかを確認できます。レポートを取得できるのは、一度に 1 つの動画に対してのみです。API Explorer でこのクエリを実行するには、filters パラメータ値の文字列 VIDEO_ID を、アップロードした動画の動画 ID に置き換える必要があります。視聴者維持率レポートでは、video フィルタに複数の値を指定することはできません。
この例では、レポートで audienceType フィルタを使用してレスポンスを制限し、オーガニック ビューのデータのみが含まれるようにしています。オーガニック ビューのデータは、動画の検索、関連動画のクリックなど、ユーザーの直接的な操作の結果です。TrueView インストリーム広告または TrueView インディスプレイ広告の視聴回数のデータは、レポートに含まれません。フィルタを削除すると、すべての視聴者タイプから動画の視聴者維持率データを取得できます。
なお、audienceType フィルタのデータは、2013 年 9 月 25 日以降のものです。フィルタを使用してそれより前の日付のデータを取得しようとするクエリに対しては、API はデータを返しません。このフィルタを使用しないクエリは、2008 年 7 月 1 日以降の日付に対して機能します。
dimensions=elapsedVideoTimeRatio
metrics=audienceWatchRatio,relativeRetentionPerformance
filters=video==VIDEO_ID;audienceType==ORGANICチャンネルの収益と広告のパフォーマンスに関する指標
このリクエストでは、チャンネルの収益と広告のパフォーマンスの指標を取得します。レポートは 1 行のデータを返します。この行には、リクエストした各指標の指定した期間における合計が含まれます。
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks日別収益と広告パフォーマンスの指標
このリクエストは、チャンネルの日次収益と広告パフォーマンスの指標を取得します。
dimensions=day
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks国別の収益と広告のパフォーマンス指標
このリクエストは、チャンネルの国別の収益と広告のパフォーマンス指標を取得します。結果は収益額の降順で並べ替えられます。つまり、最初に表示される国が、パートナー様の純収益が最も高い国になります。
dimensions=country
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
sort=-estimatedRevenueトップ 10 – 収益が最も高い動画
このリクエストは、チャンネルの収益が最も多い 10 本の動画の収益と広告のパフォーマンスの指標を取得します。結果は収益額の降順で並べ替えられます。つまり、最初の動画は推定収益が最も高い動画になります。
dimensions=video
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
maxResults=10
sort=-estimatedRevenue広告タイプ別の広告の掲載結果の指標
このリクエストは、コンテンツ所有者によって申し立てが行われたコンテンツの広告の掲載結果に関する指標を取得します。結果は広告タイプ別にグループ化されるため、広告タイプ間で収益と CPM の値を比較できます。
dimensions=adType
metrics=grossRevenue,adImpressions,cpm
filters=claimedStatus==claimed
sort=-adTypeコンテンツ所有者レポート
動画レポート
申し立てが行われたすべてのコンテンツの合計視聴回数、推定総再生時間など
このクエリは、コンテンツ所有者によって申し立てが行われたコンテンツについて集計された指標を取得します。レポートは 1 行のデータを返します。この行には、リクエストした各指標の指定した期間における合計が含まれます。
metrics=views,comments,likes,dislikes,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimedすべてのセルフアップロード動画の国別の視聴回数（その他）
このクエリは、コンテンツ所有者がアップロードした動画の特定の国における指標を取得します。レポートは 1 行のデータを返します。この行には、リクエストした各指標の指定した期間における合計が含まれます。
metrics=views,comments,likes,dislikes,shares
filters=uploaderType==self;country==FR申し立てを受けたすべての第三者のコンテンツの合計視聴回数（その他）
このクエリは、コンテンツ所有者が申し立てを行い、コンテンツ所有者自身がアップロードしたものではない動画について集計された指標を取得します。レポートは 1 行のデータを返します。この行には、リクエストした各指標の指定した期間における合計が含まれます。
metrics=views,comments,likes,dislikes,shares
filters=uploaderType==thirdParty;claimedStatus==claimed自分でアップロードしたすべてのコンテンツの合計視聴回数など
このクエリは、コンテンツ所有者がアップロードした動画について集計された指標を取得します。レポートは 1 行のデータを返します。この行には、リクエストした各指標の指定した期間における合計が含まれます。
metrics=views,comments,likes,dislikes,estimatedMinutesWatched
filters=uploaderType==self申し立てを受けた、自身でアップロードしたすべてのコンテンツの合計視聴回数など
このクエリは、コンテンツ所有者がアップロードし、さらには申し立てが行われた動画について集計された指標を取得します。レポートは 1 行のデータを返します。この行には、リクエストした各指標の指定した期間における合計が含まれます。
metrics=views,comments,likes,dislikes,estimatedMinutesWatched
filters=uploaderType==self;claimedStatus==claimedトップ 10 – コンテンツ所有者の最も再生回数の多い動画
このクエリは、コンテンツ所有者がアップロードした動画の中で、指定した期間において最も再生回数の多い上位 10 本の動画を取得します。結果は視聴回数の降順で並べ替えられます。
dimensions=video
metrics=views,estimatedMinutesWatched,estimatedRevenue,estimatedAdRevenue,monetizedPlaybacks,adImpressions
filters=uploaderType==self
maxResults=10
sort=-viewsトップ 10 – コンテンツ所有者の最も視聴された動画
このクエリは、コンテンツ所有者がアップロードした動画の中で、指定した期間において最も視聴された上位 10 本の動画を取得します。これは、推定再生時間（分）に基づいた順位です。結果は推定再生時間の降順に並べ替えられます。
dimensions=video
metrics=estimatedMinutesWatched,averageViewDuration,averageViewPercentage,views,subscribersGained
filters=uploaderType==self
maxResults=10
sort=-estimatedMinutesWatched上位 10 件 - コンテンツ所有者のチャンネルで最も視聴された動画
このクエリは、コンテンツ所有者が管理する特定のチャンネルまたはチャンネル グループについて、再生回数の多い上位 10 本の動画を取得します。結果は表示回数の降順で並べ替えられます。API Explorer でこのクエリを実行するには、filters パラメータ値の文字列 CHANNEL_ID を、チャンネルのチャンネル ID をカンマ区切りで最大 500 個指定したリストに置き換える必要があります。
dimensions=video
metrics=views
filters=channel==CHANNEL_ID
maxResults=10
sort=-views上位 10 件 - チャンネルの視聴回数上位の動画のアノテーションのクリック率
このリクエストは、指定したチャンネルまたはチャンネル グループで最も視聴された 10 本の動画の視聴回数、アノテーションのクリック率、アノテーションのクローズ率、アノテーションのインプレッションを取得します。結果は視聴回数の降順で並べ替えられます。つまり、視聴回数の多い動画が先頭に表示されます。API Explorer でこのクエリを実行するには、filters パラメータ値の文字列 CHANNEL_ID を、チャンネルのチャンネル ID をカンマ区切りで最大 500 個指定したリストに置き換える必要があります。
dimensions=video
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=channel==CHANNEL_ID
maxResults=10
sort=-views再生リストレポート
コンテンツ所有者のチャンネルの再生リストの視聴回数
このリクエストは、コンテンツ所有者のチャンネルにある再生リストについて、再生リストの合計開始回数、再生リストの推定再生時間（分）、再生リストの視聴回数、再生リストの開始あたりの視聴回数を取得します。playlistViews 指標は、再生リスト内で発生した動画視聴のみをカウントします。リクエストされた指標はすべて再生リスト内の指標であるため、リクエストに再生リストまたはグループのフィルタを含める必要もありません。
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart特定の再生リストの統計情報
このリクエストでは、特定の再生リストの再生リストの開始回数、推定総再生時間、視聴回数（動画の集計指標）、再生リストの視聴回数（再生リスト内の指標）、再生リストの開始回数あたりの視聴回数を取得します。API Explorer でこのクエリを実行するには、filters パラメータ値の文字列 PLAYLIST_ID を、コンテンツ所有者のいずれかのチャンネルの再生リストの再生リスト ID に置き換える必要があります。
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
filters=playlist==PLAYLIST_ID複数の再生リストの集計統計情報を取得するには、文字列 PLAYLIST_ID を、コンテンツ所有者のチャンネル内の再生リストの最大 500 個の再生リスト ID のカンマ区切りリストに置き換えることもできます。
動画レポート
自身がアップロードしたコンテンツの日別再生時間の指標
このクエリは、1 日の総再生時間の指標のほか、コンテンツ所有者がアップロードした動画の視聴回数、収益化対象の再生回数、インプレッション数を取得します。レポートは、期間内の日付ごとに 1 行のデータとして返されます。各行は時系列で並べ替えられます。
dimensions=day
metrics=estimatedMinutesWatched,averageViewPercentage,views,monetizedPlaybacks,adImpressions
filters=uploaderType==self
sort=day申し立てが行われたコンテンツのアノテーションに関する指標
このリクエストは、コンテンツ所有者が申し立てたコンテンツの日別の視聴回数、アノテーションのクリック率、アノテーションのクローズ率、アノテーションのインプレッションを取得します。結果は時系列で並べ替えられます。
dimensions=day
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=claimedStatus==claimed
sort=day再生リストレポート
コンテンツ所有者の 1 日の再生リストの視聴回数
このリクエストは、コンテンツ所有者の再生リスト内の動画に対するユーザーのインタラクションの日別指標を取得します。レポートで取得される指標は、再生リストの視聴回数、再生リストの開始回数、再生リストの総再生時間（推定）、再生リストの開始回数あたりの視聴回数です。これらの指標はすべて再生リスト内の指標です。リクエストされた指標はすべて再生リスト内の指標であるため、リクエストに再生リストまたはグループのフィルタを含める必要はありません。
dimensions=day
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart
sort=day動画レポート
自身がアップロードしたコンテンツの国別再生時間の指標
このクエリは、各国の視聴回数、総再生時間の指標、推定広告収入を取得します。この指標は、コンテンツ所有者がアップロードした動画に関するものです。レポートは、動画が再生された国ごとに 1 行のデータとして返されます。各行は再生時間の降順に並べ替えられます。
dimensions=country
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,estimatedRevenue,estimatedAdRevenue,grossRevenue
filters=uploaderType==self
sort=-estimatedMinutesWatched自身がアップロードしたコンテンツのアノテーションに関する国別の指標
このリクエストは、コンテンツ所有者がアップロードした動画の国別の視聴回数、アノテーションのクリック率、アノテーションの閉じる率、アノテーションのインプレッションを取得します。結果はアノテーションのクリック率の降順に並べ替えられます。つまり、アノテーションのクリック率が高い国の方がリストの最初に表示されます。
dimensions=country
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=uploaderType==self
sort=-annotationClickThroughRate米国の州とワシントン DC の州固有の指標
このリクエストは、コンテンツ所有者が申し立てを行った動画の視聴回数、推定再生時間、平均視聴時間に関する州ごとの内訳を取得します。データは米国の州とワシントン D.C. を対象としています。結果は、州の ISO 3166-2 コードでアルファベット順に並べ替えられます。
dimensions=province
metrics=views,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed;country==US
sort=province合計視聴回数が多い米国の都市トップ 10
このクエリは、指定した期間にコンテンツ所有者の申し立てを受けた動画の視聴回数が最も多かった米国の 10 都市のリストを取得します。フィルタに別の有効な値を選択することで、別の国のデータをリクエストするようにクエリを変更できます。同様に、subContinent フィルタとその有効な値のいずれかを使用して、西ヨーロッパや東南アジアなどの亜大陸のデータを取得するようにクエリを変更できます。他のフィルタもサポートされています。結果は表示回数の降順で並べ替えられます。
dimensions=city
metrics=views
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-viewsコンテンツ タイプ別の総再生回数で上位 10 位の米国の都市
このクエリは、サポートされている各creatorContentType について、指定した期間にコンテンツ所有者の申し立て対象コンテンツの視聴回数が最も多かった米国の 10 都市のリストを取得します。結果は表示回数の降順で並べ替えられます。
dimensions=city,creatorContentType
metrics=views
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-views総再生時間が上位の米国の都市トップ 10
このクエリは、指定した期間中に、コンテンツ所有者の申し立て対象コンテンツの日別の総再生時間が最も長かった米国の都市の上位 10 日間のリストを取得します。クエリの結果には、総再生時間、再生時間が発生した日付、コンテンツが視聴されたと推定される都市が表示されます。結果は総再生時間の降順で並べ替えられます。
dimensions=city,day
metrics=estimatedWatchTime
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-estimatedWatchTimeトップ 10 - ヨーロッパで視聴回数の多い動画
このクエリは、指定した期間の再生回数に基づいて、コンテンツ所有者から申し立てを受けた動画のうち、ヨーロッパで最も視聴された動画を 10 件取得します。フィルタに別の有効な値を選択することで、別の大陸のデータをリクエストするようにクエリを変更できます。同様に、subContinent フィルタとその有効な値のいずれかを使用して、クエリを変更して、西ヨーロッパや東南アジアなどのサブコンチネントのデータを取得することもできます。結果は表示回数の降順で並べ替えられます。
dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=claimedStatus==claimed;filters=continent==150
maxResults=10
sort=-estimatedMinutesWatched再生リストレポート
コンテンツ所有者の再生リストの国別の総再生時間の指標
このクエリは、コンテンツ所有者のチャンネル内のすべての再生リストについて、国別の再生リストの視聴回数と再生リストの再生時間の指標を取得します。レポートには、再生された再生リストの国ごとに 1 行のデータが返されます。行は総再生時間の降順で並べ替えられます。
dimensions=country
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist
sort=-playlistEstimatedMinutesWatchedトップ 10 - 米国で最も再生された再生リスト
このクエリは、指定した期間に米国の視聴者が最も頻繁に視聴を開始したコンテンツ所有者のチャンネルの再生リストを 10 個取得します。結果は再生リストの開始回数の降順で並べ替えられます。
注: このレポートでは playlist ディメンションを使用しているため、リクエスト パラメータの値 sort を指定し、maxResults パラメータを 10 以下の整数値に設定する必要があります。
dimensions=playlist
metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched,playlistAverageViewDuration
filters=country==US
maxResults=10
sort=-playlistStarts動画レポート
コンテンツ タイプ別の高評価と低評価
このクエリは、特定のチャンネルまたはチャンネル グループのコンテンツの種類ごとに高評価と低評価の数を取得します。API Explorer でこのクエリを実行するには、filters パラメータ値の文字列 CHANNEL_ID を、チャネルの最大 500 個のチャネル ID のカンマ区切りリストに置き換える必要があります。
dimensions=creatorContentType
metrics=likes,dislikes
filters=channel==CHANNEL_ID動画レポート
各再生場所における再生回数と再生時間
このクエリは、特定のチャンネルまたはチャンネル グループにアップロードされた動画の視聴回数と推定総再生時間を取得します。結果は、動画の再生が発生したページまたはアプリケーションのタイプに基づいて集計され、視聴回数の降順で並べ替えられます。API Explorer でこのクエリを実行するには、filters パラメータ値の文字列 CHANNEL_ID を、チャネルの最大 500 個のチャネル ID のカンマ区切りリストに置き換える必要があります。
dimensions=insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=channel==CHANNEL_ID
sort=-viewsさまざまな再生場所での 1 日の視聴回数と総再生時間
このクエリは、特定のチャンネルまたはチャンネルのグループにアップロードされた動画の日別の視聴回数と米国での推定再生時間を取得します。結果は、動画が再生されたページまたはアプリケーションの種類ごとに、日別でグループ化されます。結果は新しい順に並べ替えられます。API Explorer でこのクエリを実行するには、filters パラメータ値の文字列 CHANNEL_ID を、チャンネルのチャンネル ID をカンマ区切りで最大 500 個指定したリストに置き換える必要があります。
dimensions=day,insightPlaybackLocationType
metrics=estimatedMinutesWatched,views
filters=country==US;channel==CHANNEL_ID
sort=-dayトップ 10 – 埋め込み動画の再生を最も多く生成したサードパーティのサイト
このクエリは、特定の動画または動画のグループについて、視聴回数と推定総再生時間を取得します。結果は、動画が埋め込まれていたサードパーティのサイト別にグループ化されます。結果は視聴回数の降順で並べ替えられます。API Explorer でこのクエリを実行するには、filters パラメータ値の文字列 VIDEO_ID を、アップロードした動画の動画 ID をカンマ区切りで最大 500 個指定したリストに置き換える必要があります。
dimensions=insightPlaybackLocationDetail
metrics=views,estimatedMinutesWatched
filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED
maxResults=10
sort=-views再生リストレポート
再生リストの視聴回数と再生時間（再生場所別）
このクエリは、コンテンツ所有者のチャンネル内のすべての再生リストの再生回数、再生リストの推定再生時間、再生リストの開始回数を取得します。結果は、動画が再生されたページまたはアプリケーションの種類に基づいて集計され、再生リストの開始順に降順で並べ替えられます。
dimensions=insightPlaybackLocationType
metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts
sort=-playlistStarts再生リストの視聴回数と再生時間（再生場所別）
このクエリは、コンテンツ所有者のチャンネル内のすべての再生リストについて、米国での日別の再生リストの開始回数、再生リストの視聴回数、再生リストの推定再生時間を取得します。再生リストの視聴が発生したページまたはアプリケーションの種類ごとに結果が返されます。
dimensions=day,insightPlaybackLocationType metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched filters=country==US
動画レポート
トラフィック ソース別の再生回数と再生時間
このリクエストは、コンテンツ所有者の動画の再生回数と推定再生時間を取得します。各指標はトラフィック ソース別に集計されます。トラフィック ソースとは、ユーザーが動画にアクセスした方法です。
dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=uploaderType==selfさまざまなトラフィック ソースの 1 日の視聴回数と総再生時間
このリクエストは、コンテンツ所有者の動画の日別の再生回数と日別の推定総再生時間を取得します。指標は日別およびトラフィック ソース別に集計され、新しい順に並べ替えられます。
dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=uploaderType==self
sort=-day注: 次の 2 つのサンプル レポートは、特定のトラフィック ソースでのみサポートされています。トラフィック ソースには、VIDEO_REMIXES、NOTIFICATION、END_SCREEN、CAMPAIGN_CARD、VIDEO_REMIXES、NO_LINK_EMBEDDED などが含まれています。
トップ 10 – 動画のトラフィックを最も多く生成した YouTube 検索キーワード
このクエリは、特定の動画または動画のグループの YouTube 検索結果で最も視聴回数を増やした検索キーワードを 10 個取得します。結果は視聴回数の降順で並べ替えられます。API Explorer でこのクエリを実行するには、filters パラメータ値の文字列 VIDEO_ID を、アップロードした動画の動画 ID をカンマ区切りで最大 500 個指定したリストに置き換える必要があります。
dimensions=insightTrafficSourceDetail
metrics=views
filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH
maxResults=10
sort=-viewsトップ 10 – 動画のトラフィックが最も多い外部ウェブサイト
このクエリは、特定の動画または動画のグループの Google 検索結果で最も視聴回数を獲得した外部ウェブサイトを 10 件取得します。結果は推定再生時間の降順に並べ替えられます。API Explorer でこのクエリを実行するには、filters パラメータ値の文字列 VIDEO_ID を、アップロードした動画の動画 ID をカンマ区切りで最大 500 個指定したリストに置き換える必要があります。
dimensions=insightTrafficSourceDetail
metrics=estimatedMinutesWatched,views
filters=video==VIDEO_ID;insightTrafficSourceType==EXT_URL
maxResults=25
sort=-estimatedMinutesWatched再生リストレポート
ある国におけるさまざまなトラフィック ソースの再生リストの視聴回数と総再生時間
このリクエストは、指定した国での再生リストの視聴回数、再生リストの開始回数、再生リストの推定再生時間を取得します。指標はトラフィック ソース別に集計されます。トラフィック ソースは、ユーザーが再生リストにアクセスした方法を表します。
dimensions=insightTrafficSourceType
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched
filters=country==USトラフィック ソース別の再生リストの視聴回数と総再生時間
このリクエストは、コンテンツ所有者の 1 つ以上のチャンネルの再生リストの再生回数、再生リストの開始回数、再生リストの推定再生時間を取得します。指標はトラフィック ソースごとに集計されます。API Explorer でこのクエリを実行するには、filters パラメータ値の文字列 CHANNEL_ID を、チャンネルのチャンネル ID をカンマ区切りで最大 500 個指定したリストに置き換える必要があります。
dimensions=day,insightTrafficSourceType
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched
filters=channel==CHANNEL_ID動画レポート
申し立てが行われた動画の端末のタイプに関する日別の指標
このクエリは、特定のコンテンツ所有者が申し立てた動画の日別の再生回数とデバイスタイプ別の推定再生時間を取得します。結果は、動画が再生された端末のタイプごとに日別でグループ化されます。結果は時系列で並べ替えられます。
dimensions=day,deviceType
metrics=estimatedMinutesWatched,views
filters=claimedStatus==claimed
sort=day申し立てが行われた動画が携帯端末で再生されたときのオペレーティング システムに関する日別の指標
このクエリは、指定したコンテンツ所有者が申し立てた動画のモバイル デバイスでの視聴回数について、日別の視聴回数とオペレーティング システム別の推定総再生時間を取得します。結果は、動画が再生されたオペレーティング システムごとに日別でグループ化されます。結果は時系列で並べ替えられます。
dimensions=day,operatingSystem
metrics=estimatedMinutesWatched,views
filters=claimedStatus==claimed;deviceType==MOBILE
sort=dayオペレーティング システムと端末のタイプに関する日別の指標
このクエリは、特定のコンテンツ所有者によって申し立てが行われた動画の日別の再生回数と推定再生時間を取得します。統計結果はオペレーティング システムと端末のタイプによってグループ化されます。結果は時系列で並べ替えられます。
dimensions=day,operatingSystem,deviceType
metrics=estimatedMinutesWatched,views
sort=day再生リストレポート
Android オペレーティング システムでの再生リストの視聴回数に関するデバイスの種類の指標
このクエリは、コンテンツ所有者の 1 つ以上のチャンネルの再生リストについて、Android デバイスでの再生リストの再生回数と再生リストの推定再生時間を取得します。再生リストの視聴が発生したデバイスの種類ごとに結果が返されます。API Explorer でこのクエリを実行するには、filters パラメータ値の文字列 CHANNEL_ID を、チャンネルのチャンネル ID をカンマ区切りで最大 500 個指定したリストに置き換える必要があります。
dimensions=deviceType
metrics=playlistViews,playlistEstimatedMinutesWatched
filters=channel==CHANNEL_ID;operatingSystem==ANDROIDモバイル デバイスでの再生リストの表示に関するオペレーティング システムの指標
このクエリは、コンテンツ所有者のいずれかのチャンネルの再生リストの再生回数と、モバイル デバイスでの再生リストの推定再生時間を取得します。再生リストの視聴が発生したオペレーティング システムごとに結果が返されます。
dimensions=operatingSystem
metrics=views,estimatedMinutesWatched
filters=deviceType==MOBILE動画レポート
カリフォルニアの視聴者のユーザー属性（年齢層と性別）
このレポートでは、コンテンツ所有者の申し立てを受けたコンテンツを視聴したカリフォルニア州の視聴者の年齢層と性別に関する統計情報を取得できます。結果は、性別、年齢層の順に並べ替えられます。このクエリは、filters パラメータの値を調整することで、世界中のすべての視聴者、または国、大陸、亜大陸、米国の他の州のすべての視聴者について同じ統計情報を取得するように変更できます。
dimensions=ageGroup,gender
metrics=viewerPercentage
filters=claimedStatus==claimed;province==US-CA
sort=gender,ageGroup共有に関する指標（動画が共有されているサービス別に集計）
このリクエストは、ユーザーが Share ボタンを使用してコンテンツ所有者がアップロードした動画を共有した回数を取得します。結果は共有サービス別（Google+、Twitter など）に集計され、共有回数の降順に並べ替えられます。
dimensions=sharingService
metrics=shares
filters=uploaderType==self
sort=-shares動画の視聴者維持率の指標
このレポートでは、動画が視聴者の注目をどの程度維持できたかを確認できます。レポートを取得できるのは、一度に 1 つの動画に対してのみです。API Explorer でこのクエリを実行するには、filters パラメータ値の文字列 VIDEO_ID を、アップロードした動画の動画 ID に置き換える必要があります。なお、オーディエンス維持率レポートでは、video フィルタに複数の値を指定することはできません。
この例では、レポートで audienceType フィルタを使用してレスポンスが制限され、動画の検索や関連動画のクリックなど、ユーザーが直接行った操作の結果であるオーガニック視聴のデータのみが含まれます。そのため、TrueView インストリーム広告や TrueView インディスプレイ広告の視聴回数に関するデータはレポートに含まれません。フィルタを削除すると、すべての視聴者タイプから動画の視聴者維持率データを取得できます。
audienceType フィルタのデータは 2013 年 9 月 25 日以降ご利用いただけます。API は、フィルタを使用して以前の日付のデータを取得しようとするクエリのデータは返しません。このフィルタを使用しないクエリは、2008 年 7 月 1 日以降の日付に対して機能します。
dimensions=elapsedVideoTimeRatio
metrics=audienceWatchRatio,relativeRetentionPerformance
filters=video==VIDEO_ID;audienceType==ORGANIC申し立てが行われたコンテンツの収益と広告のパフォーマンスの指標
このリクエストは、コンテンツ所有者が申し立てたコンテンツの収益と広告パフォーマンスの指標を取得します。レポートは 1 行のデータを返します。この行には、リクエストした各指標の指定した期間における合計が含まれます。
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed日別収益と広告パフォーマンスの指標
このリクエストは、コンテンツ所有者が申し立てたコンテンツの日別の収益と広告パフォーマンスの指標を取得します。
dimensions=day
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed国別の収益と広告のパフォーマンスに関する指標
このリクエストは、コンテンツ所有者が申し立てたコンテンツの国別の収益と広告パフォーマンスの指標を取得します。結果は収益額の降順で並べ替えられます。つまり、最初に表示される国は、パートナーの推定収益が最も高い国です。
dimensions=country
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed
sort=-estimatedRevenueトップ 10 - 収益額が最も高い動画
このリクエストは、コンテンツ所有者が申し立てを行った動画のうち、収益が最も高い 10 本の動画の収益と広告のパフォーマンスの指標を取得します。結果は収益額の降順で並べ替えられます。つまり、最初の動画は推定収益が最も高い動画になります。
dimensions=video
metrics=views,estimatedRevenue,estimatedAdRevenue,estimatedRedPartnerRevenue,grossRevenue,adImpressions,cpm,playbackBasedCpm,monetizedPlaybacks
filters=claimedStatus==claimed
maxResults=10
sort=-estimatedRevenue広告タイプ別の広告の掲載結果の指標
このリクエストは、コンテンツ所有者によって申し立てが行われたコンテンツの広告の掲載結果に関する指標を取得します。結果は広告タイプ別にグループ化されるため、広告タイプ間で収益と CPM の値を比較できます。
dimensions=adType
metrics=grossRevenue,adImpressions,cpm
filters=claimedStatus==claimed
sort=-adType