Reports API: ログイン アクティビティ レポート

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