Reports API: デバイス監査アクティビティ レポート

デバイス監査アクティビティ レポートでは、すべてのユーザーによるアクティビティに関する情報が デバイスは Google エンドポイント管理。 各レポートでは、基本レポート エンドポイント リクエストとレポート固有のエンドポイント リクエストが使用されます。 パラメータ(ユーザーのメールアドレスなど)です。各レポートの最大期間は 過去 180 日間です

デバイス監査アクティビティ レポートは、 。詳しくは、 Google Workspace の各エディションの比較 で、これらのレポートがどのエディションに含まれているかをご確認ください。

ドメインのデバイス監査イベントを取得する

ドメイン内の全ユーザーのすべてのデバイス監査イベントを取得するには、 次の GET HTTP リクエストに追加し、次で説明されている認証トークンを含めます。 承認に関するドキュメントをご覧ください。 リクエストのクエリ文字列とレスポンスのプロパティについて詳しくは、 デバイス監査アクティビティ イベント。 次の例では、読みやすくするために改行を挿入しています。

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/mobile?endTime=end date&startTime=start date
&maxResults=maximum number of events returned on a response page

次の例では、アカウントのすべてのデバイス監査イベントに関するレポートを取得しています 過去 180 日間のデータを表示できますmaxResults クエリ パラメータは、インスタンスごとに 25 件の結果を返します。 できます。

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/mobile?maxResults=25

次の例では、過去 180 回のすべてのデバイス監査イベントのレポートを取得します 日customerId には、取得する顧客のレポートを指定します。

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/mobile?customerId=C03az79cb

イベント名でデバイス監査イベントを取得する

場合によっては、特定のサービス アカウントを イベント 検出するように設計されています。これを行うには、GET HTTP リクエストを 次の形式にします。

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/mobile?maxResults=maximum number of events returned on a response page
&eventName=name of the event
&filters=event parameter relational operator parameter value

次の例は、すべての不審なアクティビティ イベントを取得する方法を示しています。 ドメイン内の Android ユーザー:

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/mobile?eventName=SUSPICIOUS_ACTIVITY_EVENT&filters=DEVICE_TYPE==ANDROID&maxResults=25