- คำขอ HTTP
- พารามิเตอร์เส้นทาง
- พารามิเตอร์การค้นหา
- เนื้อความของคำขอ
- เนื้อหาการตอบกลับ
- ขอบเขตการให้สิทธิ์
- ApplicationName
- กิจกรรม
- ลองใช้งาน
เรียกดูรายการกิจกรรมสำหรับบัญชีและแอปพลิเคชันของลูกค้าที่ต้องการ เช่น แอปพลิเคชันคอนโซลผู้ดูแลระบบหรือแอปพลิเคชัน Google ไดรฟ์ โปรดดูข้อมูลเพิ่มเติมในคำแนะนำสำหรับรายงานกิจกรรมของผู้ดูแลระบบและรายงานกิจกรรมของ Google ไดรฟ์ สำหรับข้อมูลเพิ่มเติมเกี่ยวกับพารามิเตอร์ของรายงานกิจกรรม โปรดดูคู่มืออ้างอิงเกี่ยวกับพารามิเตอร์กิจกรรม
คำขอ HTTP
GET https://admin.googleapis.com/admin/reports/v1/activity/users/{userKey or all}/applications/{applicationName}
URL ใช้ไวยากรณ์การแปลง gRPC
พารามิเตอร์เส้นทาง
พารามิเตอร์ | |
---|---|
userKey or all |
แสดงรหัสโปรไฟล์หรืออีเมลของผู้ใช้ที่ควรกรองข้อมูล อาจเป็น |
applicationName |
ชื่อแอปพลิเคชันที่จะเรียกเหตุการณ์ |
พารามิเตอร์การค้นหา
พารามิเตอร์ | |
---|---|
actorIpAddress |
ที่อยู่ Internet Protocol (IP) ของผู้จัดที่มีกิจกรรม นี่เป็นอีกวิธีหนึ่งในการกรองข้อมูลสรุปของรายงานโดยใช้ที่อยู่ IP ของผู้ใช้ที่กำลังมีการรายงานกิจกรรม ที่อยู่ IP นี้อาจแสดงหรือไม่แสดงสถานที่ตั้งจริงของผู้ใช้ ตัวอย่างเช่น ที่อยู่ IP อาจเป็นที่อยู่ของพร็อกซีเซิร์ฟเวอร์หรือที่อยู่เครือข่ายส่วนตัวเสมือน (VPN) ของผู้ใช้ พารามิเตอร์นี้รองรับทั้งเวอร์ชันที่อยู่ IPv4 และ IPv6 |
customerId |
รหัสที่ไม่ซ้ำกันของลูกค้าที่ต้องการดึงข้อมูล |
endTime |
ตั้งค่าการสิ้นสุดช่วงเวลาที่แสดงในรายงาน โดยวันที่จะอยู่ในรูปแบบ RFC 3339 เช่น 2010-10-28T10:26:35.000Z ค่าเริ่มต้นคือเวลาโดยประมาณของคําขอ API รายงาน API มีแนวคิดเวลาพื้นฐาน 3 ประการดังนี้
endTime รายงานจะแสดงกิจกรรมทั้งหมดจาก startTime จนถึงเวลาปัจจุบันหรือ 180 วันล่าสุดหาก startTime ผ่านไปแล้วนานกว่า 180 วัน
|
eventName |
ชื่อของเหตุการณ์ที่ API จะสืบค้น |
filters |
สตริงการค้นหา พารามิเตอร์เหตุการณ์เหล่านี้เชื่อมโยงกับ ในตัวอย่างกิจกรรมไดรฟ์ต่อไปนี้ รายการที่แสดงผลประกอบด้วยเหตุการณ์
คำค้นหา
หมายเหตุ: API ไม่ยอมรับค่าพารามิเตอร์เดียวกันหลายค่า หากมีการระบุพารามิเตอร์มากกว่า 1 ครั้งในคำขอ API API จะยอมรับเฉพาะค่าสุดท้ายของพารามิเตอร์ดังกล่าวเท่านั้น นอกจากนี้ หากมีการให้พารามิเตอร์ที่ไม่ถูกต้องในคำขอ API ทาง API จะไม่สนใจพารามิเตอร์นั้นและแสดงผลการตอบกลับที่สอดคล้องกับพารามิเตอร์ที่ถูกต้องที่เหลืออยู่ หากไม่ได้ขอพารามิเตอร์ ระบบจะแสดงผลพารามิเตอร์ทั้งหมด |
maxResults |
กำหนดจำนวนบันทึกกิจกรรมที่จะแสดงในหน้าการตอบกลับแต่ละหน้า ตัวอย่างเช่น หากคำขอตั้งค่า |
orgUnitID |
รหัสของหน่วยขององค์กรที่ต้องการรายงาน บันทึกกิจกรรมจะแสดงให้กับผู้ใช้ที่อยู่ในหน่วยขององค์กรที่ระบุเท่านั้น |
pageToken |
โทเค็นที่จะระบุหน้าถัดไป รายงานที่มีหลายหน้าจะมีพร็อพเพอร์ตี้ |
startTime |
ตั้งค่าจุดเริ่มต้นของช่วงเวลาที่แสดงในรายงาน โดยวันที่จะอยู่ในรูปแบบ RFC 3339 เช่น 2010-10-28T10:26:35.000Z รายงานจะแสดงกิจกรรมทั้งหมดตั้งแต่วันที่ |
groupIdFilter |
รหัสกลุ่มที่คั่นด้วยคอมมา (ปรับให้ยากต่อการอ่าน) ในการกรองกิจกรรมของผู้ใช้ เช่น การตอบกลับจะมีกิจกรรมเฉพาะผู้ใช้ที่เป็นส่วนหนึ่งของรหัสกลุ่มที่ระบุที่นี่อย่างน้อย 1 รายการ รูปแบบ: "id:abc123,id:xyz456" |
เนื้อหาของคำขอ
เนื้อหาของคำขอต้องว่างเปล่า
เนื้อหาการตอบกลับ
เทมเพลต JSON สำหรับคอลเล็กชันกิจกรรม
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
การแสดง JSON |
---|
{
"kind": string,
"etag": string,
"items": [
{
object ( |
ช่อง | |
---|---|
kind |
ประเภทของทรัพยากร API สำหรับรายงานกิจกรรม ค่าจะเป็น |
etag |
ETag ของทรัพยากร |
items[] |
แต่ละกิจกรรมจะบันทึกในคำตอบ |
nextPageToken |
โทเค็นสำหรับเรียกหน้าถัดไปของรายงาน ระบบจะใช้ค่า |
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต OAuth ต่อไปนี้
https://www.googleapis.com/auth/admin.reports.audit.readonly
โปรดดูข้อมูลเพิ่มเติมที่คู่มือการให้สิทธิ์
ApplicationName
Enum | |
---|---|
access_transparency |
รายงานกิจกรรมความโปร่งใสในการเข้าถึงของ Google Workspace จะแสดงข้อมูลเกี่ยวกับเหตุการณ์ของกิจกรรมความโปร่งใสในการเข้าถึงประเภทต่างๆ |
admin |
รายงานกิจกรรมของแอปพลิเคชันของคอนโซลผู้ดูแลระบบจะแสดงข้อมูลบัญชีเกี่ยวกับกิจกรรมของกิจกรรมของผู้ดูแลระบบประเภทต่างๆ |
calendar |
รายงานกิจกรรมของแอปพลิเคชัน Google ปฏิทินจะแสดงข้อมูลเกี่ยวกับกิจกรรมต่างๆ ในปฏิทิน |
chat |
รายงานกิจกรรมใน Chat จะแสดงข้อมูลเกี่ยวกับเหตุการณ์ต่างๆ ใน Chat |
drive |
รายงานกิจกรรมของแอปพลิเคชัน Google ไดรฟ์จะแสดงข้อมูลเกี่ยวกับเหตุการณ์ต่างๆ ของกิจกรรมใน Google ไดรฟ์ รายงานกิจกรรมไดรฟ์มีให้บริการสำหรับลูกค้า Google Workspace Business และ Enterprise เท่านั้น |
gcp |
รายงานกิจกรรมของแอปพลิเคชัน Google Cloud Platform จะแสดงข้อมูลเกี่ยวกับเหตุการณ์ของกิจกรรม GCP ต่างๆ |
gplus |
รายงานกิจกรรมของแอปพลิเคชัน Google+ จะแสดงข้อมูลเกี่ยวกับกิจกรรมกิจกรรมของ Google+ ต่างๆ |
groups |
รายงานกิจกรรมของแอปพลิเคชัน Google Groups จะแสดงข้อมูลเกี่ยวกับเหตุการณ์ต่างๆ ของกิจกรรม Groups |
groups_enterprise |
รายงานกิจกรรมกลุ่มองค์กรจะแสดงข้อมูลเกี่ยวกับเหตุการณ์ต่างๆ ของกิจกรรมกลุ่มองค์กร |
jamboard |
รายงานกิจกรรม Jamboard จะแสดงข้อมูลเกี่ยวกับเหตุการณ์ต่างๆ ของกิจกรรม Jamboard |
login |
รายงานกิจกรรมของแอปพลิเคชันการเข้าสู่ระบบจะแสดงข้อมูลบัญชีเกี่ยวกับเหตุการณ์กิจกรรมการเข้าสู่ระบบประเภทต่างๆ |
meet |
รายงานกิจกรรมการตรวจสอบของ Meet จะแสดงข้อมูลเกี่ยวกับเหตุการณ์ของกิจกรรมการตรวจสอบ Meet ประเภทต่างๆ |
mobile |
รายงานกิจกรรมการตรวจสอบอุปกรณ์จะแสดงข้อมูลเกี่ยวกับเหตุการณ์ของกิจกรรมการตรวจสอบอุปกรณ์ประเภทต่างๆ |
rules |
รายงานกิจกรรมกฎจะแสดงข้อมูลเกี่ยวกับเหตุการณ์ของกิจกรรมกฎประเภทต่างๆ |
saml |
รายงานกิจกรรม SAML จะแสดงข้อมูลเกี่ยวกับเหตุการณ์กิจกรรม SAML ประเภทต่างๆ |
token |
รายงานกิจกรรมของแอปพลิเคชันโทเค็นจะแสดงข้อมูลบัญชีเกี่ยวกับเหตุการณ์ของกิจกรรมโทเค็นประเภทต่างๆ |
user_accounts |
รายงานกิจกรรมของแอปพลิเคชันบัญชีผู้ใช้จะแสดงข้อมูลบัญชีเกี่ยวกับเหตุการณ์ของกิจกรรมบัญชีผู้ใช้ประเภทต่างๆ |
context_aware_access |
รายงานกิจกรรมการเข้าถึงแบบ Context-Aware จะแสดงข้อมูลเกี่ยวกับเหตุการณ์ที่ถูกปฏิเสธการเข้าถึงของผู้ใช้เนื่องจาก กฎการเข้าถึงแบบ Context-Aware |
chrome |
รายงานกิจกรรม Chrome จะแสดงข้อมูลเกี่ยวกับ เหตุการณ์ของเบราว์เซอร์ Chrome และ ChromeOS |
data_studio |
รายงานกิจกรรมของ Data Studio จะแสดงข้อมูลเกี่ยวกับเหตุการณ์ของกิจกรรมประเภทต่างๆ ของ Data Studio |
keep |
รายงานกิจกรรมของแอปพลิเคชัน Keep จะแสดงข้อมูลเกี่ยวกับเหตุการณ์ต่างๆ ของกิจกรรม Google Keep รายงานกิจกรรม Keep มีให้บริการสำหรับลูกค้า Google Workspace Business และ Enterprise เท่านั้น |
vault |
รายงานกิจกรรมของห้องนิรภัยจะแสดงข้อมูลเหตุการณ์ประเภทต่างๆ ของกิจกรรมของห้องนิรภัย |
กิจกรรม
เทมเพลต JSON สำหรับทรัพยากรกิจกรรม
การแสดง JSON |
---|
{ "kind": string, "etag": string, "ownerDomain": string, "ipAddress": string, "events": [ { "type": string, "name": string, "parameters": [ { "messageValue": { "parameter": [ { object ( |
ช่อง | |
---|---|
kind |
ประเภทของทรัพยากร API สำหรับรายงานกิจกรรม ค่าจะเป็น |
etag |
ETag ของรายการ |
ownerDomain |
ซึ่งก็คือโดเมนที่ได้รับผลกระทบจากเหตุการณ์ของรายงาน เช่น โดเมนของคอนโซลผู้ดูแลระบบหรือเจ้าของเอกสารของแอปพลิเคชันไดรฟ์ |
ipAddress |
ที่อยู่ IP ของผู้ใช้ที่ดำเนินการนั้นๆ ที่อยู่นี้คือที่อยู่ Internet Protocol (IP) ของผู้ใช้เมื่อเข้าสู่ระบบ Google Workspace ซึ่งอาจแสดงถึงสถานที่ตั้งจริงของผู้ใช้หรือไม่ก็ได้ ตัวอย่างเช่น ที่อยู่ IP อาจเป็นที่อยู่ของพร็อกซีเซิร์ฟเวอร์หรือที่อยู่เครือข่ายส่วนตัวเสมือน (VPN) ของผู้ใช้ API รองรับ IPv4 และ IPv6 |
events[] |
เหตุการณ์กิจกรรมในรายงาน |
events[].type |
ประเภทกิจกรรม บริการหรือฟีเจอร์ของ Google Workspace ที่ผู้ดูแลระบบเปลี่ยนแปลงในพร็อพเพอร์ตี้ |
events[].name |
ชื่อเหตุการณ์ นี่คือชื่อเฉพาะของกิจกรรมที่รายงานโดย API และ
ดูข้อมูลเพิ่มเติมเกี่ยวกับพร็อพเพอร์ตี้ eventName ได้ที่รายการชื่อเหตุการณ์สำหรับแอปพลิเคชันต่างๆ ด้านบนใน applicationName
|
events[].parameters[] |
คู่ค่าพารามิเตอร์สำหรับแอปพลิเคชันต่างๆ ดูข้อมูลเพิ่มเติมเกี่ยวกับพารามิเตอร์ |
events[].parameters[].messageValue |
คู่ค่าพารามิเตอร์ที่ซ้อนกันซึ่งเชื่อมโยงกับพารามิเตอร์นี้ ระบบจะแสดงประเภทค่าที่ซับซ้อนของพารามิเตอร์เป็นรายการค่าพารามิเตอร์ เช่น พารามิเตอร์ที่อยู่อาจมีค่าเป็น |
events[].parameters[].messageValue.parameter[] |
ค่าพารามิเตอร์ |
events[].parameters[].name |
ชื่อพารามิเตอร์ |
events[].parameters[].value |
ค่าสตริงของพารามิเตอร์ |
events[].parameters[].multiValue[] |
ค่าสตริงของพารามิเตอร์ |
events[].parameters[].intValue |
ค่าจำนวนเต็มของพารามิเตอร์ |
events[].parameters[].multiIntValue[] |
ค่าจำนวนเต็มของพารามิเตอร์ |
events[].parameters[].boolValue |
ค่าบูลีนของพารามิเตอร์ |
events[].parameters[].multiMessageValue[] |
activity.list จากออบเจ็กต์ |
events[].parameters[].multiMessageValue[].parameter[] |
ค่าพารามิเตอร์ |
id |
ตัวระบุที่ไม่ซ้ำกันสำหรับบันทึกกิจกรรมแต่ละรายการ |
id.time |
เวลาที่กิจกรรมเกิดขึ้น นี่คือเวลา UNIX Epoch ในหน่วยวินาที |
id.uniqueQualifier |
ตัวระบุที่ไม่ซ้ำกันหากหลายเหตุการณ์มีเหตุการณ์เดียวกัน |
id.applicationName |
ชื่อแอปพลิเคชันที่เกิดเหตุการณ์ สำหรับค่าที่เป็นไปได้ โปรดดูรายการแอปพลิเคชันด้านบนใน |
id.customerId |
ตัวระบุที่ไม่ซ้ำกันสำหรับบัญชี Google Workspace |
actor |
ผู้ใช้ที่ดำเนินการ |
actor.profileId |
รหัสโปรไฟล์ Google Workspace ที่ไม่ซ้ำกันของผู้ดำเนินการ ค่านี้อาจไม่แสดงหากผู้ดำเนินการไม่ใช่ผู้ใช้ Google Workspace หรืออาจเป็นหมายเลข 105250506097979753968 ซึ่งทำหน้าที่เป็นรหัสตัวยึดตำแหน่ง |
actor.email |
อีเมลหลักของผู้ดำเนินการ อาจหายไปหากไม่มีอีเมลที่เชื่อมโยงกับผู้ดำเนินการ |
actor.callerType |
ประเภทนักแสดง |
actor.key |
แสดงเมื่อ |