รายงานการใช้งานของลูกค้าจะรวบรวมข้อมูลการใช้บริการ Google Workspace ของผู้ใช้ทุกคนทั่วทั้งโดเมน รายงานการใช้งานของผู้ใช้จะแสดงข้อมูลการใช้บริการ Google Workspace ทั่วทั้งบัญชีของคุณ ข้อมูลการใช้งานนี้จัดเรียงตามประเภทแอปพลิเคชัน ซึ่งประกอบด้วยพารามิเตอร์เฉพาะสำหรับแอปพลิเคชันนั้นๆ ช่วงเวลาเริ่มต้นและระยะเวลาสูงสุดสำหรับแต่ละรายงานคือ 450 วันที่ผ่านมา
รายงานการใช้งานเหล่านี้จะใช้เพื่อวัตถุประสงค์ทางกฎหมายตามข้อตกลงของลูกค้าเท่านั้น นอกจากนี้ รายงานเหล่านี้ยังมีผลกับ Google Workspace และ Education อีกด้วย
เรียกดูรายงานการใช้งานของลูกค้า
หากต้องการดึงรายงานกิจกรรมของบัญชี ให้ใช้คำขอ HTTP GET
ต่อไปนี้และรวมโทเค็นการให้สิทธิ์ที่อธิบายไว้ในเอกสารประกอบการให้สิทธิ์ ตัวอย่างต่อไปนี้จะมีการจัดรูปแบบด้วยการขึ้นบรรทัดใหม่เพื่อให้อ่านง่าย
GET https://admin.googleapis.com/admin/reports/v1/usage/dates/yyyy-mm-dd date ?parameters=app name: usage parameter,... &customerId=the customer's ID &maxResults=number of events listed on each page of the report
ค่า dates
คือวันที่การใช้งานที่เกิดขึ้นและการประทับเวลาอยู่ในรูปแบบ ISO 8601 ในรูปแบบ yyyy-mm-dd เราขอแนะนำให้คุณใช้เขตเวลาของบัญชีของคุณสำหรับการดำเนินการนี้ โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับสตริงการค้นหาและพร็อพเพอร์ตี้การตอบกลับของคำขอได้ที่ข้อมูลอ้างอิง API และข้อมูลอ้างอิงพารามิเตอร์รายงานการใช้งานของลูกค้า
ตัวอย่างต่อไปนี้จะได้รับรายงานที่มียอดรวมของการลงชื่อเข้าใช้บัญชีที่สำเร็จทั้งหมดในช่วง 30 วันที่ผ่านมาและรายการแอปพลิเคชันที่ได้รับอนุญาต พร้อมจำนวนการให้สิทธิ์ผู้ใช้ต่อแอปพลิเคชัน โดยเริ่มตั้งแต่วันที่ 03-03-2013 สตริงการค้นหา maxResults
จะแสดงรายงานนี้แสดงเหตุการณ์ 2 รายการต่อหน้ารายงาน
GET https://admin.googleapis.com/admin/reports/v1/usage/dates/2013-03-03 ?parameters=accounts:num_30day_logins%2Caccounts:authorized_apps&maxResults=2
การตอบกลับ JSON สำหรับรายงานการใช้งานของลูกค้า
{ "kind": "reports#usageReports", "warnings": [ { "code": warning machine-readable code, "message": warning human-readable message, "data": [ { "key": key for key-value pair that gives detailed warning information, "value": value for key-value pair giving detailed warning information } ] } ], "nextPageToken": "N:NNN:NNN:N:C03az79cb", "usageReports": [ { "kind": "usageReport", "date": "2013-03-03", "entity": { "type": "CUSTOMER", "customerId": "C03az79cb" }, "parameters": [ { "name": "accounts:num_1day_logins", "intValue": "1" }, { "name": "accounts:num_30day_logins", "intValue": "1" }, { "name": "accounts:num_7day_logins", "intValue": "1" }, { "name": "accounts:num_disabled_accounts", "intValue": "5" }, { "name": "accounts:authorized_apps", "msgValue": [ { "client_id": "1234.apps.googleusercontent.com", "client_name": "www.example.com", "num_users": 2 }, { "client_id": "4567.apps.googleusercontent.com", "client_name": "Example", "num_users": 1 }, ... ] } ] } ] }