# tGoogleAnalytics4Report

Google Analytics 4への接続を確立してデータレポートを取得します。

## tGoogleAnalytics4Reportの標準プロパティ

これらのプロパティは、標準ジョブのフレームワークで実行されているtGoogleAnalytics4Reportを設定するために使われます。

標準のtGoogleAnalytics4Reportコンポーネントは、ビジネスファミリーに属しています。

このフレームワーク内のコンポーネントは、すべてのTalend製品で利用できます。

## 基本設定

| プロパティ | 説明 |
| --- | --- |
| プロパティタイプ | 接続の詳細を設定する方法を選択します。<br><br><ul> <li> <p> <span>[Built-In] (組み込み)</span>: このコンポーネントの接続の詳細がローカルに設定されます。関連するすべての接続のプロパティ値を手動で指定する必要があります。</p> </li> <li> <p> <span>[Repository] (リポジトリー)</span>: <span><span>[Repository] (リポジトリー)</span> &gt; <span>[Metadata] (メタデータ)</span></span>で一元的に保存された接続の詳細が、このコンポーネントによって再使用されます。 </p> <p>このチェックボックスの横にある <span>[...]</span> ボタンをクリックし、表示された <span>[Repository Content] (リポジトリーのコンテンツ)</span>ダイアログボックスで、再使用する接続の詳細を選択すると、関連するすべての接続のプロパティに値が自動的に入力されます。</p> </li> </ul> |
| [Schema] (スキーマ)と[Edit schema] (スキーマを編集) | スキーマとは行の説明で、処理された後に次のコンポーネントに渡されるフィールドを定義するものです。<br><br><ul> <li> <p> <span>[Built-in] (組み込み)</span>: そのコンポーネントに対してのみスキーマを作成し、ローカルに保管します。</p> </li> <li> <p> <span>[Repository] (リポジトリー)</span>: スキーマは作成済みで、リポジトリーに保管されています。さまざまなプロジェクトやジョブデザインで再利用できます。</p> </li> </ul><br><br>スキーマを変更するには[Edit schema] (スキーマを編集)をクリックします。変更を加えると、スキーマは自動的に組み込みになります。<br><br><ul> <li> <p> <span>[View schema] (スキーマを表示)</span>: スキーマのみを表示する場合は、このオプションを選択します。</p> </li> <li> <p> <span>[Change to built-in property] (組み込みのプロパティに変更)</span>: ローカルで変更を行うためにスキーマを<span>組み込み</span>に変更する場合は、このオプションを選択します。</p> </li> <li> <p> <span>[Update repository connection] (リポジトリー接続をアップデート)</span>: リポジトリーに保存されているスキーマに変更を加え、変更後にそのコンテンツをすべてのジョブにプロパゲートするかどうかを決める場合は、このオプションを選択します。</p> <p>変更を現在のジョブにのみ反映する場合は、変更後、<span>[No] (いいえ)</span>を選択し、<span>[Repository Content] (リポジトリーコンテンツ)</span>ウィンドウで再びこのスキーマのメタデータを選択します。</p> </li> </ul> |
| [Authentication method] (認証方式) | プロジェクトの認証に使用されるモードを選択します。<br><br><ul> <li> <span>[Service account key] (サービスアカウントキー)</span>: Google Cloud Platformプロジェクトに関連付けられているGoogleアカウントを使って認証します。このモードを選択した場合、定義されるパラメーターは<span>[Google credentials] (Googleクレデンシャル)</span>です。</li> <li> <span>[Application Default Credentials] (アプリケーションのデフォルト認証情報)</span>: アプリケーションのデフォルト認証情報を使って認証します。このモードを選択した場合、アプリケーション環境に基づいて認証情報が自動的に検索されるので、追加のパラメーターを定義する必要はありません。</li> </ul><br><br>Google Cloudの認証プロセスに関する詳細は、[Google Cloudのドキュメンテーション](https://cloud.google.com/docs/authentication/)をご参照ください。 |
| [Google credentials] (Googleクレデンシャル) | サービスアカウントキーが含まれているJSONファイルのコンテンツを貼り付けます。<br><br>このプロパティは、[Service account key] (サービスアカウントキー)を使って認証する場合のみ利用できます。 |
| [Property ID] (プロパティID) | 一意のプロパティIDを選択または入力して、分析データを取得します。詳細は、[Google Analytics 4のドキュメンテーション](https://developers.google.com/analytics/devguides/reporting/data/v1/property-id)をご覧ください。<br><br>情報メモヒント: 使用可能なプロパティIDをすべて表示させる場合は、対応するフィールドの横にある[...]ボタンをクリックして[Retrieve values] (値を取得)ダイアログボックスを開き、[Run in background] (バックグラウンドで実行)をクリックします。新しいダイアログボックスが開き、選択できる取得済みプロパティ識別子がすべて表示されます。 |
| [Start date] (開始日)/[End date] (終了日) | 取得したいレポートに対応する開始日と終了日を選択、または入力します。 |
| [Dimensions] (ディメンション) | 使いたいディメンションの名前を選択、または入力します。<br><br>例: Page title(PageTitle)<br><br>詳細は、[Google Analytics 4 APIのドキュメンテーション](https://developers.google.com/analytics/devguides/reporting/data/v1/rest/v1beta/Dimension)をご覧ください。<br><br>このオプションは、このコンポーネントの出力フローのスキーマに影響します。テーブルでデイメンションを設定した後、[Guess schema] (推測スキーマ)ボタンをクリックしてスキーマをアップデートすることをお勧めします。 |
| [Metrics] (メトリクス) | 使いたいメトリクスの名前を選択、または入力します。<br><br>例: Sessions (sessions)<br><br>詳細は、[Google Analytics 4 APIのドキュメンテーション](https://developers.google.com/analytics/devguides/reporting/data/v1/rest/v1beta/Metric)をご覧ください。<br><br>このオプションは、このコンポーネントの出力フローのスキーマに影響します。テーブルでメトリクスを設定した後、[Guess schema] (推測スキーマ)ボタンをクリックしてスキーマをアップデートすることをお勧めします。 |

## 詳細設定

| プロパティ | 説明 |
| --- | --- |
| [tStatCatcher Statistics] (tStatCatcher統計) | このチェックボックスを選択すると、ジョブレベルおよび各コンポーネントレベルでジョブ処理メタデータが収集されます。 |
| [Read timeout] (読み取りタイムアウト) | 読み取りタイムアウトの値をミリ秒で入力します。読み取る対象のデータが提供される前に待機時間が切れると、例外が発生します。 |
| [Advanced metrics] (詳細メトリクス) | <ul> <li> <span>[Expression] (式)</span>: 使いたいメトリクスに対応する式を選択、または入力します。<p>例: <kbd>eventCount/sessions</kbd> </p> </li> <li> <span>[Name] (名前)</span>: 前に定義された式の名前を指定します。この名前は、フィルターの句でこの式の再利用に役立ちます。<p>例: <kbd>eventCountPerSession</kbd> </p> </li> </ul><br><br>詳細は、[Google Analytics 4 APIのドキュメンテーション](https://developers.google.com/analytics/devguides/reporting/data/v1/rest/v1beta/Metric)をご覧ください。<br><br>このオプションは、このコンポーネントの出力フローのスキーマに影響します。テーブルでメトリクスを設定した後、[Guess schema] (推測スキーマ)ボタンをクリックしてスキーマをアップデートすることをお勧めします。 |
| [Dimension filer clauses] (ディメンションフィルターの句) | JSON形式でカスタムフィルターの句を定義します。この句で前に定義された式名を使用できます。<br><br>詳細は、[Google Analytics 4 APIのドキュメンテーション](https://developers.google.com/analytics/devguides/reporting/data/v1/rest/v1beta/FilterExpression)をご覧ください。 |
| [Metric filter clauses] (メトリックフィルターの句) | JSON形式でカスタムフィルターの句を定義します。この句で前に定義された式名を使用できます。<br><br>詳細は、[Google Analytics 4 APIのドキュメンテーション](https://developers.google.com/analytics/devguides/reporting/data/v1/rest/v1beta/FilterExpression)をご覧ください。 |
| [Keep empty rows] (空白行を保持) | このオプションを有効にすると、メトリック値がゼロである行がレスポンス内に含められます。 |

## グローバル変数

| 変数 | 説明 |
| --- | --- |
| ERROR\_MESSAGE | エラー発生時にコンポーネントによって生成されるエラーメッセージ。これはAfter変数で、文字列を返します。 |

## 使用方法

| 使用方法のガイダンス | 説明 |
| --- | --- |
| 使用ルール | このコンポーネントは、スタンドアロンコンポーネントとして、またはジョブまたはサブジョブの開始コンポーネントとして使用できます。 |