Reports API: รายงานการใช้งานของผู้ใช้

รายงานการใช้งานของผู้ใช้จะแสดงข้อมูลการใช้บริการ 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"
    }
   ]
  }
 ]
}