ログイン アクティビティ レポートには、アカウントのすべてのユーザーのログイン アクティビティに関する情報が返されます。各レポートでは、ユーザーのメールアドレスなどのレポート固有のパラメータを含む基本レポート エンドポイント リクエストが使用されます。各レポートの最長期間は過去 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
クエリ パラメータでは、このレポートでページあたり 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