サンプルの API リクエスト

このページでは、YouTube Analytics API のリクエスト例を示します。それぞれの例では、取得するレポートについて簡単に説明し、対応する dimensionsmetricsfilterssort のパラメータ値を示しています。(チャンネル レポートコンテンツ所有者レポートのドキュメントでは、API でサポートされているレポートを確認できます)。

各例は Google API Explorer にリンクし、表示された値を入力します。この例では、デフォルトの開始日と終了日(YYYY-MM-DD)に 2022-01-012022-06-30 を使用しています。

API Explorer にリンクした後も、レポートを取得するチャンネルまたはコンテンツ所有者を指定する必要があります。API Explorer は、クリックしたクエリに応じて、ids パラメータ値に channel==MINE または contentOwner==CONTENT_OWNER_ID を入力します。チャネル レポートでは、MINE を認証済みユーザーのチャネル ID に変更できます。コンテンツ所有者レポートの場合は、CONTENT_OWNER_ID をコンテンツ所有者 ID に置き換える必要があります。

また、指定したチャンネルまたはコンテンツ所有者として認証され、API Explorer が OAuth 2.0 を使用して API リクエストを承認できるようにします。

  1. 複数のディメンションや指標によるリクエストの並べ替え
  2. チャネル レポート
  3. コンテンツ所有者レポート

複数のディメンション/指標によるリクエストの並べ替え

