หน้านี้ได้รับการแปลโดย Cloud Translation API

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 ในรูปแบบ yyyy-mm-dd ดูข้อมูลเพิ่มเติมเกี่ยวกับพารามิเตอร์สตริงการค้นหาและพร็อพเพอร์ตี้การตอบกลับได้ที่ข้อมูลอ้างอิง 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 ในรูปแบบ yyyy-mm-dd ดูข้อมูลเพิ่มเติมเกี่ยวกับพารามิเตอร์สตริงการค้นหาและพร็อพเพอร์ตี้การตอบกลับได้ที่ข้อมูลอ้างอิง 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"
    }
   ]
  }
 ]
}