รายงานการใช้งานของผู้ใช้จะแสดงข้อมูลการใช้บริการ Google Workspace ของผู้ใช้บางรายในโดเมนของคุณ รายงานเหล่านี้สามารถปรับแต่งและกรองข้อมูลสำหรับการใช้งานที่เฉพาะเจาะจง ระยะเวลาเริ่มต้นและระยะเวลาสูงสุดสำหรับแต่ละรายงานคือ 450 วันที่ผ่านมา
รายงานการใช้งานของผู้ใช้เหล่านี้สามารถใช้เพื่อวัตถุประสงค์ที่ชอบด้วยกฎหมายตามข้อตกลงของลูกค้าของคุณเท่านั้น นอกจากนี้ รายงานเหล่านี้ยังใช้ได้กับ Google Workspace และ Education
ดึงข้อมูลกิจกรรมการใช้งานของผู้ใช้ทั้งหมด
หากต้องการเรียกดูรายงานกิจกรรมของผู้ใช้ทั้งหมดในบัญชี ให้ใช้คำขอ HTTP GET ต่อไปนี้และรวมโทเค็นการให้สิทธิ์ที่อธิบายไว้ในเอกสารการให้สิทธิ์ ตัวอย่างต่อไปนี้จัดรูปแบบด้วยการขึ้นบรรทัดใหม่เพื่อให้อ่านง่ายขึ้น
GET https://admin.googleapis.com/admin/reports/v1/usage/users/all/dates/yyyy-mm-dd date ?parameters=application: user usage parameter,... &filters=application: user usage parameter relational operator usage parameter's value,... &maxResults=number of events listed on each page of the report
ค่า dates คือวันที่ที่เกิดการใช้งานและการประทับเวลาอยู่ในรูปแบบ ISO 8601 ปปปป-ดด-วว ดูข้อมูลเพิ่มเติมเกี่ยวกับพารามิเตอร์สตริงการค้นหาและพร็อพเพอร์ตี้การตอบกลับได้ที่ข้อมูลอ้างอิง API สำหรับข้อมูลเกี่ยวกับพารามิเตอร์รายงานการใช้งานของผู้ใช้ โปรดดูที่ข้อมูลอ้างอิงพารามิเตอร์การใช้งานของผู้ใช้
ตัวอย่างต่อไปนี้ได้รับรายงานเกี่ยวกับกิจกรรมผู้ใช้ทั้งหมดของบัญชี
GET https://admin.googleapis.com/admin/reports/v1/usage/users/all /dates/2013-03-03?maxResults=2
ตัวอย่างต่อไปนี้ได้รับรายงานกิจกรรมของผู้ใช้ทั้งหมดสําหรับบัญชีลูกค้าหนึ่งๆ
GET https://admin.googleapis.com/admin/reports/v1/usage/users/all /dates/2013-03-03?customerId=C03az79cb
ตัวอย่างต่อไปนี้ได้รับรายงานเกี่ยวกับการประทับเวลาการเข้าสู่ระบบครั้งล่าสุดของผู้ใช้ในบัญชี โปรดดูตัวอย่างการตอบกลับของ API ในตัวอย่างการตอบกลับ JSON
GET https://admin.googleapis.com/admin/reports/v1/usage/users/all/dates/2013-03-03 ?parameters=accounts:last_login_time&maxResults=2
ตัวอย่างต่อไปนี้ได้รับรายงานเกี่ยวกับการประทับเวลาการเข้าสู่ระบบครั้งล่าสุดของผู้ใช้ในบัญชี ซึ่งกรองตามผู้ใช้ที่เข้าสู่ระบบในเวลาที่เฉพาะเจาะจง โปรดดูตัวอย่างการตอบกลับของ API ในตัวอย่างการตอบกลับ JSON
GET https://admin.googleapis.com/admin/reports/v1/usage/users/all/dates/2013-03-03 ?parameters=accounts:last_login_time&filters=accounts:last_login_time >2010-10-28T10:26:35.000Z"
ตัวอย่างต่อไปนี้ได้รับรายงานเกี่ยวกับการประทับเวลาการเข้าสู่ระบบครั้งล่าสุดและสถานะที่ถูกระงับของผู้ใช้ในบัญชี โปรดดูตัวอย่างการตอบกลับของ API ในตัวอย่างการตอบกลับ JSON
GET https://admin.googleapis.com/admin/reports/v1/usage/users/all/dates/2013-03-03 ?parameters=accounts:last_login_time,accounts:is_disabled"
ดึงข้อมูลกิจกรรมการใช้งานของผู้ใช้ที่ต้องการ
หากต้องการเรียกรายงานกิจกรรมของผู้ใช้ที่เฉพาะเจาะจงในบัญชีของคุณ ให้ใช้คำขอ HTTP GET ต่อไปนี้และรวมโทเค็นการให้สิทธิ์ที่อธิบายไว้ในเอกสารการให้สิทธิ์ ตัวอย่างต่อไปนี้จัดรูปแบบด้วยการขึ้นบรรทัดใหม่เพื่อให้อ่านง่ายขึ้น
GET https://admin.googleapis.com/admin/reports/v1/usage/users/userKey/dates/yyyy-mm-dd date ?parameters=application: user usage parameter,... &filters=application: user usage parameter relational operator usage parameter's value,... &maxResults=number of events listed on each page of the report
userKey อาจเป็นอีเมลหลักของผู้ใช้ในรายงาน หรือ Google Workspace profileId ที่ไม่ซ้ำกันของผู้ใช้ก็ได้ ค่า dates คือวันที่ที่เกิดการใช้งานและการประทับเวลาอยู่ในรูปแบบ ISO 8601 ปปปป-ดด-วว ดูข้อมูลเพิ่มเติมเกี่ยวกับพารามิเตอร์สตริงการค้นหาและพร็อพเพอร์ตี้การตอบกลับได้ที่ข้อมูลอ้างอิง API สำหรับข้อมูลเกี่ยวกับพารามิเตอร์รายงานการใช้งานของผู้ใช้ โปรดดูที่ข้อมูลอ้างอิงพารามิเตอร์การใช้งานของผู้ใช้
ตัวอย่างต่อไปนี้ได้รับรายงานการใช้งานสำหรับ john@example.com
https://admin.googleapis.com/admin/reports/v1/usage/users/john@example.com/dates/2013-03-03
ตัวอย่างการตอบกลับ JSON สำหรับรายงานการใช้งาน
การตอบกลับที่สำเร็จจะแสดงรหัสสถานะ HTTP 200 การตอบกลับจะแสดงรายงานพร้อมกับรหัสสถานะ
การตอบกลับ 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": "USER",
"customerId": "C03az79cb",
"userEmail": "liz@example.com",
"profileId": "user's unique Google Workspace ID"
},
"parameters": [
{
"name": "accounts:is_disabled",
"boolValue": false
},
{
"name": "accounts:disabled_reason",
"stringValue": "reason description"
},
{
"name": "accounts:first_name",
"stringValue": "Liz"
},
{
"name": "accounts:is_2sv_enforced",
"boolValue": false
},
{
"name": "accounts:is_2sv_enrolled",
"boolValue": false
},
{
"name": "accounts:last_name",
"stringValue": "Smith"
},
{
"name": "accounts:creation_time",
"datetimeValue": "2010-10-28T10:26:35.000Z"
},
{
"name": "accounts:last_login_time",
"datetimeValue": "1970-01-01T00:00:00.000Z"
},
{
"name": "accounts:last_sso_time",
"datetimeValue": "1970-01-01T00:00:00.000Z"
}
]
}
]
}