このページでは、CData Cloud でのYouTube Analytics への接続の確立 のガイド、利用可能なリソースに関する情報、および使用可能な接続プロパティのリファレンスについて説明します。

YouTube Analytics への接続

接続の確立 は、CData Cloud にデータベースを作成するためのYouTube Analytics への認証方法と必要な接続プロパティの設定方法について示します。

CData Cloud サービスからデータにアクセス

利用可能な標準サービスを経由してYouTube Analytics からデータにアクセスする方法と、CData Cloud の管理については、CData Cloud ドキュメント で詳しく説明します。

Database タブで対応するアイコンを選択して、YouTube Analytics に接続します。必須プロパティはSettings にリストされています。Advanced タブには、通常は必要ない接続プロパティが表示されます。

YouTube Analytics への接続

以下のサブセクションでは、3つの一般的な認証フローでのYouTube Analytics への認証について詳しく説明します。

• デスクトップ：ユーザーのローカルマシン上でのサーバーへの接続で、テストやプロトタイピングによく使用されます。組み込みOAuth またはカスタムOAuth で認証されます。
• Web：共有ウェブサイト経由でデータにアクセスします。カスタムOAuth でのみ認証されます。
• ヘッドレスサーバー：他のコンピュータやそのユーザーにサービスを提供する専用コンピュータで、モニタやキーボードなしで動作するように構成されています。組み込みOAuth またはカスタムOAuth で認証されます。

カスタムOAuth アプリケーションの作成方法と、組み込みOAuth 認証情報を持つ認証フローでもカスタムOAuth アプリケーションを作成したほうがよい場合の説明については、カスタムOAuth アプリケーションの作成 を参照してください。

YouTube Analytics で利用可能な接続文字列プロパティの全リストは、Connection を参照してください。

アクセストークンの期限が切れたときは、Cloud は自動でアクセストークンをリフレッシュします。

OAuth アクセストークンの自動リフレッシュ：

Cloud がOAuth アクセストークンを自動的にリフレッシュするようにするには、次のように設定します。

1. はじめてデータに接続する際、次の接続プロパティを設定します。
   • InitiateOAuth = REFRESH。
   • OAuthClientId = アプリケーション設定のクライアントId。
   • OAuthClientSecret = アプリケーション設定のクライアントシークレット。
   • OAuthAccessToken = GetOAuthAccessToken によって返されたアクセストークン。
   • OAuthSettingsLocation = Cloud がOAuth 値を保存する場所のパス。これは接続間で維持されます。
2. その後のデータ接続では、以下を設定します。
   • InitiateOAuth
   • OAuthSettingsLocation

OAuth アクセストークンの手動リフレッシュ：

OAuth アクセストークンを手動でリフレッシュするために必要な唯一の値は、OAuth リフレッシュトークンです。

1. ExpiresIn 期間（GetOAuthAccessToken が返す）が経過した後にOAuthAccessToken を手動でリフレッシュするには、RefreshOAuthAccessToken ストアドプロシージャを呼び出します。
2. 次の接続プロパティを設定します。
   • OAuthClientId = アプリケーション設定のクライアントId。
   • OAuthClientSecret = アプリケーション設定のクライアントシークレット。

3. RefreshOAuthAccessToken を呼び出し、OAuthRefreshToken にGetOAuthAccessToken によって返されたOAuth リフレッシュトークンを設定します。
4. 新しいトークンが取得できたら、OAuthAccessToken プロパティにRefreshOAuthAccessToken によって返された値を設定します。Open は、新規接続を開きます。

OAuth リフレッシュトークンを保存し、OAuth アクセストークンの有効期限が切れた後に手動でリフレッシュできるようにします。

OAuth 認証を設定するには、いくつかの事前設定が必要です。ユーザーアカウント、サービスアカウント、またはGCP インスタンスアカウントが正しく構成されると、接続の準備が整います。

ユーザーアカウント

このセクションでは、カスタムOAuth アプリケーションを登録してユーザーアカウント用のOAuthClientId およびOAuthClientSecret を取得する方法について説明します。

デスクトップ

アプリを登録してOAuth クライアントクレデンシャルを取得するには：

