Reports API：裝置稽核活動報告
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
裝置稽核活動報表會傳回 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
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2025-08-29 (世界標準時間)。
[null,null,["上次更新時間：2025-08-29 (世界標準時間)。"],[],[],null,["# Reports API: Device Audit Activity Report\n\nThe device audit activity report returns information on activities by all\ndevices under\n[Google endpoint management](https://support.google.com/a/answer/1734200).\nEach report uses the basic report endpoint request with report-specific\nparameters such as a user's email. The maximum time period for each report is\nthe last 180 days.\n\nThe device audit activity report may be used only for lawful purposes in\naccordance with your Customer Agreement. See\n[Compare Google Workspace editions](https://support.google.com/a/answer/6043385#reports)\nto find which editions include these reports.\n\nRetrieve device audit events for a domain\n-----------------------------------------\n\nTo retrieve all device audit events for all users within your domain, use the\nfollowing `GET` HTTP request and include the authorization token described in the\n[authorization documentation](/workspace/admin/reports/v1/guides/authorizing).\nFor more information about the request query strings and response properties,\nsee\n[Device Audit Activity Events](/workspace/admin/reports/v1/appendix/activity/mobile).\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/mobile?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 device audit events\nfor the past 180 days. The `maxResults` query parameter returns 25 results per\npage. \n\n```\nGET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/mobile?maxResults=25\n```\n\nThe following example gets a report on all device audit events for the past 180\ndays. The `customerId` specifies which customer's report is retrieved. \n\n```\nGET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/mobile?customerId=C03az79cb\n```\n\nRetrieve device audit events by event name\n------------------------------------------\n\nIn some instances, you may want to retrieve specific\n[events](/workspace/admin/reports/v1/appendix/activity/mobile),\nsuch as suspicious activity events. To do this, use a `GET` HTTP request in\nthe following form: \n\n```\nGET https://admin.googleapis.com/admin/reports/v1/activity/users/all\n/applications/mobile?maxResults=maximum number of events returned on a response page\n&eventName=name of the event\n&filters=event parameter relational operator parameter value\n```\n\nThe following example shows how to retrieve all suspicious activity events for\nAndroid users within the domain: \n\n```\nGET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/mobile?eventName=SUSPICIOUS_ACTIVITY_EVENT&filters=DEVICE_TYPE==ANDROID&maxResults=25\n```"]]
