デバイス監査アクティビティ レポートは、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