1. Google API コンソールにログインします。
2. プロジェクトを開きます。
3. メインメニューからAPI マネージャーを選択します。
4. ユーザー同意フローで、認証情報 -> 認証情報を作成 -> OAuth クライアントID をクリックします。
5. その他をクリックします。Google API Console はカスタムアプリケーションを作成し、OAuthClientId およびOAuthClientSecretを表示します。
6. あとで使用するためにOAuthClientId およびOAuthClientSecret を記録します。
7. ライブラリ -> YouTube Analytics API -> 有効にするをクリックします。

サービスアカウント

OAuth アプリケーションを作成するには、プライベートキーを生成してサービスアカウント認証します。

1. Google API コンソールにログインします。
2. プロジェクトを開きます。
3. メインメニューからAPI マネージャーを選択します。
4. ユーザー同意フローで、認証情報 -> 認証情報を作成 -> サービスアカウントキーをクリックします。
5. ［サービスアカウント］メニューで新しいサービスアカウント（該当する場合）か既存のサービスアカウントのいずれかを選択します。
6. 新しいサービスアカウントの場合、1つもしくは複数のロールを選択します。IAM およびAdmin セクションのプロジェクトレベルでプリミティブロールをアサインすることが可能です。他のロールでは、Google API へのカスタムアクセスを有効にできます。
7. ［キーのタイプ］でP12 キーを選択します。
8. 作成をクリックします。Google API Console はカスタムアプリケーションを作成し、鍵ペアと 秘密鍵のパスワードを表示します。
9. 鍵ペアをダウンロードし、OAuthJWTCertPassword に秘密鍵のパスワードを設定します。
10. ［サービスアカウント］メニューでサービスアカウントの管理をクリックします。
11. OAuthJWTIssuer をサービスアカウントID フィールドで表示されたE メールアドレスに設定します。
12. ライブラリ -> YouTube Analytics API -> 有効にするをクリックします。

GCP インスタンスアカウント

GCP 仮想マシン上で実行している場合は、Cloud は仮想マシンに関連付けられたサービスアカウントを使用して認証できます。 このモードを使用するには、AuthScheme をGCPInstanceAccount に設定します。

YouTube Analytics データは、さまざまな指標（Viewers, ViewerPercentage, AgeGroup, etc.）に分類され、さまざまなディメンション（Day, DeviceType, etc.）でクエリすることができます。有効な指標とディメンションの組み合わせは多数あります。Cloud は、最もよく使用される組み合わせを使いやすくリレーショナルビューとして公開しています。

また、Cloud は、事前定義されたビューに含まれない組み合わせであっても、有効なすべての組み合わせをクエリできるようにしています。CreateCustomSchema ストアドプロシージャを使用してクエリのビューを作成できます。クエリおよびスキーマで指標とディメンションを結合する方法については、データモデル を参照してください。以下に、まずデフォルトのビューを使用する方法を示します。

ディメンションおよび指標の選択

ディメンションおよび指標は各テーブルに明確に定義されており、データモデル で参照できます。興味のある指標およびディメンションを選択してください。 例えば、特定の国でほとんどが視聴されたチャンネルのトップ動画は、次のように選択できます。

SELECT Video, Views, EstimatedMinutesWatched, AverageViewDuration, AverageViewPercentage FROM TopVideos WHERE Country='AL'

SELECT * クエリの実行

通常のデータベーステーブルとは異なり、特定のテーブルですべての指標およびディメンションを選択しても、あまり役には立ちません。このため、Cloud では、SELECT * クエリは、デフォルトの指標とディメンションのセットが要求されていると解釈されます。これは、明示的にすべてのカラムを選択しているクエリにも適用されます。スキーマごとのデフォルトのフィールドを確認するには、データモデル で各ビューのドキュメントを参照してください。

Firewall またはProxy 経由の接続

HTTP プロキシ

Windows のシステムプロキシ経由の接続では、接続プロパティを追加で設定する必要はありません。他のプロキシに接続するには、ProxyAutoDetect をfalse に設定します。

さらにHTTP プロキシへの認証には、ProxyServer とProxyPort に加えてProxyAuthScheme、ProxyUser、およびProxyPassword を設定します。

その他のプロキシ

次のプロパティを設定します。

• プロキシベースのファイヤーウォールを使用するには、FirewallType、FirewallServer、およびFirewallPort を設定します。
• 接続をトンネルするには、FirewallType をTUNNEL に設定します。
• 認証するには、FirewallUser とFirewallPassword を設定します。
• SOCKS プロキシへの認証には、さらにFirewallType をSOCKS5 に設定します。

