はじめに
GoogleのレポートAPIの詳細については、ウェブサイト（ https://developers.google.com/admin-…/v1/reference/ ）を参照してください。 Google Admin SDK Reportsには、Data Centerから接続します。このトピックでは、Google Admin SDK Reportsコネクターユーザーインターフェースに固有のフィールドとメニューについて説明します。DataSetの追加、更新スケジュールの設定、DataSet情報の編集に関する一般的な情報については、「 コネクターを使用してDataSetを追加する 」を参照してください。必要条件
Googleサービスアカウントに接続するには、GoogleサービスアカウントのJSONキーとサービスアカウントのユーザー名が必要です。新しいサービスアカウントとキーを生成するには、次の手順を実行します。
- Google Cloudコンソール にログインします。
- ［APIs & Services］>［Credentials］ をクリックします。
- ［Create Credentials］>［Service account］ をクリックします。
- ［Create service account］ペインで、サービスアカウントの名前と説明を入力し、 ［Create and continue］ をクリックします。
- このサービスアカウントのプロジェクトへのアクセスを許可するには 、 ［Select a role］ ドロップダウン から ［Project］>［Owner］ の順に選択します。
- ［Done］ をクリックします。
- 新しいJSONキーを作成するには、 ［Service accounts］ペイン で3つ並んだ点（展開メニュー）をクリックし、 ［Manage keys］ を選択します
- ［Keys］ セクションで、 ［Add Key］>［Create new key］ の順にクリックします。
- キーのタイプに ［JSON］ を選択し、 ［Create］ をクリックします。
- ［Create］ をクリックします。
サービスキーへのドメイン全体の委任を有効にするには：
- 新規に作成されたサービスアカウントを表から探します。
- サービスアカウントの詳細で、
ドメイン全体の権限をサービスアカウントに委任するには：
Google Workspaceドメインでユーザーデータにアクセスするには、作成したサービスアカウントにそのドメインのスーパー管理者がアクセス権を付与する必要があります。ドメイン全体の委任に関する詳細は、「 APIアクセスをドメイン全体の委任で制御する 」を参照してください。- Google Workspaceドメインの Adminコンソール から、 メインメニュー >［Security］>［API controls］ の順に進みます。
- ［Domain wide delegation］ ペインで、 ［Manage Domain Wide Delegation］ を選択します。
- ［Add new］ をクリックします。
- ［Client ID］ フィールドには、上記のサービスアカウント作成ステップで取得したクライアントIDを入力します。
- ［OAuth Scopes］ フィールドに、アプリケーションに必要なスコープのカンマ区切りのリストを入力します（使用可能なスコープのリストは、「認証要求」を参照してください）。
Google Admin SDK Reportsアカウントに接続する
このセクションでは、Google Admin SDK Reportsコネクターページの ［認証情報］ および ［詳細］ ペインのオプションについて説明します。このページのほかのペインの項目である ［スケジュール設定］ や ［DataSetに名前を付け、説明を入力］ に関しては、ほとんどのタイプのコネクターで共通しています。詳細については「 コネクターを使用してDataSetを追加する 」を参照してください。［認証情報］ペイン
このペインには、Googleサービスアカウントにアクセスするための認証情報を入力するフィールドがあります。下表は、各フィールドに必要な内容を説明しています。フィールド | 説明 |
|---|---|
Service Account Key JSON | GoogleサービスアカウントキーのJSONをコピーして貼り付けます。キーを作成する方法については、上述の「必要条件」を参照してください。 |
Service Account User | サービスアカウントユーザー名を入力します。例： es@xyz.com |
［詳細］ペイン
このペインには、時間枠を選択するためのほかのメニューとともに、メインの ［Reports］ メニューが含まれています。メニュー | 説明 | ||||||||
|---|---|---|---|---|---|---|---|---|---|
Report | 実行するGoogle Admin SDK Reportsレポートを選択します。以下のレポートが利用できます。
| ||||||||
Duration | データを特定の日付について取得するか、日付範囲について取得するかを選択します。 | ||||||||
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日前のデータが含まれます。 |