ドメインのすべてのサービスのすべてのログインを取得するには、次の 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
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 parameterrelational operatorparameter value
次の例は、ドメインの疑わしいログインをすべて取得する方法を示しています。
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/login?eventName=login_success&filters=is_suspicious==true&maxResults=25
[[["わかりやすい","easyToUnderstand","thumb-up"],["問題の解決に役立った","solvedMyProblem","thumb-up"],["その他","otherUp","thumb-up"]],[["必要な情報がない","missingTheInformationINeed","thumb-down"],["複雑すぎる / 手順が多すぎる","tooComplicatedTooManySteps","thumb-down"],["最新ではない","outOfDate","thumb-down"],["翻訳に関する問題","translationIssue","thumb-down"],["サンプル / コードに問題がある","samplesCodeIssue","thumb-down"],["その他","otherDown","thumb-down"]],["最終更新日 2025-08-29 UTC。"],[],[],null,["# Reports API: Login Activity Report\n\nThe login activity report returns information on the login activities of all of\nyour account's users. Each report uses the basic report endpoint request with\nreport-specific parameters such as a user's email. The\nmaximum time period for each report is the last 180 days.\n| **Note:** The login activity report only audits explicit password and SAML-based single sign-on (SSO) logins.\n\nThe login activity report may be used only for lawful purposes in accordance with your Customer Agreement.\n\nRetrieve Google Workspace login events for a domain\n---------------------------------------------------\n\nTo retrieve all logins for all of your domain's services, use the following\n`GET` HTTP request and include the authorization token described in the\n[authorization documentation](https://developers.google.com/workspace/admin/reports/v1/guides/authorizing.html).\nFor more information about the request query strings and response properties,\nsee the [API Reference](/workspace/admin/reports/v1/reference/activity-ref-appendix-a/login-event-names).\nFor readability purposes, the following example is formatted with line returns: \n\n```\nGET https://admin.googleapis.com/admin/reports/v1/activity/users/all\n/applications/login?endTime=end date&startTime=start date\n&maxResults=maximum number of events returned on a response page\n```\n\nThe following example gets a report on all of your account's login events for\nthe past 180 days. The `maxResults` query parameter has this report return\n25 results per page. \n\n```\nGET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/login?maxResults=25\n```\n\nThe following example gets a report on all of a customer's login events for\nthe past 180 days. The `customerId` specifies which customer the report is\nto be retrieved for. \n\n```\nGET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/login?customerId=C03az79cb\n```\n\nRetrieve Google Workspace login events by event name\n----------------------------------------------------\n\nIn some instances, you may want to retrieve specific\n[events](/workspace/admin/reports/v1/reference/activity-ref-appendix-a/login-event-names),\nsuch as suspicious successful logins. To do this, use a `GET` HTTP request of\nthe following form: \n\n```\nGET https://admin.googleapis.com/admin/reports/v1/activity/users/all\n/applications/login?maxResults=maximum number of events returned on a response page\n&eventName=name of the login event\n&filters=event parameter relational operator parameter value\n```\n\nThe following example shows how to retrieve all suspicious successful logins\nfor a domain: \n\n```\nGET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/login?eventName=login_success&filters=is_suspicious==true&maxResults=25\n```"]]