CData Cloud は、YouTube Analytics エンティティをリレーショナルテーブル、ビュー、およびストアドプロシージャにモデル化します。

YouTube Analytics を使用すると、ディメンションおよび指標のクエリをさまざまな組み合わせで実行できます。 YouTube Analytics レポートに基づいて、いくつかのサンプルビューが用意されています。また、必要に応じてディメンションおよび指標を任意に組み合わせて、独自のカスタムビューを作成することもできます。

スキーマの表示方法、およびAPI の制限と要件については、以下のカスタムビューの 定義を参照してください。

テーブル

Groups およびGroup Items にテーブル としてアクセス可能です。

ストアドプロシージャ

ストアドプロシージャ は、YouTube Analytics API の追加機能を利用可能にする、データソースのファンクションライクなインターフェースです。

ビュー

レポートはビュー、つまりデータの「スナップショット」であるテーブルとして表示され、変更することはできません。 従来のデータベースビューとは異なり、テーブル内のすべての指標とディメンションを選択してテーブル全体のビュ ーを作成することはあまり有益ではありません。プロバイダは SELECT * クエリを、指標とディメンションの既定のセットを要求しているかのように解釈するからです。 これは、明示的にすべてのカラムを選択しているクエリにも当てはまります。

YouTube Analytics API は、データに投影できるまたは返される結果を制限するために使用する、カラムの数や組み合わせを制限していることに留意してください。これらの制限および各スキーマのデフォルトフィールドについては、 ビュー で説明しています。独自のビューを定義する場合は、これらのセクションを参照してください。

カスタムビューの定義

CreateCustomSchema ストアドプロシージャを使用してクエリのビューを作成します。ストアドプロシージャを使用すると、ディメンションと指標を独自に組み合わせて、簡単に新しいビュー定義を生成できます。 このストアドプロシージャを呼び出すと、新しいスキーマファイルが作成されます。このファイルは、他のビューと同様にクエリすることができます。

このストアドプロシージャは、入力として、ビュー名、指標のカンマ区切りリスト、ディメンションのカンマ区切りリスト、および出力フォルダを受け取ります。 作成されたスクリプトファイルにアクセスするには、Location を新しいスクリプトファイルを含むフォルダに設定します。言い換えれば、Location は出力フォルダの代わりとなります。

例えば、デフォルトスキーマとともに新しいスキーマを使用するには、Location をインストールフォルダ内のdb サブフォルダに設定し、呼び出しを行います。

EXEC CreateCustomSchema Dimensions='Day,DeviceType', Metrics='Views,EstimatedMinutesWatched', TableName='DailyDeviceReports'

Cloud はYouTube Analytics のデータを、標準のSQL ステートメントを使用してクエリできるリレーショナルデータベースのテーブルのリストとしてモデル化します。

CData Cloud - YouTube Analytics テーブル

Create, delete, and query Items that compose a Group.

テーブル固有の情報

Select

次のクエリは、YouTube Analytics グループを構成するアイテムを返します。

SELECT * FROM GroupItems

次のクエリは、特定のYouTube Analytics グループを構成するアイテムを返します。

SELECT * FROM GroupItems WHERE GroupId = '239_65GrkKS6kRL'

Insert

グループにアイテムを挿入するには、GroupId とResource_Id が必須です。

INSERT INTO GroupItems (GroupId, Resource_Id) VALUES ('fjgeeljgio54', 'dkhgjio5sfff')

Columns

Create, update, delete, and query YouTube Analytics Groups.

テーブル固有の情報

グループとは最大200 のチャンネル、動画、再生リスト、またはアセットのカスタムコレクションです。グループ内のすべてのアイテムは同じタイプのエンティティを表す必要があります。例えば、100 の動画と100 の再生リストを持つグループを作成することはできません。Analytics グループには、アップロードした、主張した、または管理しているチャンネルにリンクされているエンティティのみが含まれます。結果として、コンテンツ所有者は動画、再生リスト、チャンネル、またはアセットのグループを作成できます。チャンネル所有者は、動画および再生リストのグループを作成できます。

Select

WHERE 句で次のカラムを使用できます：OnBehalfOfContentOwner およびMine。

Insert

グループを挿入するには、ContentDetails_ItemType が必須です。

