特定のお客様のアカウントとアプリケーション(管理コンソール アプリケーション、Google ドライブ アプリケーションなど)のアクティビティのリストを取得します。詳しくは、管理者と Google ドライブのアクティビティ レポートに関するガイドをご覧ください。アクティビティ レポートのパラメータについて詳しくは、アクティビティ パラメータ リファレンス ガイドをご覧ください。
HTTP リクエスト
GET https://admin.googleapis.com/admin/reports/v1/activity/users/{userKey or all}/applications/{applicationName}
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ | |
---|---|
userKey or all |
データをフィルタするプロファイル ID またはユーザーのメールアドレスを表します。すべての情報を指定する場合は |
applicationName |
イベントを取得するアプリケーション名。 |
クエリ パラメータ
パラメータ | |
---|---|
actorIpAddress |
イベントが発生したホストのインターネット プロトコル(IP)アドレス。これは、アクティビティが報告されているユーザーの IP アドレスを使用して、レポートの概要をフィルタする追加の方法です。この IP アドレスは、ユーザーの物理的な場所を反映している場合もあれば、そうでない場合もあります。IP アドレスは、ユーザーのプロキシ サーバーのアドレスやバーチャル プライベート ネットワーク(VPN)のアドレスなどです。このパラメータは、IPv4 と IPv6 の両方のアドレス バージョンをサポートしています。 |
customerId |
データを取得する顧客の一意の ID。 |
endTime |
レポートに表示される期間の終了を設定します。日付は RFC 3339 形式で指定します(例: 2010-10-28T10:26:35.000Z)。デフォルト値は、API リクエストのおおよその時刻です。API レポートには、3 つの基本的な時間のコンセプトがあります。
endTime が指定されていない場合、レポートは startTime から現在の時刻までのすべてのアクティビティを返します。startTime が 180 日以上前の場合は直近の 180 日間のアクティビティを返します。
|
eventName |
API によってクエリされるイベントの名前。各 |
filters |
これらのイベント パラメータは、特定の 次のドライブ アクティビティの例では、
注: この API では、同じパラメータに複数の値を指定することはできません。API リクエストでパラメータが複数回指定された場合、API はそのパラメータの最後の値のみを受け入れます。また、API リクエストで無効なパラメータが指定された場合、API はそのパラメータを無視し、残りの有効なパラメータに対応するレスポンスを返します。パラメータがリクエストされていない場合は、すべてのパラメータが返されます。 |
maxResults |
各応答ページに表示されるアクティビティ レコードの数を指定します。たとえば、リクエストで |
orgUnitID |
レポートの対象となる組織部門の ID。アクティビティ記録は、指定した組織部門に所属するユーザーにのみ表示されます。 |
pageToken |
次のページを指定するトークン。複数のページを含むレポートのレスポンスには |
startTime |
レポートに表示される期間の開始点を設定します。日付は RFC 3339 形式で指定します(例: 2010-10-28T10:26:35.000Z)。このレポートは、 |
groupIdFilter |
ユーザー アクティビティがフィルタされる、カンマ区切りのグループ ID(難読化済み)。つまり、レスポンスには、ここで説明したグループ ID の少なくとも 1 つに含まれるユーザーのアクティビティのみが含まれます。形式: 「id:abc123,id:xyz456」 |
リクエスト本文
リクエストの本文は空にする必要があります。
レスポンスの本文
アクティビティのコレクションの JSON テンプレート。
成功すると、レスポンスの本文に次の構造のデータが含まれます。
JSON 表現 |
---|
{
"kind": string,
"etag": string,
"items": [
{
object ( |
フィールド | |
---|---|
kind |
API リソースのタイプ。アクティビティ レポートの場合、値は |
etag |
リソースの ETag。 |
items[] |
各アクティビティはレスポンスに記録されます。 |
nextPageToken |
レポートの次のページを取得するためのトークン。 |
承認スコープ
次の OAuth スコープが必要です。
https://www.googleapis.com/auth/admin.reports.audit.readonly
詳しくは、承認ガイドをご覧ください。
ApplicationName
列挙型 | |
---|---|
access_transparency |
Google Workspace のアクセスの透明性に関するアクティビティ レポートは、さまざまな種類のアクセスの透明性に関するアクティビティ イベントに関する情報を返します。 |
admin |
管理コンソール アプリケーションのアクティビティ レポートには、さまざまな種類の管理者アクティビティ イベントに関するアカウント情報が表示されます。 |
calendar |
Google カレンダー アプリケーションのアクティビティ レポートでは、さまざまなカレンダーの予定に関する情報が返されます。 |
chat |
Chat アクティビティ レポートでは、さまざまな Chat アクティビティ イベントに関する情報が返されます。 |
drive |
Google ドライブ アプリケーションのアクティビティ レポートでは、さまざまな Google ドライブのアクティビティ イベントに関する情報が返されます。ドライブのアクティビティ レポートは、Google Workspace Business と Google Workspace Enterprise をご利用のお客様にのみご利用いただけます。 |
gcp |
Google Cloud Platform アプリケーションのアクティビティ レポートは、さまざまな GCP アクティビティ イベントに関する情報を返します。 |
gplus |
Google+ アプリケーションのアクティビティ レポートでは、さまざまな Google+ アクティビティ イベントに関する情報が返されます。 |
groups |
Google グループ アプリケーションのアクティビティ レポートでは、さまざまなグループのアクティビティ イベントに関する情報が返されます。 |
groups_enterprise |
企業グループのアクティビティ レポートには、さまざまな 企業グループのアクティビティ イベントに関する情報が返されます。 |
jamboard |
Jamboard アクティビティ レポートでは、さまざまな Jamboard アクティビティ イベントに関する情報が返されます。 |
login |
ログイン アプリケーションのアクティビティ レポートでは、ログイン アクティビティ イベントの種類に関するアカウント情報が返されます。 |
meet |
Meet 監査アクティビティ レポートでは、さまざまな種類の Meet 監査アクティビティ イベントに関する情報が返されます。 |
mobile |
デバイス監査アクティビティ レポートでは、さまざまな種類のデバイス監査アクティビティ イベントに関する情報が返されます。 |
rules |
ルール アクティビティ レポートでは、さまざまな種類のルール アクティビティ イベントに関する情報が返されます。 |
saml |
SAML アクティビティ レポートには、さまざまな種類の SAML アクティビティ イベントに関する情報が表示されます。 |
token |
トークン アプリケーションのアクティビティ レポートは、さまざまなタイプのトークン アクティビティ イベントに関するアカウント情報を返します。 |
user_accounts |
ユーザー アカウント アプリケーションのアクティビティ レポートでは、さまざまな種類のユーザー アカウントのアクティビティ イベントに関するアカウント情報が返されます。 |
context_aware_access |
コンテキストアウェア アクセスのアクティビティ レポートは、 コンテキストアウェア アクセス ルールによりユーザーのアクセス拒否イベントに関する情報を返します。 |
chrome |
Chrome アクティビティ レポートでは、 Chrome ブラウザと ChromeOS のイベントに関する情報が返されます。 |
data_studio |
データポータルのアクティビティ レポートでは、さまざまな種類のデータポータル アクティビティ イベントに関する情報が返されます。 |
keep |
Keep アプリケーションのアクティビティ レポートでは、さまざまな Google Keep アクティビティ イベントに関する情報が返されます。Keep アクティビティ レポートは、Google Workspace Business と Google Workspace Enterprise をご利用のお客様にのみご利用いただけます。 |
vault |
Vault アクティビティ レポートでは、さまざまな種類の Vault アクティビティ イベントに関する情報が返されます。 |
アクティビティ
アクティビティ リソースの JSON テンプレート。
JSON 表現 |
---|
{ "kind": string, "etag": string, "ownerDomain": string, "ipAddress": string, "events": [ { "type": string, "name": string, "parameters": [ { "messageValue": { "parameter": [ { object ( |
フィールド | |
---|---|
kind |
API リソースのタイプ。アクティビティ レポートの場合、値は |
etag |
エントリの ETag。 |
ownerDomain |
レポートのイベントによって影響を受けるドメインです。(管理コンソールのドメイン、ドライブ アプリケーションのドキュメント オーナーなど)。 |
ipAddress |
操作を行ったユーザーの IP アドレス。これは、ユーザーが Google Workspace にログインする際のインターネット プロトコル(IP)アドレスです。ユーザーの物理的な場所を反映する場合もあれば、そうでない場合もあります。IP アドレスは、ユーザーのプロキシ サーバーのアドレスやバーチャル プライベート ネットワーク(VPN)のアドレスなどです。API は IPv4 と IPv6 をサポートしています。 |
events[] |
レポート内のアクティビティ イベント。 |
events[].type |
イベントのタイプ。管理者が変更する Google Workspace のサービスまたは機能は、 |
events[].name |
イベントの名前。これは、API によって報告されるアクティビティの具体的な名前です。各
eventName プロパティについて詳しくは、上記の applicationName で各種アプリケーションのイベント名の一覧をご覧ください。
|
events[].parameters[] |
さまざまな用途に対応するパラメータ値のペア。 |
events[].parameters[].messageValue |
このパラメータに関連付けられているネストされたパラメータ値のペア。パラメータの複合値の型は、パラメータ値のリストとして返されます。たとえば、アドレス パラメータの値は |
events[].parameters[].messageValue.parameter[] |
パラメータの値 |
events[].parameters[].name |
パラメータの名前。 |
events[].parameters[].value |
パラメータの文字列値。 |
events[].parameters[].multiValue[] |
パラメータの文字列値。 |
events[].parameters[].intValue |
パラメータの整数値。 |
events[].parameters[].multiIntValue[] |
パラメータの整数値。 |
events[].parameters[].boolValue |
パラメータのブール値。 |
events[].parameters[].multiMessageValue[] |
|
events[].parameters[].multiMessageValue[].parameter[] |
パラメータの値 |
id |
各アクティビティ記録の一意の識別子。 |
id.time |
アクティビティの発生時刻。秒単位の UNIX エポックタイムです。 |
id.uniqueQualifier |
複数のイベントが同じ時間を持つ場合は一意の修飾子。 |
id.applicationName |
イベントが属するアプリケーション名。有効な値については、上記の |
id.customerId |
Google Workspace アカウントの一意の識別子。 |
actor |
アクションを行っているユーザー。 |
actor.profileId |
アクターの一意の Google Workspace プロフィール ID。この値は、アクターが Google Workspace ユーザーでない場合、またはプレースホルダ ID として機能する番号 105250506097979753968 である可能性があります。 |
actor.email |
アクターのメイン メールアドレス。アクターに関連付けられたメールアドレスがない場合は存在しない可能性があります。 |
actor.callerType |
俳優のタイプ。 |
actor.key |
|