このページでは、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 では、複数のディメンションや指標を使用してレスポンス データを並べ替える機能がサポートされています。たとえば、次のリクエストでは、特定のチャンネルの動画について毎日のトラフィック ソース データを取得します。結果セットの各行には、特定の日における特定の種類のトラフィック ソース（例: 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
再生リストレポート
チャンネルの再生リストの合計視聴回数
このリクエストは、再生リストの合計開始回数、推定再生時間（分）、視聴回数（ 動画の集計指標） 再生リストの視聴回数（再生リスト内の指標） 認証されたユーザーのチャンネル内の再生リストにおける、再生リスト 1 回あたりの視聴回数
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart
特定の再生リストの統計情報
このリクエストは、再生リストの合計開始回数、推定再生時間（分）、視聴回数（
動画の集計指標）
再生リストの視聴回数（再生リスト内の指標）
特定の再生リストについて、再生リスト 1 回あたりの視聴回数、API でこのクエリを実行するには、
filters の文字列 PLAYLIST_ID を置き換える必要があります。
パラメータ値を、認証されたユーザーのチャンネルにある再生リストの再生リスト ID に置き換えます。
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart filters=playlist==PLAYLIST_ID
複数の再生リストの集計統計情報を取得するには、文字列 PLAYLIST_ID を、認証されたユーザーのチャンネルにある再生リストの再生リスト ID（最大 500 個）のカンマ区切りのリストに置き換えることもできます。
トップ 10 – チャンネルで特に視聴された再生リスト
このクエリは、チャンネルで特に視聴されている上位 10 件の再生リストを取得します。再生リストの視聴回数で測定されます。 過去 30 日間の CPA または ROAS のまた、その他のいくつかの再生リスト指標も取得します。 たとえば、視聴者が各再生リストの再生を開始した回数や、 視聴者が再生リストの開始後に動画を視聴した時間。結果: 再生リストの視聴回数の降順で並べ替えられています。
注: このレポートでは playlist ディメンションを使用しているため、sort リクエスト パラメータの値を指定するとともに、maxResults パラメータを 10 以下の整数値に設定する必要があります。
dimensions=playlist metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts,averageTimeInPlaylist,playlistSaves maxResults=10 sort=-playlistViews
動画レポート
チャンネルの動画の日別再生時間の指標
このクエリは、チャンネルの動画の 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,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
米国の州とワシントン 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 フィルタとその有効な値のいずれかを使用して、西ヨーロッパや東南アジアなどの亜大陸のデータを取得するようにクエリを変更できます。他のフィルタもサポートされています。結果は表示回数の降順で並べ替えられます。
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 日の視聴回数と総再生時間
このクエリは、特定のチャンネルの動画について、米国における 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
各再生場所からの再生リストの視聴回数と総再生時間（日別）
このクエリは、プレイリストの開始回数、視聴回数（ 動画の集計指標） 再生リストの視聴回数（再生リスト内の指標） および特定チャンネルの再生リストの米国での推定総再生時間です。結果 再生リストの視聴が発生したページまたはアプリケーションのタイプごとに、日別にグループ化されています。結果 時系列で表示されます。
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 を、アップロードした動画の最大 500 個の動画 ID のカンマ区切りリストに置き換える必要があります。
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
各トラフィック ソースの再生リストの視聴回数と総再生時間（日別）
このリクエストは、チャンネルの 1 日の再生リスト視聴回数（ in-playlist 指標） 再生リストの開始数、推定再生時間 などがありますまた、合計視聴回数（ 集計動画指標）。 各指標は日別およびトラフィック ソース別に集計され、時系列で並べ替えられます。
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
オペレーティング システムと端末のタイプに関する日別の指標
このクエリは、チャンネルの 1 日あたりの視聴回数と推定総再生時間を取得します。統計結果はオペレーティング システムと端末のタイプによってグループ化されます。結果は時系列で並べ替えられます。
dimensions=day,operatingSystem,deviceType metrics=estimatedMinutesWatched,views sort=day
再生リストレポート
Android オペレーティング システムにおける再生リストの視聴回数のデバイスタイプに関する日別の指標
このクエリは、日次ビュー（ 動画の集計指標） 再生リストの視聴回数（再生リスト内の指標） 特定のチャンネルの再生リストについて、Android デバイスでの総再生時間と推定再生時間。結果: 再生リストの視聴が発生したデバイスの種類ごとに日別にグループ化されています。結果は時系列で並べ替えられます。
dimensions=day,deviceType metrics=views,estimatedMinutesWatched,playlistViews filters=operatingSystem==ANDROID sort=day
モバイル デバイスでの再生リストの視聴回数に関するオペレーティング システムに関する日別の指標
このクエリは、日次ビュー（ 動画の集計指標） 再生リストの視聴回数（再生リスト内の指標） モバイル デバイスでの特定チャンネルの再生リストの推定総再生時間です。結果: 再生リストの視聴が発生したオペレーティング システムごとに日別にグループ化されています。結果は時系列で並べ替えられます。
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 を、チャネルの最大 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
再生リストレポート
コンテンツ所有者のチャンネルの再生リストの視聴回数
このリクエストは、再生リストの合計開始回数、再生リストの推定再生時間（分）、再生リストを取得します。
コンテンツ所有者のチャンネルの再生リストの視聴回数、再生リストごとの視聴回数などです。「
playlistViews 指標は、動画内で発生した視聴回数のみがカウントされます。
おすすめします。リクエストされた指標はすべて再生リスト内の指標であるため、このリクエストでは
再生リストまたはグループ フィルタも含める必要があります。
metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched,viewsPerPlaylistStart
特定の再生リストの統計情報
このリクエストは、再生リストの合計開始回数、推定再生時間（分）、視聴回数（
動画の集計指標）
再生リストの視聴回数（再生リスト内の指標）
特定の再生リストについて、再生リスト 1 回あたりの視聴回数、API でこのクエリを実行するには、
filters の文字列 PLAYLIST_ID を置き換える必要があります。
パラメータ値を、コンテンツ所有者のチャンネルの再生リストの再生リスト ID に置き換えます。
metrics=views,estimatedMinutesWatched,playlistStarts,playlistViews,viewsPerPlaylistStart filters=playlist==PLAYLIST_ID
複数の再生リストの集計統計情報を取得するには、文字列 PLAYLIST_ID を、コンテンツ所有者のチャンネルの再生リストの再生リスト ID（最大 500 個）のカンマ区切りのリストに置き換えることもできます。
動画レポート
自身がアップロードしたコンテンツの日別再生時間の指標
このクエリは、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 日の再生リスト視聴回数
このリクエストは、コンテンツ所有者の 再生リスト。レポートから取得される指標は、playlistViews、playlistStarts です。 playlistEstimatedMinutesWatched、viewsPerPlaylistStart の 2 つがあります。これらの指標のすべて 再生リスト内の指標です。 リクエストされた指標はすべて再生リスト内の指標であるため、リクエストは不要です。 再生リストまたはグループのフィルタも指定します。
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
米国の州とワシントン D.C. の州固有の指標
このリクエストは、コンテンツ所有者が申し立てを行った動画の視聴回数、推定再生時間、平均視聴時間に関する州ごとの内訳を取得します。データは米国の州とワシントン 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 都市（米国の都市）
このクエリは、指定された期間において、コンテンツ所有者によって申し立てが行われたコンテンツの 1 日の合計総再生時間が、米国の都市の最も長い上位 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 – 米国で最も再生されたプレイリスト
このクエリは、コンテンツ所有者のチャンネルから、 指定した期間に、米国で視聴が開始した回数が最も多い。結果: 再生リストの開始数の降順で並べ替えられています。
注: このレポートでは
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 日の視聴回数と総再生時間
このクエリは、特定のチャンネルまたはチャンネル グループにアップロードされた動画の、米国における 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 を、アップロードした動画の最大 500 個の動画 ID のカンマ区切りリストに置き換える必要があります。
dimensions=insightPlaybackLocationDetail metrics=views,estimatedMinutesWatched filters=video==VIDEO_ID;insightPlaybackLocationType==EMBEDDED maxResults=10 sort=-views
再生リストレポート
再生場所ごとの再生リストの視聴回数と総再生時間
このクエリは、再生リストの視聴回数、再生リストの推定総再生時間、 コンテンツ所有者のチャンネル内のすべての再生リストに対して再生が開始されます。結果は集計データに基づく 動画が再生されたページまたはアプリケーションのタイプに応じて、結果が並べ替えられます。 再生リストの開始順。
dimensions=insightPlaybackLocationType metrics=playlistViews,playlistEstimatedMinutesWatched,playlistStarts sort=-playlistStarts
再生場所ごとの再生リストの視聴回数と総再生時間
このクエリは、プレイリストの開始回数、プレイリストの視聴回数、プレイリストの推定視聴時間を取得します。 コンテンツ所有者のチャンネル内のすべての再生リストについて、米国の 100% の視聴時間で識別されます。結果が返される 再生リストの視聴が発生したページまたはアプリケーションのタイプごとに。
dimensions=day,insightPlaybackLocationType metrics=playlistStarts,playlistViews,playlistEstimatedMinutesWatched filters=country==US
動画レポート
トラフィック ソース別の再生回数と再生時間
このリクエストは、コンテンツ所有者の動画の再生回数と推定再生時間を取得します。各指標はトラフィック ソース別に集計されます。トラフィック ソースとは、ユーザーが動画にアクセスした方法です。
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 を、アップロードした動画の最大 500 個の動画 ID のカンマ区切りリストに置き換える必要があります。
dimensions=insightTrafficSourceDetail metrics=views filters=video==VIDEO_ID;insightTrafficSourceType==YT_SEARCH maxResults=10 sort=-views
トップ 10 – 動画のトラフィックが最も多い外部ウェブサイト
このクエリは、特定の動画または動画グループの Google 検索結果から最も多くの視聴回数を獲得した 10 個の外部ウェブサイトを取得します。結果は推定再生時間の降順に並べ替えられます。API Explorer でこのクエリを実行するには、filters パラメータ値の文字列 VIDEO_ID を、アップロードした動画の最大 500 個の動画 ID のカンマ区切りリストに置き換える必要があります。
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
さまざまなトラフィック ソースの再生リストの視聴回数と総再生時間
このリクエストは、再生リストの視聴回数、再生リストの開始回数、再生リストの推定総再生時間を取得します。
の再生リストが表示されます。指標は
トラフィックソースを指定しますAPI Explorer でこのクエリを実行するには、
filters パラメータ値の CHANNEL_ID（カンマで区切る）
最大 500 個のチャネル ID のリスト。
dimensions=day,insightTrafficSourceType metrics=playlistViews,playlistStarts,playlistEstimatedMinutesWatched filters=channel==CHANNEL_ID
動画レポート
申し立てが行われた動画の端末のタイプに関する日別の指標
このクエリは、特定のコンテンツ所有者が申し立てを行った動画の 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 デバイスで再生リストの視聴回数と再生リストの推定総再生時間を取得します。
の再生リストが表示されます。返される結果は次のとおりです:
再生リストの視聴が発生したデバイスの種類API でこのクエリを実行するには、
filters の文字列 CHANNEL_ID を置き換える必要があります。
パラメータ値を最大 500 個のチャネル ID のカンマ区切りのリストに置き換えます。
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