INSERT INTO Groups (Snippet_Title, ContentDetails_ItemType) VALUES ('test2', 'youtube#channel')

Columns

ビューは、データを示すという点でテーブルに似ていますが、ビューは読み取り専用です。

クエリは、ビューに対して通常のテーブルと同様に実行することができます。

CData Cloud - YouTube Analytics ビュー

Query YouTube Activities. An Activity resource contains information about an action that a particular Channel, or User, has taken on YouTube.

Table Specific Information

Select

YouTube Analytics only allows Channel Id to be used as filter criteria. Additionally, the extra optional columns supported are PublishedAt and Region.

All columns support the '=' operator. PublishedAt also supports '>', '>=', '<', and '<='.

By default, if no filters are specified, the driver will return activities generated by authenticated user.

SELECT * FROM Activities WHERE ChannelId = "abc123" AND PublishedAt < '2016-01-01T10:00:00Z'

Columns

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。

Query Ad Performance Reports. Ad Performance Reports provide impression-based metrics for ads that ran during video playbacks. These metrics account for each ad impression, and each video playback can yield multiple impressions.

テーブル固有の情報

Select

広告タイプと日によってグループ化された特定の国の動画のGrossRevenue を取得します。

SELECT Country, AdType, Day, GrossRevenue, StartDate, EndDate FROM AdPerformanceReports WHERE video = 'vid123' AND continent = '019'

Select Rules

コンテンツ所有者の広告パフォーマンスレポート

Columns

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。

Query YouTube Captions. A Caption resource represents a YouTube caption track.

Table Specific Information

Select

YouTube Analytics allows only a subset of columns to be used as filter criteria. The VideoId column must be specified. Extra optional columns supported are Id and OnBehalfOfContentOwner.

All columns support the '=' operator.

SELECT * FROM Captions WHERE VideoId = '123456789'

Columns

Query YouTube Channels.

Table Specific Information

Select

By default, SupportEnhancedSQL is set to true, and the following will be passed to YouTube Analytics if present. Other filters will be executed client side. If SupportEnhancedSQL is set to false, only the following filters will be honored.

By default, if no filters are specified, the driver will return all channels owned by the authenticated user.

YouTube Analytics allows only a subset of columns to be used as filter criteria. The channels can be filtered by the Id. Extra optional columns supported are Language and ChannelId.

A search against all channels in YouTube Analytics may be triggered by specifying one or more of SearchTerms, ChannelId, Region, SafeSearch, Rating, or Relevance to search all channels.

All columns support the '=' operator. 'PublishedAt', also supports '>', '>=', '<', and '<='.

Order by is supported for the Rating, Relevance, and Title columns.

SELECT * FROM Channels WHERE Id = 'abc123'

SELECT * FROM Channels WHERE ChannelId = 'abc123' AND SearchTerms = 'music|movies-horror' ORDER BY Rating LIMIT 10

Note: Ordering is not supported when specifying one of the colums used for searching channels such as SearchTerms.

Columns

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。

Query YouTube ChannelSections. A ChannelSection contains information about a set of Videos that a Channel has chosen to feature.

Table Specific Information

Select

YouTube Analytics allows only a subset of columns to be used as filter criteria. You can specify exactly one of the following columns: ChannelId or Id. Extra optional columns supported are Language and OnBehalfOfContentOwner.

All columns support the '=' operator.

By default, if no channel id is specified, the driver will return channel sections for the channel owned by authenticated user.

SELECT * FROM ChannelSections WHERE ChannelId = '123456789'

Columns

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。

Query YouTube Comments.

Table Specific Information

Select

YouTube Analytics allows only a subset of columns to be used as filter criteria. You must specify exactly one of the following columns: Id or ParentId. Extra optional columns supported are TextFormat.

All columns support the '=' operator.

SELECT * FROM Comments WHERE Id = '123456789'

Columns

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。

Query YouTube CommentThreads. A CommentThread record contains information about a YouTube comment thread, a top-level comment and replies, if any exist, to that comment.

Table Specific Information

Select

YouTube Analytics allows only a subset of columns to be used as filter criteria. You must specify exactly one of the following columns: AllThreadsRelatedToChannelId, ChannelId, Id, or VideoId.

Extra optional columns supported are ModerationStatus, SearchTerms, and TextFormat. All columns support the '=' operator.

Order is supported for CommentThreads. Relevance are the supported order columns.

