アカウント アクティビティの通知が届くようになります。詳細については、プッシュ通知の受信をご覧ください。
HTTP リクエスト
POST https://admin.googleapis.com/admin/reports/v1/activity/users/{userKey or all}/applications/{applicationName}/watch
この 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」 |
リクエスト本文
リクエストの本文には SubscriptionChannel
のインスタンスが含まれています。
レスポンスの本文
リソースの変更を監視するために使用される通知チャンネル。
成功すると、レスポンスの本文に次の構造のデータが含まれます。
JSON 表現 |
---|
{ "id": string, "token": string, "expiration": string, "type": string, "address": string, "payload": boolean, "params": { string: string, ... }, "resourceId": string, "resourceUri": string, "kind": string } |
フィールド | |
---|---|
id |
このチャンネルを識別する UUID または一意の文字列。 |
token |
このチャンネル経由で通知と一緒に対象のアドレスに配布される任意の文字列。省略可。 |
expiration |
通知チャンネルの有効期限。Unix のタイムスタンプでミリ秒単位で表示されます。省略可。 |
type |
このチャンネルで使用される配信方法の種類。値は |
address |
このチャンネルの通知が配信されるアドレス。 |
payload |
ペイロードが必要かどうかを表すブール値。ペイロードは、HTTP POST、PUT、または PATCH メッセージの本文で送信されるデータで、リクエストに関する重要な情報が含まれます。省略可。 |
params |
配信チャンネルの操作を制御する追加のパラメータ。省略可。
|
resourceId |
このチャンネルで監視するリソースを識別する不透明な ID。異なる API バージョンでも安定しています。 |
resourceUri |
監視対象のリソースのバージョン固有の ID。 |
kind |
リソース( |
承認スコープ
次の 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 をご利用のお客様にのみご利用いただけます。 |