ภาพรวม Reports API
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
Reports API คือ RESTful API ที่คุณสามารถใช้เข้าถึงข้อมูลเกี่ยวกับกิจกรรมใน Google Workspace ของผู้ใช้ได้ Reports API เป็นส่วนหนึ่งของ Admin SDK API
Reports API มีรายงาน 2 ประเภท ได้แก่
- รายงานกิจกรรม ซึ่งรายงานเหตุการณ์สำหรับแอปพลิเคชันหรือบริการที่เฉพาะเจาะจง เช่น Google ไดรฟ์หรือคอนโซลผู้ดูแลระบบ
- รายงานการใช้งาน ซึ่งแสดงเหตุการณ์ในพื้นที่ทํางานที่เกิดจากผู้ใช้
- รายงานการใช้งานของลูกค้าจะแสดงเหตุการณ์สำหรับผู้ใช้ทั้งหมดในโดเมน
- รายงานการใช้งานผู้ใช้จะแสดงเหตุการณ์ที่จัดระเบียบตามผู้ใช้
ต่อไปนี้คือรายการคำศัพท์ทั่วไปที่ใช้ใน Reports API
- รายงานกิจกรรม
รายงานกิจกรรมจะแสดงข้อมูลสำหรับกิจกรรมในแอปพลิเคชันหรือบริการของ Google Workspace
ที่เฉพาะเจาะจง รายงานกิจกรรมประกอบด้วยวันที่ เวลา ผู้ใช้ และประเภท
ของกิจกรรม เอกสารอ้างอิง API
มีรายการรายงานกิจกรรมทั้งหมดและข้อมูลที่รายงานเหล่านั้นรวมอยู่
ตัวอย่างรายงานกิจกรรมบางส่วนที่แสดงตามแอปพลิเคชันหรือบริการมีดังนี้
- รายงานกิจกรรมของผู้ดูแลระบบ
จะแสดงกิจกรรมที่ผู้ดูแลระบบทำโดยใช้คอนโซลผู้ดูแลระบบ เช่น คุณอาจดูรายการเวลาทั้งหมดที่ผู้ดูแลระบบเปลี่ยนชื่อผู้ใช้ได้
โดยใช้คอนโซลผู้ดูแลระบบ
- รายงานกิจกรรมใน Google ไดรฟ์
แสดงวิธีที่ผู้ใช้ในโดเมนแก้ไขและดูเอกสารในไดรฟ์ ตัวอย่างเช่น คุณสามารถดูรายการกิจกรรมของผู้ใช้รายใดรายหนึ่งในไดรฟ์ได้
- รายงานกิจกรรมการเข้าสู่ระบบ
ให้ข้อมูลเกี่ยวกับเวลาที่ผู้ใช้บัญชีของคุณเข้าสู่ระบบและออกจากระบบ
บัญชีของตน เช่น คุณสามารถรับรายงานการเข้าสู่ระบบทั้งหมดสำหรับโดเมนในช่วงระยะเวลาหนึ่งๆ ได้
- รายงานกิจกรรมบนอุปกรณ์เคลื่อนที่
แสดงกิจกรรมที่ใช้อุปกรณ์เคลื่อนที่ซึ่งจัดการโดย
การจัดการอุปกรณ์เคลื่อนที่ของ Google
เช่น คุณจะได้รับการแจ้งเตือนเมื่อผู้ใช้ลงทะเบียนอุปกรณ์ใหม่
- รายงานกิจกรรมโทเค็น OAuth
แสดงเหตุการณ์เมื่อผู้ใช้ให้หรือเพิกถอนโทเค็นการให้สิทธิ์ที่เว็บไซต์และแอปพลิเคชันของบุคคลที่สามใช้
คุณสามารถใช้ Reports API เพื่อดู
รายการการเข้าถึงข้อมูล Google Workspace ของผู้ใช้ทั้งหมดจากบุคคลที่สาม
- รายงานการใช้งาน
รายงานการใช้งานจะให้ข้อมูลเกี่ยวกับเหตุการณ์ใน Google Workspace ในโดเมนของคุณ
คุณสามารถใช้ API เพื่อขอข้อมูลที่เฉพาะเจาะจงเกี่ยวกับผู้ใช้ได้
- รายงานการใช้งานของลูกค้า
แสดงกิจกรรมของแอปพลิเคชันและบริการแบบละเอียดในบัญชี ข้อมูลการใช้งานนี้จัดระเบียบตามประเภทแอปพลิเคชันและมีข้อมูลเฉพาะสำหรับแอปพลิเคชันนั้นๆ
- รายงานการใช้งานของผู้ใช้
แสดงกิจกรรมของผู้ใช้บัญชี คุณปรับแต่งและ
กรองรายงานเหล่านี้เพื่อดูข้อมูลการใช้งานที่เฉพาะเจาะจงได้ ข้อมูลการใช้งานนี้จัดระเบียบ
ตามประเภทแอปพลิเคชันและมีข้อมูลเฉพาะสำหรับแอปพลิเคชันนั้นๆ
- รายงานการใช้งานเอนทิตี
แสดงกิจกรรมที่เกี่ยวข้องกับเอนทิตีที่ผู้ใช้บัญชีของคุณใช้ใน
แอปพลิเคชัน Currents
- การแจ้งเตือน
- Reports API จะส่งการแจ้งเตือนที่ช่วยให้คุณดูเหตุการณ์ต่างๆ เช่น
การเปลี่ยนแปลงทรัพยากร เมื่อคุณดูทรัพยากรและทรัพยากรนั้นมีการเปลี่ยนแปลง
Reports API จะส่งการแจ้งเตือนให้คุณ ดูข้อมูลเพิ่มเติมเกี่ยวกับการตั้งค่าและ
รับการแจ้งเตือนจาก Reports API ได้ที่คู่มือ
การรับการแจ้งเตือนแบบพุช
ขั้นตอนถัดไป
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-08-29 UTC
[null,null,["อัปเดตล่าสุด 2025-08-29 UTC"],[],[],null,["# Reports API Overview\n\nThe Reports API is a RESTful API you can use to access information about the\nGoogle Workspace activities of your users. The Reports API is part of the Admin SDK API.\n\nThe Reports API provides two types of reports:\n\n- **Activity** reports, which report events for a specific application or service, such as Google Drive or the Admin console.\n- **Usage** reports, which list workspace events caused by users.\n - **Customer** usage reports list events for all users in your domain.\n - **User** usage reports list events organized by user.\n\nFollowing is a list of common terms used in the Reports API:\n\n*Activity reports*\n\n: Activity reports list information for activities in a specific Google Workspace\n application or service. Activity reports include the date, time, user, and type\n of activity. The\n [API reference](/workspace/admin/reports/v1/reference)\n contains a complete list of activity reports and the information they include.\n Here are some example activity reports, listed by application or service:\n\n- [Admin activity reports](/workspace/admin/reports/v1/guides/manage-audit-admin) show activities done by administrators using the Admin console. For example, you could get a list of all the times administrators changed a user's name using the Admin console.\n- [Google Drive activity reports](/workspace/admin/reports/v1/guides/manage-audit-drive) list how your domain's users edit and view their Drive documents. For example, you can get a list of a particular user's activity on Drive.\n- [Login activity reports](/workspace/admin/reports/v1/guides/manage-audit-login) provide information on when your account's users log in and out of their accounts. You can, for example, get a report of all the logins for your domain over a particular time period.\n- [Mobile activity reports](/workspace/admin/reports/v1/guides/manage-audit-mobile) show activities using mobile devices managed by [Google Mobile Management](https://workspace.google.com/products/admin/endpoint/). For example, you can get a notification when users register a new device.\n- [OAuth Token activity reports](/workspace/admin/reports/v1/guides/manage-audit-tokens) list events when your users have given or revoked authorization tokens used by third-party websites and applications. You can use the Reports API to get a list of all third-party access to a user's Google Workspace data.\n\n*Usage reports*\n\n: Usage reports provide information about Google Workspace events in your domain.\n You can use the API to request specific information about users.\n\n- [Customers usage reports](/workspace/admin/reports/v1/guides/manage-usage-customers) list detailed application and service activities in your account. This usage information is organized by application type and contains information specific to that application.\n- [Users usage reports](/workspace/admin/reports/v1/guides/manage-usage-users) show activities by your account's users. These reports can be customized and filtered for specific usage information. This usage information is organized by application type and contains information specific to that application.\n- [Entities usage reports](/workspace/admin/reports/v1/guides/manage-usage-entities) list activities related to entities used by your account's users in the Currents application.\n\n*Notifications*\n: The Reports API provides notifications that let you watch for events, such as\n changes to resources. When you're watching a resource and that resource changes,\n the Reports API sends you a notification. For more information on setting up and\n receiving notifications from the Reports API, see the guide to\n [Receiving Push Notifications](/workspace/admin/reports/v1/guides/push).\n\nNext steps\n----------\n\n- To learn about the Reports API and see it work, use a Quickstart,\n which are listed by programming language on the left navigation bar. You can\n also continue through this section to read general information about setting up\n your account.\n\n- The\n [authorization](/workspace/admin/reports/v1/guides/authorizing)\n section shows you how to use OAuth 2.0 access tokens to obtain user data from\n Google Workspace applications and services.\n\n- To find the details of a specific resource type or method, see the\n [API reference](/workspace/admin/reports/v1/reference).\n\n- For more information, see the\n [Admin SDK API issue tracker](https://issuetracker.google.com/savedsearches/566232),\n the\n [Google Workspace Developers blog](https://cloud.google.com/blog/topics/workspace-developers),\n and the\n [Google Workspace Admin help center](https://support.google.com/a)."]]