SELECT * FROM CommentThreads WHERE VideoId = 'abcdef123456' ORDER BY Relevance DESC LIMIT 10

Note: Ordering is not supported for use in conjunction with the Id parameter.

Columns

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。

Query YouTubeAnalytics Demographics grouped by age groups and gender.

テーブル固有の情報

Select

動画の統計情報を視聴者の年齢層と性別に基づいて集計します。

SELECT * FROM Demographics

デモグラフィックを１動画のみに減らします。

SELECT * FROM Demographics WHERE Video = 'video_Id'

再生リストの統計情報を視聴者の年齢層と性別に基づいて集計します。

SELECT * FROM Demographics WHERE IsCurated = true

Select Rules

次のテーブルを使用してトップ動画への他のクエリを作成できます。

動画のデモグラフィック：

再生リストのデモグラフィック：

コンテンツ所有者のデモグラフィック：

コンテンツ所有者の再生リストのデモグラフィック：

Columns

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。

Query YouTubeAnalytics Devices or Operating System statistics. This table allows you to aggregate viewing statistics based on the manner in which viewers reached your video content. For example, you can identify the number of views that occurred on mobile devices or game consoles.

テーブル固有の情報

Select

デフォルトでは、グループ化はデバイスタイプによって行われます。

SELECT * FROM Devices

オペレーティングシステムなど他のディメンションでビューをグループ化できます。

SELECT OperatingSystem, Views, EstimatedMinutesWatched FROM Devices

Select Rules

次のテーブルを使用してデバイスへの他のクエリを作成できます。

動画のデバイス：

再生リストのデバイスデータ：

コンテンツ所有者のデバイスデータ：

コンテンツ所有者の再生リストのデバイスデータ：

Columns

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。

Query Engagement Reports info. For example, how many times a user shared a video.

テーブル固有の情報

Select

デフォルトでは、結果はDay でグループ化されます。次のクエリは、Day によってグループ化されたComments、Likes、Dislikes、etc. を返します。

SELECT * FROM EngagementReports

Select Rules

次のクエリは、チャンネルの動画が異なるソーシャルプラットフォームでシェアされた頻度を返します。

SELECT SharingService, Shares FROM EngagementReports

動画のエンゲージメントレポート

コンテンツ所有者のエンゲージメントレポート

Columns

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。

Query YouTube i18nLanguages. An i18nLanguage resource identifies an application language that the YouTube website supports. The application language can also be referred to as a UI language.

Table Specific Information

Select

There are no required filters for this table. An optional column supported is Language.

All columns support the '=' operator.

Columns

Query YouTube PlayListItems. A PlayListItem resource identifies another YouTube entity, such as a Video, that is included in a PlayList. In addition, the PlayListItem record contains details about how that entity is used in that PlayList.

Table Specific Information

Select

You must specify exactly one of the following columns in the WHERE clause: Id or PlayListId. Extra optional columns supported are OnBehalfOfContentOwner and VideoId.

All columns support the '=' operator.

SELECT * FROM PlaylistItems WHERE PlaylistId = 'abcdef123456'

Columns

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。

Query YouTube PlayLists. A PlayList is a collection of videos that can be viewed sequentially and shared with other users.

Table Specific Information

Select

By default, SupportEnhancedSQL is set to true, and the following will be passed to YouTube Analytics if present. Other filters will be executed client side. If SupportEnhancedSQL is set to false, only the following filters will be honored.

By default, if no filters are specified, the CData Cloud will return all playlists for the channel owned by authenticated user.

YouTube Analytics allows only a subset of columns to be used as filter criteria. You can specify exactly one of the following columns: ChannelId or Id. Extra optional columns supported are PublishedAt, Language, OnBehalfOfContentOwner, and OnBehalfOfContentOwnerChannel.

A search against all channels in YouTube Analytics may be triggered by specifying one or more of SearchTerms, ForContentOwner, Region, SafeSearch, Rating and Rating to search all playlists.

All columns support the '=' operator. PublishedAt also supports these additional operators: '>', '>=', '<', and '<='.

Order by is supported for the Rating, Relevance, and Title columns.

SELECT * FROM PlayLists WHERE Id = 'abcdef123456'

SELECT title FROM PlayLists WHERE PublishedAt >= '2016-01-01' ORDER BY Title LIMIT 10

Note: Ordering is not supported when specifying one of the colums used for searching playlists such as SearchTerms.