API は、複数のディメンションや指標を使用してレスポンス データを並べ替える機能をサポートしています。たとえば、以下のリクエストは、特定のチャンネルの動画の毎日のトラフィック ソース データを取得します。結果セットの各行には、特定の日付の特定のタイプのトラフィック ソース(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

再生リストレポート

チャンネルの再生リストの合計視聴回数

このリクエストによって、認証済みユーザーのチャンネル内の再生リストの合計開始時間、推定再生時間(分)、再生リスト開始あたりの視聴回数が表示されます。views 指標は、再生リスト内で発生した動画再生回数のみをカウントします。

metrics=views,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart
filters==isCurated=1

特定の再生リストの統計情報

このリクエストによって、特定の再生リストの合計開始数、推定再生時間(分)、再生リスト開始あたりの視聴回数が表示されます。views 指標は、再生リスト内で発生した動画再生回数のみをカウントします。API Explorer でこのクエリを実行するには、filters パラメータ値の文字列 PLAYLIST_ID を、認証済みユーザーのチャンネルの再生リストの再生リスト ID に置き換える必要があります。

metrics=views,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart
filters==isCurated=1;playlist==PLAYLIST_ID

複数の再生リストの統計情報をまとめて取得するには、PLAYLIST_ID という文字列を、認証済みユーザーのチャンネルの再生リストにおける再生リスト ID のカンマ区切りリスト(最大 500 件)に置き換えます。

トップ 10 – チャンネルの視聴回数が最も多い再生リスト

このクエリは、チャンネルの視聴回数が特に多い上位 10 件の再生リストを取得します。これは、指定した期間内の推定再生時間(分)で測定したものです。また、視聴者が各再生リストの再生を開始した回数や、再生リストの再生後に再生リスト内の動画を視聴した平均時間など、その他の再生リストの指標も取得します。結果は推定再生時間の降順に並べ替えられます。

注: このレポートでは playlist ディメンションを使用しているため、sort リクエスト パラメータの値を指定し、maxResults パラメータに 10 以下の整数値を設定する必要があります。

dimensions=playlist
metrics=estimatedMinutesWatched,views,playlistStarts,averageTimeInPlaylist
filters=isCurated==1
maxResults=10
sort=-estimatedMinutesWatched
時間ベース

動画レポート

チャンネルの動画の日別再生時間の指標

このクエリは、チャンネルの動画の 1 日の視聴回数、総再生時間の指標、新しいチャンネル登録者数を取得します。レポートは、リクエストした期間内の日付ごとに 1 行のデータを返します。各行は時系列で並べ替えられます。

dimensions=day
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained
sort=day

チャンネルの動画のアノテーションに関する日別の指標

このリクエストによって、チャンネルのコンテンツの 1 日の視聴回数、アノテーションのクリック率、アノテーションのクリック率、アノテーションのインプレッション数を取得できます。結果は時系列で並べ替えられます。

dimensions=day
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
sort=day

再生リストレポート

チャンネルの 1 日の再生リスト視聴回数

このリクエストによって、認証済みユーザーのチャンネルの 1 日の視聴回数、再生リストの開始時間、推定再生時間(分単位)、再生リストの開始あたりの視聴回数が取得されます。結果は時系列で並べ替えられます。

dimensions=day
metrics=views,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart
filters==isCurated=1
sort=day
地域

動画レポート

チャンネルの動画の国別再生時間の指標

このクエリは、チャンネルの動画の国別の視聴回数、総再生時間の指標、チャンネル登録者数を計算します。レポートは、チャンネルの動画が再生された国ごとに 1 行のデータを返します。各行は再生時間(分)で降順に並べ替えられます。

dimensions=country
metrics=views,estimatedMinutesWatched,averageViewDuration,averageViewPercentage,subscribersGained
sort=-estimatedMinutesWatched

チャンネルの動画のアノテーションに関する国別の指標

このリクエストによって、チャンネルの動画の国別の視聴回数、アノテーションのクリック率、アノテーションのクリック率、アノテーションのインプレッション数が取得されます。結果はアノテーションのクリック率の降順に並べ替えられます。つまり、アノテーションのクリック率が高い国の方がリストの最初に表示されます。

dimensions=country
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
sort=-annotationClickThroughRate

米国各州とワシントン D.C. の州固有の指標

このリクエストでは、チャンネルの動画の視聴回数、推定再生時間(分)、平均視聴時間を州ごとの内訳で取得できます。米国とワシントン 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 フィルタと有効な値の 1 つを使用して、西ヨーロッパや東南アジアなどの亜大陸のデータを取得するようにクエリを修正することもできます。他のフィルタもサポートされています。結果は視聴回数の降順で並べ替えられます。

    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 フィルタと有効な値の 1 つを使用して、西ヨーロッパや東南アジアなどの亜大陸のデータを取得するようにクエリを修正することもできます。結果は視聴回数の降順で並べ替えられます。

注: このレポートでは、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
filters=isCurated==1
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 日あたりの視聴回数と総再生時間

このクエリは、特定のチャンネルの動画について、米国での 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
filters=isCurated==1
sort=-playlistStarts

1 日の再生リストの視聴回数と、さまざまな再生場所からの総再生時間

このクエリは、特定のチャンネルの再生リストの米国ごとの再生リストの開始時間、視聴回数、推定総再生時間を取得します。結果は、再生リストの視聴回数が発生したページの種類やアプリケーションごとに、日単位でグループ化されます。結果は時系列で並べ替えられます。

dimensions=day,insightPlaybackLocationType
metrics=playlistStarts,views,estimatedMinutesWatched
filters=isCurated==1;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 のカンマ区切りのリストに置き換える必要があることに注意してください。

たとえば、1 つの動画に関するクエリを実行したり、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,playlistStarts,estimatedMinutesWatched
filters=isCurated==1;country==US

さまざまなトラフィック ソースの 1 日の再生リスト視聴回数と総再生時間

このリクエストによって、チャンネルの 1 日の再生リストの視聴回数、再生リストの開始時間、再生リストの総再生時間の推定値が取得されます。各指標は日別およびトラフィック ソース別に集計され、時系列で並べ替えられます。

dimensions=day,insightTrafficSourceType
metrics=views,playlistStarts,estimatedMinutesWatched
filters=isCurated==1
sort=day
デバイス/OS

動画レポート

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

オペレーティング システムと端末のタイプに関する日別の指標

このクエリは、チャンネルの 1 日の視聴回数と推定総再生時間を取得します。統計結果はオペレーティング システムと端末のタイプによってグループ化されます。結果は時系列で並べ替えられます。

dimensions=day,operatingSystem,deviceType
metrics=estimatedMinutesWatched,views
sort=day

再生リストレポート

Android オペレーティング システムにおけるプレイリストの視聴回数のデバイスタイプに関する日別の指標

このクエリは、Android デバイスで特定のチャンネルの再生リストの 1 日の再生リスト視聴回数と推定総再生時間を取得します。結果は、再生リストの視聴回数が発生したデバイスの種類ごとに、日ごとにグループ化されます。結果は時系列で並べ替えられます。

dimensions=day,deviceType
metrics=views,estimatedMinutesWatched
filters=isCurated==1;operatingSystem==ANDROID
sort=day

モバイル デバイスでの再生リストの視聴回数に関する 1 日単位のオペレーティング システム指標

このクエリは、モバイル デバイスでの特定のチャンネルの再生リストの 1 日の再生リスト視聴回数と推定総再生時間を取得します。再生リストの視聴が行われたオペレーティング システムごとに結果がグループ化されます。結果は時系列で並べ替えられます。

dimensions=day,operatingSystem
metrics=views,estimatedMinutesWatched
filters=isCurated==1;deviceType==MOBILE
sort=day
ユーザー属性

動画レポート

カリフォルニア州の視聴者層(年齢層と性別)

このレポートでは、カリフォルニアのチャンネルの動画を視聴したユーザーの年齢層と性別に関する統計情報を取得できます。検索結果は、性別、次に年齢層で並べ替えられています。filters パラメータ値を調整することで、このクエリを変更して、全世界の視聴者、あるいは国、大陸、亜大陸、他の米国のすべての視聴者について同じ統計情報を取得することができます。

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=province==US-CA
sort=gender,ageGroup

再生リストレポート

カリフォルニア州の再生リストの視聴者層(年齢層と性別)

このレポートでは、カリフォルニア州のチャンネルの再生リストを視聴した視聴者の年齢層と性別に関する統計情報を取得できます。検索結果は、性別、次に年齢層で並べ替えられています。filters パラメータ値を調整することで、このクエリを変更して、全世界の視聴者、あるいは国、大陸、亜大陸、他の米国のすべての視聴者について同じ統計情報を取得することができます。

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=isCurated==1;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

1 日の収益と広告の掲載結果に関する指標

このリクエストによって、チャンネルの 1 日の収益と広告のパフォーマンスに関する指標が取得されます。

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 を、チャンネルの最大 500 個のチャンネル ID のカンマ区切りリストに置き換える必要があります。

dimensions=video
metrics=views
filters=channel==CHANNEL_ID
maxResults=10
sort=-views

トップ 10 – チャンネル内で再生回数の多い動画に対するアノテーションのクリック率

このリクエストによって、指定したチャンネルまたはチャンネル グループで最も視聴された動画 10 件の視聴回数、アノテーションのクリック率、アノテーションの成約率、アノテーションのインプレッション数が取得されます。結果は視聴回数の降順で並べ替えられます。つまり、最も視聴回数の多い動画が最初に表示されます。API Explorer でこのクエリを実行するには、filters パラメータ値の文字列 CHANNEL_ID を、チャンネルの最大 500 個のチャンネル ID のカンマ区切りリストに置き換える必要があります。

dimensions=video
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=channel==CHANNEL_ID
maxResults=10
sort=-views

再生リストレポート

コンテンツ所有者のチャンネルの再生リストの視聴回数

このリクエストによって、コンテンツ所有者のチャンネルの再生リストの合計開始再生回数、推定再生時間(分)、再生リスト開始あたりの視聴回数が表示されます。views 指標は、再生リスト内で発生した動画再生回数のみをカウントします。

metrics=views,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart
filters==isCurated=1

特定のチャンネルの再生リストの視聴回数

このリクエストによって、コンテンツ所有者のチャンネルの再生リストの合計開始再生回数、推定再生時間(分)、再生リスト開始あたりの視聴回数が表示されます。views 指標は、再生リスト内で発生した動画再生回数のみをカウントします。API Explorer でこのクエリを実行するには、filters パラメータ値の文字列 CHANNEL_ID を、チャンネルの最大 500 個のチャンネル ID のカンマ区切りリストに置き換える必要があります。

metrics=views,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart
filters==isCurated=1;channel==CHANNEL_ID

再生リストの統計情報

このリクエストによって、特定の再生リストの合計開始数、推定再生時間(分)、再生リスト開始あたりの視聴回数が表示されます。views 指標は、再生リスト内で発生した動画再生回数のみをカウントします。API Explorer でこのクエリを実行するには、filters パラメータ値の文字列 PLAYLIST_ID を、コンテンツ所有者のチャンネルの 1 つの再生リストの再生リスト ID に置き換える必要があります。

metrics=views,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart
filters==isCurated=1;playlist==PLAYLIST_ID

複数の再生リストの統計情報をまとめて取得するには、PLAYLIST_ID という文字列を、コンテンツ所有者のチャンネルの再生リスト ID をカンマ区切りで 500 件まで置き換えます。

トップ 10 – コンテンツ所有者の視聴回数が最も多い再生リスト

このクエリは、コンテンツ所有者の最も視聴されている 10 件の再生リストを取得します。これは、指定した期間の推定再生時間(分)で測定します。また、視聴者が各再生リストの再生を開始した回数や、再生リストの再生後に再生リスト内の動画を視聴した平均時間など、その他の再生リストの指標も取得します。結果は推定再生時間の降順に並べ替えられます。

注:このレポートでは playlist ディメンションを使用しているため、sort リクエスト パラメータの値を指定し、maxResults パラメータに 10 以下の整数値を設定する必要があります。

dimensions=playlist
metrics=estimatedMinutesWatched,views,playlistStarts,averageTimeInPlaylist
filters=isCurated==1
maxResults=10
sort=-estimatedMinutesWatched
時間ベース

動画レポート

自身がアップロードしたコンテンツの日別再生時間の指標

このクエリは、コンテンツ所有者がアップロードした動画の、1 日あたりの総再生時間の指標、視聴回数、収益化対象の再生回数、インプレッションの数を取得します。レポートは、期間内の日付ごとに 1 行のデータとして返されます。各行は時系列で並べ替えられます。

dimensions=day
metrics=estimatedMinutesWatched,averageViewPercentage,views,monetizedPlaybacks,adImpressions
filters=uploaderType==self
sort=day

申し立てが行われたコンテンツのアノテーションに関する指標

このリクエストによって、コンテンツ所有者が申し立てを行ったコンテンツの 1 日の視聴回数、アノテーションのクリック率、アノテーションの成約率、アノテーションのインプレッション数を取得できます。結果は時系列で並べ替えられます。

dimensions=day
metrics=views,likes,annotationClickThroughRate,annotationCloseRate,annotationImpressions
filters=claimedStatus==claimed
sort=day

再生リストレポート

コンテンツ所有者の 1 日の再生リスト視聴回数

このリクエストによって、コンテンツ所有者のチャンネルのすべての再生リストについて、1 日の視聴回数、再生リストの開始回数、推定再生時間(分単位)の取得数が取得されます。結果は時系列で並べ替えられます。

dimensions=day
metrics=views,playlistStarts,estimatedMinutesWatched,viewsPerPlaylistStart
filters==isCurated=1
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

米国各州とワシントン D.C. の州固有の指標

このリクエストでは、コンテンツ所有者が申し立てを行った動画について、視聴回数、推定再生時間(分)、平均視聴時間を州ごとの内訳で取得できます。米国とワシントン D.C. のデータは、米国の州ごとの ISO 3166-2 コードによるアルファベット順に並べ替えられています。

dimensions=province
metrics=views,estimatedMinutesWatched,averageViewDuration
filters=claimedStatus==claimed;country==US
sort=province

合計閲覧数の上位 10 の米国都市

このクエリでは、指定した期間にコンテンツ所有者が申し立てを行った動画のうち、最も多く視聴された米国の 10 都市が表示されます。このクエリに別の有効な値を選択して、別ののデータをリクエストするように変更できます。同様に、subContinent フィルタと有効な値の 1 つを使用して、西ヨーロッパや東南アジアなどの亜大陸のデータを取得するようにクエリを修正することもできます。他のフィルタもサポートされています。結果は視聴回数の降順で並べ替えられます。

    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 日間のリストを取得します。これは、コンテンツ所有者が申し立てを行ったコンテンツについて、1 日の合計総再生時間が米国内の市で占める最大期間である場合です。クエリ結果では、合計総再生時間、総再生時間が発生した日付、コンテンツが視聴されたと推定される都市を確認できます。結果は合計総再生時間の降順で並べ替えられます。

    dimensions=city,day
metrics=estimatedWatchTime
filters=claimedStatus==claimed;country==US
maxResults=10
sort=-estimatedWatchTime

トップ 10 – ヨーロッパで最も視聴された動画

このクエリは、コンテンツ所有者が申し立てを行った動画のうち、指定された期間内の視聴回数で測定された、ヨーロッパで最も視聴された 10 本の動画を取得します。このクエリは、別の大陸のデータを、そのフィルタに別の有効な値を選択してリクエストするように変更できます。同様に、subContinent フィルタと有効な値の 1 つを使用して、西ヨーロッパや東南アジアなどの亜大陸のデータを取得するようにクエリを修正することもできます。結果は視聴回数の降順で並べ替えられます。

dimensions=video
metrics=views,estimatedMinutesWatched,likes,subscribersGained
filters=claimedStatus==claimed;filters=continent==150
maxResults=10
sort=-estimatedMinutesWatched

再生リストレポート

コンテンツ所有者の再生リストに関する国別の総再生時間の指標

このクエリは、コンテンツ所有者のチャンネルのすべての再生リストについて、国別の視聴回数と総再生時間の指標を取得します。再生リストが視聴された国ごとに 1 行のデータが返されます。各行は再生時間(分)で降順に並べ替えられます。

dimensions=country
metrics=views,estimatedMinutesWatched,playlistStarts,averageTimeInPlaylist
filters=isCurated==1
sort=-estimatedMinutesWatched

トップ 10 – 米国で最も人気のあるプレイリスト

このクエリでは、指定した期間に米国の視聴者が最も頻繁に再生を開始した、コンテンツ所有者のチャンネルから 10 件の再生リストを取得します。結果はプレイリストの開始回数の降順で並べ替えられます。

注: このレポートでは playlist ディメンションを使用しているため、sort リクエスト パラメータの値を指定し、maxResults パラメータに 10 以下の整数値を設定する必要があります。

dimensions=playlist
metrics=playlistStarts,views,estimatedMinutesWatched,averageViewDuration
filters=isCurated==1;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 日あたりの視聴回数と総再生時間

このクエリは、特定のチャンネルまたはチャンネルのグループにアップロードされた動画について、米国での 1 日の視聴回数と推定総再生時間を取得します。結果は、動画が再生されたページまたはアプリケーションの種類ごとに、日別でグループ化されます。結果は新しい順に並べ替えられます。API Explorer でこのクエリを実行するには、filters パラメータ値の文字列 CHANNEL_ID を、チャンネルの最大 500 個のチャンネル ID のカンマ区切りリストに置き換える必要があります。

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=views,estimatedMinutesWatched,playlistStarts
filters=isCurated==1
sort=-playlistStarts

1 日の再生リストの視聴回数と、さまざまな再生場所からの総再生時間

このクエリは、コンテンツ所有者のチャンネルのすべての再生リストについて、米国での再生リストの 1 日の開始数、視聴回数、推定総再生時間を取得します。結果は、再生リストの視聴回数が発生したページの種類やアプリケーションごとに、日単位でグループ化されます。結果は時系列で並べ替えられます。

dimensions=day,insightPlaybackLocationType
metrics=playlistStarts,views,estimatedMinutesWatched
filters=isCurated==1;country==US
sort=day
トラフィック ソース

動画レポート

トラフィック ソース別の再生回数および再生時間

このリクエストは、コンテンツ所有者の動画の再生回数と推定再生時間を取得します。各指標はトラフィック ソース別に集計されます。トラフィック ソースとは、ユーザーが動画にアクセスした方法です。

dimensions=insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=uploaderType==self

1 日の視聴回数と、さまざまなトラフィック ソースからの総再生時間

このリクエストによって、コンテンツ所有者の動画の 1 日の視聴回数と 1 日あたりの推定再生時間が取得されます。指標は日別およびトラフィック ソース別に集計され、新しい順に並べ替えられます。

dimensions=day,insightTrafficSourceType
metrics=views,estimatedMinutesWatched
filters=uploaderType==self
sort=-day

注: 次の 2 つのサンプル レポートは、特定のトラフィック ソースでのみサポートされています。たとえば、NO_LINK_EMBEDDED トラフィック ソースには追加の詳細情報がないため、これらのソースでこれらのレポートを使用することはできません。これらのタイプのレポートを利用できるトラフィック ソースについて詳しくは、insightTrafficSourceType の定義をご覧ください。

トップ 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=views,playlistStarts,estimatedMinutesWatched
filters=isCurated==1;country==US

さまざまなトラフィック ソースの 1 日の再生リスト視聴回数と総再生時間

このリクエストによって、1 つ以上のコンテンツ所有者のチャンネルで、再生リストの 1 日の再生リスト視聴回数、再生リストの開始時間、再生リストの推定総再生時間が取得されます。指標はトラフィック ソースごとに毎日集計され、時系列で並べ替えられます。API Explorer でこのクエリを実行するには、filters パラメータ値の文字列 CHANNEL_ID を、チャンネルの最大 500 個のチャンネル ID のカンマ区切りリストに置き換える必要があります。

dimensions=day,insightTrafficSourceType
metrics=views,playlistStarts,estimatedMinutesWatched
filters=isCurated==1;channel==CHANNEL_ID
sort=day
デバイス/OS

動画レポート

申し立てが行われた動画の端末のタイプに関する日別の指標

このクエリは、特定のコンテンツ所有者が申し立てた動画について、デバイスの種類ごとに 1 日の視聴回数と推定総再生時間を取得します。結果は、動画が再生された端末のタイプごとに日別でグループ化されます。結果は時系列で並べ替えられます。

dimensions=day,deviceType
metrics=estimatedMinutesWatched,views
filters=claimedStatus==claimed
sort=day

申し立てが行われた動画が携帯端末で再生されたときのオペレーティング システムに関する日別の指標

このクエリでは、指定したコンテンツ所有者によって申し立てが行われた動画がモバイル デバイスで視聴された回数について、オペレーティング システムによって 1 日の視聴回数と推定総再生時間を取得します。結果は、動画が再生されたオペレーティング システムごとに日別でグループ化されます。結果は時系列で並べ替えられます。

dimensions=day,operatingSystem
metrics=estimatedMinutesWatched,views
filters=claimedStatus==claimed;deviceType==MOBILE
sort=day

オペレーティング システムと端末のタイプに関する日別の指標

このクエリは、特定のコンテンツ所有者が申し立てた動画の 1 日の視聴回数と推定総再生時間を取得します。統計結果はオペレーティング システムと端末のタイプによってグループ化されます。結果は時系列で並べ替えられます。

dimensions=day,operatingSystem,deviceType
metrics=estimatedMinutesWatched,views
sort=day

再生リストレポート

Android オペレーティング システムにおけるプレイリストの視聴回数のデバイスタイプに関する日別の指標

このクエリは、Android デバイス上で 1 つまたは複数のコンテンツ所有者のチャンネルの再生リストの 1 日の再生リスト視聴回数と推定総再生時間を取得します。結果は、再生リストの視聴回数が発生したデバイスの種類ごとに、日ごとにグループ化されます。結果は時系列で並べ替えられます。API Explorer でこのクエリを実行するには、filters パラメータ値の文字列 CHANNEL_ID を、チャンネルの最大 500 個のチャンネル ID のカンマ区切りリストに置き換える必要があります。

dimensions=day,deviceType
metrics=views,estimatedMinutesWatched
filters=isCurated==1;channel==CHANNEL_ID;operatingSystem==ANDROID
sort=day

モバイル デバイスでの再生リストの視聴回数に関する 1 日単位のオペレーティング システム指標

このクエリは、コンテンツ所有者のチャンネル内の再生リストにおける、モバイル デバイスでの再生リストの 1 日の視聴回数と推定総再生時間を取得します。再生リストの視聴が行われたオペレーティング システムごとに結果がグループ化されます。結果は時系列で並べ替えられます。

dimensions=day,operatingSystem
metrics=views,estimatedMinutesWatched
filters=isCurated==1;deviceType==MOBILE
sort=day
ユーザー属性

動画レポート

カリフォルニア州の視聴者層(年齢層と性別)

このレポートでは、コンテンツ所有者が申し立てを行ったコンテンツを視聴したカリフォルニア州の視聴者の年齢層と性別に関するデータを取得できます。検索結果は、性別、次に年齢層で並べ替えられています。filters パラメータ値を調整することで、このクエリを変更して、全世界の視聴者、あるいは国、大陸、亜大陸、他の米国のすべての視聴者について同じ統計情報を取得することができます。

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=claimedStatus==claimed;province==US-CA
sort=gender,ageGroup

再生リストレポート

カリフォルニア州の再生リストの視聴者層(年齢層と性別)

カリフォルニア州の視聴者のうち、コンテンツ所有者のチャンネルで再生リストを視聴した視聴者の年齢層と性別に関する統計情報を取得します。検索結果は、性別、次に年齢層で並べ替えられています。filters パラメータ値を調整することで、このクエリを変更して、全世界の視聴者、あるいは国、大陸、亜大陸、他の米国のすべての視聴者について同じ統計情報を取得することができます。

dimensions=ageGroup,gender
metrics=viewerPercentage
filters=isCurated==1;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

1 日の収益と広告の掲載結果に関する指標

このリクエストでは、コンテンツ所有者が申し立てを行ったコンテンツの 1 日の収益と広告のパフォーマンス指標を取得します。

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