はじめに
YouTube Reporting Enterprise Partitionは定義済みレポートとジョブレポートをサポートしています。これには、チャンネルまたはコンテンツの所有者向けの総合的な YouTubeアナリティクスのデータセットなどが含まれます。DomoのYoutube Reporting Enterprise Partitionコネクターを使用すると、YouTubeアナリティクスAPIでクエリできる一括データセットをダウンロードすることができます。このコネクターを使用すると、YouTube AnalyticsをDomoに接続して、YouTubeの戦略を改善することができます。- YouTube Reportingコネクター - このコネクターは、エントリーレベルのYouTubeコネクターです。認証に必要なのは、Googleのユーザー名とパスワードのみです。ほとんどのDomoユーザーは、このコネクターを使用してYouTubeデータを取得するはずです。
- YouTube Reporting Enterpriseコネクター - YouTube Reportingコネクターのエンタープライズバージョンです。このレポートには、いくつかの追加レポートがあります。基本的なGoogleユーザー名とパスワードに加えて、GoogleクライアントIDとクライアントシークレットを入力する必要があります。
- YouTube Enterprise Advancedコネクター - Domoの最も高度なYouTubeコネクターです（これがYouTube Enterpriseコネクターの唯一のバージョンです。単に「YouTube Enterprise」と呼ばれるコネクターはありません）。GoogleクライアントIDとクライアントシークレット、およびGoogleユーザー名とパスワードが必要です。ほかのYouTubeコネクターよりも多くのレポートとオプションを提供しますが、設定が複雑で非常に困難です。このコネクターは、上級ユーザーにのみ推奨されます。
- YouTube Reporting Partitionコネクター - 提供するレポートはYouTube Reportingコネクターと同じですが、DataSetでパーティショニングを使用できます。
- YouTube Reporting Enterprise Partitionコネクター - 提供するレポートはYouTube Reporting Enterpriseコネクターと同じですが、DataSetでパーティショニングを使用できます。
ベストプラクティス
レポートが作成されるとジョブが生成され、データが返されるまでには24時間かかります。 レポートジョブのスケジュールを設定すると、YouTubeによりその日以降のレポートが生成され、ジョブのスケジュールが設定された時刻よりも前の180日間のレポートも生成されます。 レポートタイプのジョブ作成日よりも前の日付はすべて、履歴とみなされます。 YouTubeでは最大60日間の履歴データを生成できます。履歴レポートは、利用可能になると直ちに、任意の順序でポストされます。すべての履歴データがジョブにポストされるまで、約1ヶ月かかります。つまり、レポートジョブのスケジュールを設定してから1ヶ月後には、約2ヶ月分のデータにアクセスできます。必要条件
YouTubeアカウントに接続してDataSetを作成するには、以下が必要です。- GoogleクライアントID
- Googleクライアントシークレット
- Googleのユーザー名とパスワード
YouTube Reporting Enterpriseアカウントに接続する
このセクションでは、YouTube Reporting Enterprise Partitionコネクターページの［認証情報］ペインと［詳細］ペインのオプションについて説明します。 このページのほかのペインの項目である ［スケジュール設定］ や ［DataSetに名前を付け、説明を入力］ に関しては、ほとんどのタイプのコネクターで共通しています。詳細については、「 コネクターを使用してDataSetを追加する 」を参照してください。［認証情報］ペイン
このペインには、 YouTube アカウントに接続するための認証情報の入力フィールドがあります。下テーブルは、各フィールドに必要な内容を説明しています。フィールド | 説明 |
|---|---|
Client ID | GoogleクライアントIDを入力します。 |
Client Secret | Googleクライアントシークレットを入力します。 |
［詳細］ペイン
このペインには、メインの ［Reports］ メニューのほか、選択したレポートタイプに応じて表示/非表示になるその他様々なメニューがあります。メニュー | 説明 | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Report | 必要なYouTube Reporting Enterprise Partitionレポートを選択します。選択するAPIのタイプに応じて、様々なレポートをご利用いただけます。
| ||||||||||||||||
Call on Behalf of Content Owner | 別のユーザー（ ［Content Owner ID］ フィールドに入力するユーザーのID）の定義済みレポートを取得する場合は、 ［Yes］ を選択します。取得するレポートのコンテンツ所有者である場合は、 ［No］ を選択します。 注記： これを実行するには、開発者コンソールアプリケーションでコンテンツ所有者のアクセス権とコンテンツID APIを有効にする必要があります。 | ||||||||||||||||
Content Owner ID | 取得対象のコンテンツを持つユーザーのコンテンツ所有者IDを入力します。パラメーターの値が指定されていない場合、APIサーバーではリクエストはユーザー自身のチャンネルのために実行されたものとみなします。 コンテンツ所有者IDを確認するには、MCN（マルチチャネルネットワーク）のメンバーである必要があります。詳細については、 https://support.google.com/youtube/answer/2737059?hl=ja を参照してください。 コンテンツ所有者IDを確認するには、以下を実行してください。
例えば、ページのURLが https://www.youtube.com/dashboard?o=abc123_qrs_654 である場合、コンテンツ所有者のIDは abc123_qrs_654 になります。 注記： これを実行するには、開発者コンソールアプリケーションでコンテンツ所有者のアクセス権とコンテンツID APIを有効にする必要があります。 | ||||||||||||||||
Preserve Column Names | レポートが変更された場合に、DataSetの列名を保持するかどうかを指定します。データが変更された場合でもカードが破損しないように、これを ［True］ に設定することを推奨します。 | ||||||||||||||||
Retrieve Video and Channel Names | レポートに動画IDまたはチャンネルID、あるいはその両方が存在する場合に、動画名とチャンネル名を取得するかどうかを指定します。 | ||||||||||||||||
Channel IDs | データを取得するチャンネルIDを入力します。複数のチャンネルIDが存在する場合は、コンマで区切ってください。 | ||||||||||||||||
Duration | 特定の日付に対して、または日付範囲に対してデータを取得するかどうかを選択します。 | ||||||||||||||||
| Backfill Days | バックフィル日数の数値を入力します。 | ||||||||||||||||
Report Date | レポートのデータが特定の日付か、今日から何日前までのものかを選択します。 | ||||||||||||||||
Select Specific Date | レポートの日付を選択します。 | ||||||||||||||||
Days Back | レポートに表示する過去日数を入力します。 | ||||||||||||||||
Start Date | 日付範囲の最初の日付が特定の日付なのか、相対的な日付なのかを指定します。範囲の最後の日付は ［End Date］ で選択します。 | ||||||||||||||||
End Date | 日付範囲の2番目の日付が特定の日付なのか、相対的な日付なのかを指定します。日付範囲の最初の日付は ［Start Date］ で選択します。 | ||||||||||||||||
Select Specific Start Date | 日付範囲の最初の日付を選択します。 | ||||||||||||||||
Select Specific End Date | 日付範囲の2番目の日付を選択します。 | ||||||||||||||||
Days Back to Start From | レポートで表示する過去の日のうち、現在から最も遠い日までの日数を入力します。 ［Days Back to End At］ と組み合わせることによって、範囲を作成できます。 例えば、 ［Days Back to Start From］ に10、 ［Days Back to End At］ に「5」を入力した場合、レポートには、今日から数えて10日前から5日前のデータが含まれます。 | ||||||||||||||||
Days Back to End At | レポートで表示する過去の日のうち、現在から最も近い日までの日数を入力します。 ［Days Back to Start From］ と組み合わせることによって、範囲を作成できます。 例えば、 ［Days Back to Start From］ に10、 ［Days Back to End At］ に5を入力した場合、レポートには、今日から数えて10日前から5日前のデータが含まれます。 |
その他のペイン
スケジュール設定、再試行、更新に関するオプションなど、コネクターインターフェースのその他のペインに表示されるオプションについては、「 コネクターを使用してDataSetを追加する 」を参照してください。よくある質問
このコネクターではどのバージョンのYouTube Reporting APIを使用しますか？
このコネクターではどのバージョンのYouTube Reporting APIを使用しますか？
このコネクターを作成するにはどのような認証情報が必要ですか？
このコネクターを作成するにはどのような認証情報が必要ですか？
クライアントIDとクライアントシークレットを作成するには
クライアントIDとクライアントシークレットを作成するには
- Googleアカウントを使用して、 Google Developer Dashboard にログインします。
- 新しいアプリケーションを作成します。「YouTube Connection」のような内容を示す名前を付けます。
- ［ライブラリ］セクションを使用するには、以下のAPIを有効にする必要があります。
- YouTubeアナリティクスAPI
- YouTubeデータAPI
- Google+ API
- ［認証情報］セクションには、「OAuth consent screen」と呼ばれるタブがあります。製品名をプロジェクトと同じ名前に設定します。
- ［認証情報］タブで［認証情報を作成］ボタンを押し、OAuthクライアントIDを作成します。
- Webアプリケーションを作成します。
- 以下の承認済みのJavaScriptのオリジンを設定します。
- 以下の承認済みのリダイレクトURIを設定します。
- これにより、クライアントIDとクライアントシークレットが表示されます。これをコピーして、Domoのアカウント作成画面に貼り付けます。
このコネクターを使用するために、特定の種類のアカウントは必要ですか？
このコネクターを使用するために、特定の種類のアカウントは必要ですか？
自分のYouTubeアカウントは、自分の会社のコンテンツ管理アカウントにアクセスすることができます。動画やチャンネルに関する情報を取得するにはどうすればよいですか？
自分のYouTubeアカウントは、自分の会社のコンテンツ管理アカウントにアクセスすることができます。動画やチャンネルに関する情報を取得するにはどうすればよいですか？
注意すべきAPI制限はありますか？
注意すべきAPI制限はありますか？
データはどれくらいの頻度で更新できますか？
データはどれくらいの頻度で更新できますか？
YouTube Reporting EnterpriseコネクターとYouTube Reporting Enterprise Partitionコネクターの違いは何ですか？
YouTube Reporting EnterpriseコネクターとYouTube Reporting Enterprise Partitionコネクターの違いは何ですか？
トラブルシューティング
- 認証が有効であることを確認してください。
- 設定を見直し、すべての必須項目が選択されていることを確認してください。
- コネクターの履歴にエラーメッセージが記録されていないか確認してください。
- まれに、リクエストした情報が多すぎた結果、API制限またはタイムアウトに達する場合があります。記録されている場合は、コネクターの履歴でエラーメッセージと実行時間を確認することができます。また、取得するアカウント数やレポートのメトリクス数を減らしたり、取得するタイムフレームを短縮したりすることができます。