Columns

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。

Query YouTube i18nRegions. An i18nRegion resource identifies a geographic area that a YouTube user can select as the preferred content region. The content region can also be referred to as a content locale.

Table Specific Information

Select

There are no required filters for this table. An optional column supported is Language.

All columns support the '=' operator.

Columns

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。

Query YouTube User Subscriptions. A Subscription notifies a User when new Videos are added to a Channel, or when another user takes one of several actions on YouTube, such as uploading a Video, rating a Video, or commenting on a Video.

Table Specific Information

Select

You can specify exactly one of the following columns: ChannelId, Id, MyRecentSubscribers, or MySubscribers.

Extra optional columns supported are ForChannelId, OnBehalfOfContentOwner, and OnBehalfOfContentOwnerChannel. All columns support the '=' operator.

Order is supported for Subscriptions. 'Alphabetical', 'Relevance', and 'Unread' are the supported order columns.

By default, if no filters are specified, the driver will return a list of channels subscribed by authenticated user.

SELECT Title FROM Subscriptions WHERE ChannelId = 'abc123' ORDER BY Unread DESC

The default value is SUBSCRIPTION_ORDER_RELEVANCE.

Columns

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。

Query time-based info on views, subscribers, etc. For example, how many new subscribers were gained at a specific time.

テーブル固有の情報

Select Rules

再生リストルールのTimeBased レポート：

コンテンツ所有者ルールのTimebased レポート：

コンテンツ所有者の再生リストルールのTimebased レポート：

Columns

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。

Query the TopVideos for a channel or the TopPlaylists if you are a content owner. You can also use this view to query playback detail and geographic filters.

テーブル固有の情報

Select

次のクエリは、チャンネルのトップ動画を返します。

SELECT * FROM TopVideos

次のクエリは、特定の国でほとんどが視聴されたチャンネルのトップ動画を返します。

SELECT Video, Views, EstimatedMinutesWatched, AverageViewDuration, AverageViewPercentage FROM TopVideos WHERE Country = 'US'

次のクエリは、ほとんどが視聴されたチャンネルのトップ再生リストを返します。

SELECT Playlist, Views, EstimatedMinutesWatched, PlaylistStarts, AverageViewDuration FROM TopVideos WHERE IsCurated = true

Select Rules

次のテーブルを使用してトップ動画への他のクエリを作成できます。

動画のトップ動画：

再生リストのトップ動画：

コンテンツ所有者のトップ動画：

コンテンツ所有者の再生リストのトップ動画：

Columns

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。

Query TrafficSources. Statistics are based on the manner in which viewers reached your video and playlist content.

テーブル固有の情報

Select

次のクエリは、視聴者が動画コンテンツに達した方法に基づいて統計情報を集計します。例えば、Google 検索や関連動画へのリンクからのビューの数を特定できます。

SELECT * FROM TrafficSources

次のクエリは、Day およびInsightTrafficSourceType ディメンションでグループ化されたViews およびEstimatedMinutesWatched 指標を表示します。

SELECT Day, InsightTrafficSourceType, Views, EstimatedMinutesWatched FROM TrafficSources

次のクエリは、特定の動画および国で集計される統計をフィルタリングします。

SELECT Day, InsightTrafficSourceType, Views, EstimatedMinutesWatched FROM TrafficSources WHERE Video = 'video_id' AND Country = 'US'

次のクエリは、視聴者が再生リストコンテンツに達した方法に基づいて統計情報を集計します。例えば、Google 検索からのビューの数を特定できます。

SELECT InsightTrafficSourceType, Views, EstimatedMinutesWatched, PlaylistStarts, ViewsPerPlaylistStart, AverageTimeInPlaylist FROM TrafficSources WHERE IsCurated = true

次のクエリは、再生リストにある動画のYouTube 検索結果から最も多くの視聴回数を生成した検索用語を返します。YouTube Analytics API の制限により、このようなクエリには順序付けと制限が必須であることに注意してください。

SELECT InsightTrafficSourceDetail, Views, EstimatedMinutesWatched, PlaylistStarts, ViewsPerPlaylistStart, AverageTimeInPlaylist FROM TrafficSources WHERE IsCurated = true AND InsightTrafficSourceType = 'YT_SEARCH' ORDER BY Views DESC LIMIT 25

Select Rules

