ログイン アクティビティ レポートでは、すべてのログイン アクティビティに関する情報が 影響します各レポートでは、次を含む基本レポート エンドポイント リクエストが使用されます。 ユーザーのメールアドレスなど、レポート固有のパラメータを含めることができます。「 各レポートの最大期間は過去 180 日間です。
ログイン アクティビティ レポートは、顧客契約に従い、合法的な目的のみに使用することができます。
ドメインの Google Workspace ログイン イベントを取得する
ドメインのすべてのサービスのすべてのログインを取得するには、次のように記述します。
GET HTTP リクエストを作成し、次で説明されている認証トークンを含めます。
承認に関するドキュメントをご覧ください。
リクエストのクエリ文字列とレスポンスのプロパティについて詳しくは、
API リファレンスをご覧ください。
次の例では、読みやすくするために改行を挿入しています。
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/login?endTime=end date&startTime=start date &maxResults=maximum number of events returned on a response page
次の例では、
過去 180 日間ですこのレポートは maxResults クエリ パラメータに返されます。
1 ページあたり 25 件の結果。
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/login?maxResults=25
次の例では、顧客のすべてのログイン イベントに関するレポートを取得します。
過去 180 日間ですcustomerId は、レポートの対象となる顧客を指定します。
指定します。
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/login?customerId=C03az79cb
イベント名で Google Workspace のログイン イベントを取得する
場合によっては、特定のサービス アカウントを
イベント
不審なログインなどを検出できます。これを行うには、次の GET HTTP リクエストを使用します。
次の形式にします。
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/login?maxResults=maximum number of events returned on a response page &eventName=name of the login event &filters=event parameter relational operator parameter value
次の例は、成功したすべての不審なログインを取得する方法を示しています。 ドメインの場合:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/login?eventName=login_success&filters=is_suspicious==true&maxResults=25