ส่งความคิดเห็น
Method: userUsageReport.get
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
คำขอ HTTP
GET https://admin.googleapis.com/admin/reports/v1/usage/users/{userKey or all}/dates/{date}
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์เส้นทาง
พารามิเตอร์
userKey or all
string
แสดงรหัสโปรไฟล์หรืออีเมลของผู้ใช้ที่ควรกรองข้อมูล อาจเป็น all
สำหรับข้อมูลทั้งหมด หรือเป็น userKey
สำหรับรหัสโปรไฟล์ Google Workspace ที่ไม่ซ้ำกันของผู้ใช้ หรือที่อยู่อีเมลหลักของผู้ใช้ ต้องไม่ใช่ผู้ใช้ที่ถูกลบ สำหรับผู้ใช้ที่ถูกลบ ให้เรียกใช้ users.list
ใน Directory API ด้วย showDeleted=true
จากนั้นใช้ ID
ที่แสดงผลเป็น userKey
date
string
แสดงวันที่ที่เกิดการใช้งาน โดยยึดตาม UTC-8:00 (เวลามาตรฐานแปซิฟิก) การประทับเวลาอยู่ในรูปแบบ ISO 8601 yyyy-mm-dd
พารามิเตอร์การค้นหา
พารามิเตอร์
customerId
string
รหัสที่ไม่ซ้ำกันของลูกค้าที่ใช้เรียกข้อมูล
filters
string
สตริงการค้นหา filters
คือรายการพารามิเตอร์เหตุการณ์ของแอปพลิเคชันที่คั่นด้วยคอมมา ซึ่งโอเปอเรเตอร์แบบสัมพัทธ์จะควบคุมค่าของพารามิเตอร์ สตริงการค้นหา filters
มีชื่อแอปพลิเคชันที่แสดงผลการใช้งานในรายงาน ค่าแอปพลิเคชันสำหรับรายงานการใช้งานของผู้ใช้ประกอบด้วย accounts
, docs
และ gmail
โดยตัวกรองจะอยู่ในรูปแบบ [application name]:[parameter
name][relational operator][parameter value],...
ในตัวอย่างนี้ <>
"ไม่เท่ากับ" คือ URL ที่เข้ารหัสในสตริงการค้นหาของคำขอ (%3C%3E):
GET
https://www.googleapis.com/admin/reports/v1/usage/users/all/dates/2013-03-03
?parameters=accounts:last_login_time
&filters=accounts:last_login_time%3C%3E2010-10-28T10:26:35.000Z
โอเปอเรเตอร์เชิงสัมพันธ์ ได้แก่
==
- "เท่ากับ" <>
- "ไม่เท่ากับ" แต่มีการเข้ารหัส URL (%3C%3E) <
- "น้อยกว่า" แต่มีการเข้ารหัส URL (%3C) <=
- "น้อยกว่าหรือเท่ากับ" แต่มีการเข้ารหัส URL (%3C=) >
- "มากกว่า" แต่มีการเข้ารหัส URL (%3E) >=
- "มากกว่าหรือเท่ากับ" แต่มีการเข้ารหัส URL (%3E=)
maxResults
integer (uint32 format)
กำหนดจำนวนบันทึกกิจกรรมที่จะแสดงในหน้าคำตอบแต่ละหน้า ตัวอย่างเช่น หากคำขอตั้งค่า maxResults=1
และรายงานมีกิจกรรม 2 รายการ รายงานจะมี 2 หน้า พร็อพเพอร์ตี้ nextPageToken
ของการตอบกลับมีโทเค็นไปยังหน้าที่ 2 คุณจะระบุสตริงคำค้นหา maxResults
หรือไม่ก็ได้
orgUnitID
string
รหัสของหน่วยขององค์กร ที่จะรายงาน ระบบจะแสดงกิจกรรมของผู้ใช้ที่อยู่ในหน่วยขององค์กรที่ระบุเท่านั้น
ข้อมูลก่อนวันที่ 17 ธันวาคม 2018 จะไม่ปรากฏในผลลัพธ์ที่กรอง
pageToken
string
โทเค็นเพื่อระบุหน้าถัดไป รายงานที่มีหลายหน้าจะมีพร็อพเพอร์ตี้ nextPageToken
ในการตอบกลับ ในคำขอติดตามผลเพื่อรับหน้าถัดไปของรายงาน ให้ป้อนค่า nextPageToken
ในสตริงคำค้นหา pageToken
parameters
string
สตริงการค้นหา parameters
คือรายการพารามิเตอร์เหตุการณ์ที่คั่นด้วยคอมมาซึ่งจะปรับแต่งผลลัพธ์ของรายงาน พารามิเตอร์จะเชื่อมโยงกับแอปพลิเคชันที่เฉพาะเจาะจง ค่าแอปพลิเคชันสำหรับรายงานการใช้งานของลูกค้า ได้แก่ accounts
, app_maker
, apps_scripts
, calendar
, classroom
, cros
, docs
, gmail
, gplus
, device_management
, meet
และ sites
สตริงการค้นหา parameters
อยู่ในรูปแบบ CSV ของ app_name1:param_name1, app_name2:param_name2
หมายเหตุ: API ไม่ยอมรับค่าพารามิเตอร์หลายค่า หากระบุพารามิเตอร์ตัวใดตัวหนึ่งมากกว่า 1 ครั้งในคำขอ API API จะยอมรับเฉพาะค่าสุดท้ายของพารามิเตอร์คำขอนั้น นอกจากนี้ หากระบุพารามิเตอร์คำขอที่ไม่ถูกต้องในคำขอ API API จะไม่สนใจพารามิเตอร์คำขอนั้น และส่งคืนการตอบกลับที่เกี่ยวข้องกับพารามิเตอร์คำขอที่ถูกต้องที่เหลืออยู่
ตัวอย่างพารามิเตอร์คำขอที่ไม่ถูกต้องคือ พารามิเตอร์ที่ไม่ได้อยู่ในแอปพลิเคชัน หากไม่มีการขอพารามิเตอร์ ระบบจะแสดงผลพารามิเตอร์ทั้งหมด
groupIdFilter
string
รหัสกลุ่มที่คั่นด้วยคอมมา (ปรับให้ยากต่อการอ่าน (Obfuscate)) ซึ่งมีการกรองกิจกรรมของผู้ใช้ กล่าวคือ การตอบกลับจะมีกิจกรรมเฉพาะผู้ใช้ที่เป็นส่วนหนึ่งของรหัสกลุ่มที่ระบุไว้ที่นี่อย่างน้อย 1 รายการ รูปแบบ: "id:abc123,id:xyz456"
เนื้อหาของคำขอ
เนื้อหาของคำขอต้องว่างเปล่า
เนื้อหาการตอบกลับ
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ UsageReports
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth ต่อไปนี้
https://www.googleapis.com/auth/admin.reports.usage.readonly
สำหรับข้อมูลเพิ่มเติม โปรดดูที่คู่มือการให้สิทธิ์
ส่งความคิดเห็น
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2024-08-29 UTC
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"ไม่มีข้อมูลที่ฉันต้องการ"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"ซับซ้อนเกินไป/มีหลายขั้นตอนมากเกินไป"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"ล้าสมัย"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"ปัญหาเกี่ยวกับการแปล"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"ตัวอย่าง/ปัญหาเกี่ยวกับโค้ด"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"อื่นๆ"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"เข้าใจง่าย"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"แก้ปัญหาของฉันได้"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"อื่นๆ"
}]
หากต้องการบอกให้เราทราบเพิ่มเติม
{"lastModified": "\u0e2d\u0e31\u0e1b\u0e40\u0e14\u0e15\u0e25\u0e48\u0e32\u0e2a\u0e38\u0e14 2024-08-29 UTC"}
[[["เข้าใจง่าย","easyToUnderstand","thumb-up"],["แก้ปัญหาของฉันได้","solvedMyProblem","thumb-up"],["อื่นๆ","otherUp","thumb-up"]],[["ไม่มีข้อมูลที่ฉันต้องการ","missingTheInformationINeed","thumb-down"],["ซับซ้อนเกินไป/มีหลายขั้นตอนมากเกินไป","tooComplicatedTooManySteps","thumb-down"],["ล้าสมัย","outOfDate","thumb-down"],["ปัญหาเกี่ยวกับการแปล","translationIssue","thumb-down"],["ตัวอย่าง/ปัญหาเกี่ยวกับโค้ด","samplesCodeIssue","thumb-down"],["อื่นๆ","otherDown","thumb-down"]],["อัปเดตล่าสุด 2024-08-29 UTC"]]