次のテーブルを使用してトラフィックソースへの他のクエリを作成できます。

動画のトラフィックソース：

再生リストのトラフィックソース：

コンテンツ所有者のトラフィックソース：

コンテンツ所有者の再生リストのトラフィックソース：

Columns

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。

This report provides user activity statistics, sorted by city.

テーブル固有の情報

Select Rules

都市別のユーザーアクティビティをクエリするには、maxResults を250以下の整数値に設定する必要があります。 また、ソートリクエストパラメータにも値を指定する必要があります。

Video レポート：

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

Columns

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。

This report provides user activity statistics.

テーブル固有の情報

Select Rules

国別のユーザーアクティビティは、特定の動画のデータを返すためにのみフィルタリングすることができます。

Video レポート：

Playlist レポート：

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

Columns

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。

This report provides user activity statistics, sorted by province (includes Washington DC).

テーブル固有の情報

Select Rules

州別のユーザーアクティビティは、米国の州およびコロンビア特別区に適用されます。province を使用するには、filters パラメータ値をcountry==US に設定する必要があります。

Video レポート：

Playlist レポート：

このレポートは、米国各州とワシントンDC のプレイリストのアクティビティの統計です。このレポートでは、 filters パラメータ値にcountry==US を含める必要があります。

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

コンテンツ所有者の再生リストのレポート：

Columns

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。

Query YouTube VideoAbuseReportReasons. A VideoAbuseReportReason resource contains information about a reason that a Video would be flagged for containing abusive content.

Table Specific Information

Select

There are no required filters for this table. An optional column is Language.

The '=' operator is supported for this column.

Columns

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。

Query YouTube VideoCategories. A VideoCategory resource identifies a category that has been or could be associated with uploaded Videos.

Table Specific Information

Select

You can specify exactly one of the following columns: Id or Region. If you do not specify any filtering criteria, by default you will get results for the US Region. An extra optional parameter is Language.

SELECT * FROM VideoCategories WHERE Region = 'JP'

SELECT Id, Kind, Etag, ChannelId, Title, Assignable
FROM   VideoCategories
WHERE  (ID IN ('1', '2', '10'))

Columns

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。

Query YouTube Videos.

Table Specific Information

Select

By default, SupportEnhancedSQL is set to true, and the following will be passed to YouTube Analytics if present. Other filters will be executed client side. If SupportEnhancedSQL is set to false, only the following filters will be honored.

By default, if no filters are specified, the driver will return all videos owned by the authenticated user.

Only one of the following columns may be filtered by at a time: Id, MyRating, ChannelId, or Chart. Extra columns supported are ForMine, Language, ForContentOwner, OnBehalfOfContentOwner.

A search against all videos on Youtube may be executed by specifying SearchTerms, RelatedToVideoId, VideoDuration, VideoCategoryId, or Region.

All columns support the '=' operator. PublishedAt also supports these additional operators: '>', '>=', '<', and '<='. Id and ChannelId supports IN.

Order by is supported for the Date, Rating, Relevance and Title columns.

SELECT * FROM Videos WHERE Id = '12345679'

SELECT * FROM Videos WHERE PublishedAt >= '2016-01-01T20:30:00Z' LIMIT 10

SELECT Description FROM Videos WHERE ForMine = True ORDER BY Date

Note: Ordering is not supported when specifying one of the colums used for searching channels such as SearchTerms.

The IN operator can be used to specify a list of channels. This call returns a list of videos for each specified channel.

SELECT * FROM Videos WHERE ChannelId IN (a, b, c)
SELECT * FROM Videos WHERE ChannelId IN (SELECT Id FROM Channels)

IN operator can also be used for getting data for multiple videos.

SELECT * FROM Videos WHERE Id IN (a, b, c)

Columns

Pseudo-Columns

SELECT ステートメントのWHERE 句では、疑似カラムフィールドを使用して、データソースから返されるタプルを詳細に制御することができます。

ストアドプロシージャはファンクションライクなインターフェースで、YouTube Analytics の単純なSELECT/INSERT/UPDATE/DELETE 処理にとどまらずCloud の機能を拡張します。

ストアドプロシージャは、パラメータのリストを受け取り、目的の機能を実行し、プロシージャが成功したか失敗したかを示すとともにYouTube Analytics から関連するレスポンスデータを返します。

CData Cloud - YouTube Analytics ストアドプロシージャ