> ## Documentation Index
> Fetch the complete documentation index at: https://domoinc-openapi-sync-dataflows.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# YouTube Reportingコネクター

## はじめに

YouTube Reportingは定義済みレポートとジョブレポートをサポートしています。これには、チャンネルまたはコンテンツの所有者向けの総合的なYouTube Analyticsのデータのセットなどが含まれます。DomoのYoutube Reportingコネクターを使用すると、YouTube Analytics APIでクエリできる一括データセットをダウンロードすることができます。YouTube APIについての詳細は、ウェブサイト（ [https://developers.google.com/youtube/analytics/](https://developers.google.com/youtube/analytics/ "https://developers.google.com/youtube/analytics/") ）を参照してください。

<Note>
  **注記：** Domoでは現在、5つのYouTubeコネクターを利用できます。これら5つのコネクターの違いを理解するのは難しい場合があるため、以下にそれぞれの説明を示します。

  * **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でパーティショニングを使用できます。
</Note>

YouTubeレポートアカウントには、Data Centerから接続します。このトピックでは、YouTube Reportingコネクターのユーザーインターフェースに固有のフィールドとメニューについて説明します。DataSetの追加や更新スケジュールの設定、DataSet情報の編集に関する一般的な情報については、「 [コネクターを使用してDataSetを追加する](/ja/s/article/360042926274 "コネクターを使用してDataSetを追加する") 」を参照してください。

<Note>
  **注記：** このコネクターを使用してレポートを作成するとジョブが生成され、24時間後にデータを返します。
</Note>

|                               |                                                                                                                                                         |
| :---------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **主な使用事例**                    | チャンネル、デバイス、場所から動画メトリクスをすべて取得することで、ユーザーがYouTubeでどのように動画コンテンツを利用しているのか理解することができます。                                                                        |
| **主なメトリクス**                   | <ul><li>閲覧数</li><li>閲覧合計時間（分）</li><li>ステータスが赤の閲覧数</li><li>ステータスが赤の閲覧合計時間（分）</li><li>いいね！/よくないね！ヤダネ！の数</li><li>コメント数</li><li>共有数</li><li>クリック数</li></ul> |
| **社内における主な権限**                | <ul><li>コンテンツ作成者</li><li>デジタルアセットマネージャー</li><li>デジタルマーケター</li><li>コンテンツアセットマネージャー</li></ul>                                                             |
| **平均導入時間**                    | すぐに使用可能な標準レポートのみを取得する場合、2時間以内にレポートを作成して実行することができます。180日を超える履歴が必要な場合や、数百万に及ぶ行を取得する場合、実装に最大30時間かかることがあります。                                                |
| **使いやすさ（1～10段階。1が「最も使いやすい」）** | 5                                                                                                                                                       |

## ベストプラクティス

* チャンネルのメトリクスを取得するには、入力された認証情報の所有者がそのチャンネルの所有者である必要があります。
* コンテンツマネージャーを使用しているか、「コンテンツの所有者に代わって」メトリクスを取得している場合は、YouTube Reporting Enterpriseコネクターを使用する必要があります。これにより、自分が所有者ではないチャンネルのメトリクスを取得することができます。また、YouTubeは特定のアクティビティに関する任意のレポートのメトリクスを最大30日間更新できます。少なくとも35日間の履歴を置き換えるようにコネクターを設定することをお勧めします。180日間以上の履歴を作成する場合は再帰的なDataFlowを設定し、情報を取得していく必要があります。詳細については、「
  [再帰的/スナップショットの古いMagic ETL DataFlowを作成する](/ja/s/article/360043428113 "再帰的/スナップショットのMagic ETL DataFlowを作成する") 」を参照してください。
* データが更新されるのは1日に1回なので、DataSetは24時間に1回だけ実行します。
* このコネクターを最初に作成すると、「定義済みレポート」の取得を選択できます。これらのレポートは、提供されているYouTubeチャンネルに関する分析データの取得に使用します。初めてレポートを選択したとき（つまり、このレポートを使用する最初のDataSetに対し）、DomoはYouTubeレポートジョブを作成します。その日以前のすべてのデータは「履歴データ」と見なされます。YouTubeは30日分の履歴データのみを返します。例えば、最初の「デバイスとOS」レポートのDataSetが8月31日に作成された場合、利用できるのは8月1日以降のデータのみです。この履歴データは通常、DataSetの作成から数日後に利用できます。毎日、2日前のデータが利用可能になります。上記の例では、8月31日のデータは9月2日に、9月1日のデータは9月3日に利用できることになります。9月末には、このDataSetには2ヶ月分のデータ（8月のデータと9月のデータ）が含まれることになります。ただし、履歴データを利用できるのは30日間のみです。つまり、10月頃になると8月のデータはYouTubeから利用できなくなります。一方、DataSet作成後（つまり8月31日以降）の全データはYouTubeで60日間利用できます。

## 必要条件

YouTubeアカウントに接続してDataSetを作成するには、Googleのメールアドレスとパスワードが必要になります。

## YouTube Reportingアカウントに接続する

このセクションでは、YouTube Reportingコネクターページの **［認証情報］** および **［詳細］** ペインのオプションについて説明します。このページのほかのペインの項目である **［スケジュール設定］** や **［DataSetに名前を付け、説明を入力］ に関しては、** ほとんどのタイプのコネクターで共通しています。詳細については、「 [コネクターを使用してDataSetを追加する](/ja/s/article/360042926274 "コネクターを使用してDataSetを追加する") 」を参照してください。

### ［認証情報］ペイン

DomoのYouTube Reportingコネクターは、接続にOAuthを使用します。そのため、Domo内での認証情報の入力は必要ありません。 **［接続］** をクリック（または、Domoに既存のYouTube Reportingアカウントがある場合は **［アカウントを追加］** を選択）すると、YouTubeレポートOAuth画面が開き、Googleの認証情報を入力できます。有効なGoogleの認証情報を一度入力しておくと、随時同じアカウントを使用して新しいYouTubeレポートDataSetを作成できます。コネクターアカウントは、 Data Center の **［アカウント］** タブで管理できます。このタブの詳細については、「 [コネクターのユーザーアカウントを管理する](/ja/s/article/360042926054 "コネクターのユーザーアカウントを管理する") 」を参照してください。

<Note>
  **注記：** Domoで接続する際、既にGoogleにログインしている場合は、 **［アカウントを追加］** をクリックすると自動的に認証されます。ログインしているアカウントとは異なるアカウントに接続する場合は、まずGoogleアカウントからログアウトする必要があります。
</Note>

### ［詳細］ペイン

このペインには、ジョブレポートまたは定義済みレポートを選択できるメインの **［Reports］** メニューが含まれています。定義済みレポートを選択すると、選択した設定オプションに応じて、ほかのメニューが表示される場合があります。

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:207;a"><thead><tr><th colspan="1" rowspan="1"><p> メニュー </p></th><th colspan="1" rowspan="1"><p> 説明 </p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p> Report </p></td><td colspan="1" rowspan="1"><p> 実行するYouTubeレポートを選択します。以下のレポートが利用できます。 </p><table border="1" cellpadding="1" cellspacing="1"><tbody><tr><td colspan="1" rowspan="1"> Jobs </td><td colspan="1" rowspan="1"> チャンネルまたはコンテンツの所有者にスケジュールされたレポートジョブのリストを返します。 </td></tr><tr><td colspan="1" rowspan="1"> Video and Channel Names </td><td colspan="1" rowspan="1"> アカウントのすべての動画とチャンネルの名前を返します。 </td></tr><tr><td colspan="1" rowspan="1"> Predefined Report </td><td colspan="1" rowspan="1"> 定義済みレポートタイプを返します。 </td></tr></tbody></table></td></tr><tr><td colspan="1" rowspan="1"> Call on Behalf of Content Owner </td><td colspan="1" rowspan="1"> 別のユーザー（ <b> ［Content Owner ID］ </b> フィールドに入力するユーザーのID）の定義済みレポートを取得する場合は、 <b> ［Yes］ </b> を選択します。取得するレポートのコンテンツ所有者である場合は、 <b> ［No］ </b> を選択します。 </td></tr><tr><td colspan="1" rowspan="1"> Content Owner ID </td><td colspan="1" rowspan="1"><p> 取得対象のコンテンツを持つユーザーのコンテンツ所有者IDを入力します。コンテンツ所有者のIDを確認するには、MCN（マルチチャネルネットワーク）のメンバーである必要があります。詳細は、 <a href="https://support.google.com/youtube/answer/2737059?hl=en" target="_blank"> [https://support.google.com/youtube/answer/2737059?hl=ja](https://support.google.com/youtube/answer/2737059?hl=ja) </a> を参照してください。 </p><p> コンテンツ所有者のIDを確認するには、以下を実行します。 </p><ol><li><p> YouTubeにログインします。 </p></li><li><p> 右上のプロフィール写真をクリックします。 </p></li><li><p> ドロップダウンメニューで <b> ［Studio］ </b> を選択します。 </p></li><li><p> ページのURLの <span class="mt-font-courier-new"> o= </span> に続く部分をコピーします。 </p></li></ol><p> 例えば、ページのURLが <span class="nowiki"><span class="mt-font-courier-new"><a href="https://www.youtube.com/dashboard?o=abc123_qrs_654" rel="noopener" target="_blank"> [https://www.youtube.com/dashboard?o=abc123\_qrs\_654](https://www.youtube.com/dashboard?o=abc123_qrs_654) </a></span></span> である場合、コンテンツ所有者のIDは <span class="nowiki"><span class="mt-font-courier-new"> abc123\_qrs\_654 </span> になります。 </span></p></td></tr><tr><td colspan="1" rowspan="1"> Report Types </td><td colspan="1" rowspan="1"><p> 実行する定義済みレポートを選択します。利用可能なレポートのリストは、何を表示する権限があるかによって決まります。そのため、このコネクターのレポートについてはここでは説明しません。 </p></td></tr><tr><td colspan="1" rowspan="1"> Retrieve Video and Channel Names </td><td colspan="1" rowspan="1"> IDが存在する場合に動画名やチャンネル名をレポートが返すようにする場合は、 <b> ［True］ </b> を選択します。その他の場合は、 <b> ［False］ </b> を選択します。 </td></tr><tr><td colspan="1" rowspan="1"><p> Duration </p></td><td colspan="1" rowspan="1"><p> データを特定の日付について取得するか、日付範囲について取得するかを選択します。 </p></td></tr><tr><td colspan="1" rowspan="1"><p> Report Date </p></td><td colspan="1" rowspan="1"><p> レポートのデータが特定の日付のものか、今日から何日か前までのものかを選択します。 </p></td></tr><tr><td colspan="1" rowspan="1"><p> Select Specific Date </p></td><td colspan="1" rowspan="1"><p> レポートの日付を選択します。 </p></td></tr><tr><td colspan="1" rowspan="1"><p> Days Back </p></td><td colspan="1" rowspan="1"><p> レポートに表示する過去日数を入力します。 </p></td></tr><tr><td colspan="1" rowspan="1"><p> Start Date </p></td><td colspan="1" rowspan="1"><p> 日付範囲の最初の日付が特定の日付なのか、相対的な日付なのかを指定します。範囲の最後の日付は、 <b> ［End Date］ </b> で選択します。 </p></td></tr><tr><td colspan="1" rowspan="1"><p> End Date </p></td><td colspan="1" rowspan="1"><p> 日付範囲の2番目の日付が特定の日付なのか、相対的な日付なのかを指定します。日付範囲の最初の日付は <b> ［Start Date］ </b> で選択します。 </p></td></tr><tr><td colspan="1" rowspan="1"><p> Select Specific Start Date </p></td><td colspan="1" rowspan="1"><p> 日付範囲の最初の日付を選択します。 </p></td></tr><tr><td colspan="1" rowspan="1"><p> Select Specific End Date </p></td><td colspan="1" rowspan="1"><p> 日付範囲の2番目の日付を選択します。 </p></td></tr><tr><td colspan="1" rowspan="1"><p> Days Back to Start From </p></td><td colspan="1" rowspan="1"><p> レポートで表示する過去の日のうち、現在から最も遠い日までの日数を入力します。 <b> ［Days Back to End At］ </b> と組み合わせることによって、表示日数の範囲を指定できます。 </p><p> 例えば、 <b> ［Days Back to Start From］ </b> に「 <span class="mt-font-courier-new"> 10 </span> 」、 <b> ［Days Back to End At］ </b> に「 <span class="mt-font-courier-new"> 5 </span> 」を入力した場合、レポートには、今日から数えて10日前から5日前のデータが含まれます。 </p></td></tr><tr><td colspan="1" rowspan="1"><p> Days Back to End At </p></td><td colspan="1" rowspan="1"><p> レポートで表示する過去の日のうち、現在から最も近い日までの日数を入力します。 <b> ［Days Back to Start From］ </b> と組み合わせることによって、表示日数の範囲を指定できます。 </p><p> 例えば、 <b> ［Days Back to Start From］ </b> に「 <span class="mt-font-courier-new"> 10 </span> 」、 <b> ［Days Back to End At］ </b> に「 <span class="mt-font-courier-new"> 5 </span> 」を入力した場合、レポートには、今日から数えて10日前から5日前のデータが含まれます。 </p></td></tr></tbody></table>

### その他のペイン

スケジュール設定、再試行、更新オプションの設定方法など、コネクターインターフェースのその他のセクションについては、「 [コネクターを使用してDataSetを追加する](/ja/s/article/360042926274 "コネクターを使用してDataSetを追加する") 」を参照してください。

## トラブルシューティング

YouTubeでは、特定のレポートを初めて設定する際、30日分の履歴しか取得できません。初めてレポートを実行すると、データが利用可能になるまでに24～48時間かかる場合があります。また、YouTubeがレポートのメトリクスを更新できるのは、履歴データ（特定のレポートを初めて使用する前の日数のデータ）の場合は最大30日間、非履歴データの場合は最大60日間です。
