- คำขอ HTTP
- พารามิเตอร์เส้นทาง
- พารามิเตอร์การค้นหา
- เนื้อความของคำขอ
- เนื้อหาการตอบกลับ
- ขอบเขตการให้สิทธิ์
- ApplicationName
เริ่มรับการแจ้งเตือนสำหรับกิจกรรมในบัญชี สำหรับข้อมูลเพิ่มเติม โปรดดูที่การรับข้อความ Push
คำขอ HTTP
POST https://admin.googleapis.com/admin/reports/v1/activity/users/{userKey or all}/applications/{applicationName}/watch
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" |
เนื้อหาของคำขอ
เนื้อความของคำขอมีอินสแตนซ์ของ SubscriptionChannel
เนื้อหาการตอบกลับ
ช่องทางการแจ้งเตือนที่ใช้ดูการเปลี่ยนแปลงทรัพยากร
หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้
การแสดง JSON |
---|
{ "id": string, "token": string, "expiration": string, "type": string, "address": string, "payload": boolean, "params": { string: string, ... }, "resourceId": string, "resourceUri": string, "kind": string } |
ช่อง | |
---|---|
id |
UUID หรือสตริงที่ไม่ซ้ำกันที่คล้ายกันซึ่งระบุแชแนลนี้ |
token |
สตริงที่กำหนดเองที่ส่งไปยังที่อยู่เป้าหมายพร้อมการแจ้งเตือนแต่ละรายการที่ส่งผ่านแชแนลนี้ ไม่บังคับ |
expiration |
วันที่และเวลาหมดอายุของช่องทางการแจ้งเตือน ซึ่งแสดงเป็นการประทับเวลา Unix ในหน่วยมิลลิวินาที ไม่บังคับ |
type |
ประเภทของกลไกการนำส่งที่ใช้สำหรับช่องทางนี้ ค่าควรกำหนดไว้เป็น |
address |
ที่อยู่ที่ส่งการแจ้งเตือนสำหรับช่องนี้ |
payload |
ค่าบูลีนที่ระบุว่าต้องการเพย์โหลดหรือไม่ เพย์โหลดคือข้อมูลที่ส่งในส่วนเนื้อหาของข้อความ HTTP POST, PUT หรือ Patch และมีข้อมูลสำคัญเกี่ยวกับคำขอ ไม่บังคับ |
params |
พารามิเตอร์เพิ่มเติมที่ควบคุมลักษณะการทำงานของช่องทางการแสดงโฆษณา ไม่บังคับ ออบเจ็กต์ที่มีรายการคู่ |
resourceId |
รหัสทึบที่ระบุแหล่งข้อมูลที่มีการรับชมในช่องนี้ เสถียรใน API เวอร์ชันต่างๆ |
resourceUri |
ตัวระบุเฉพาะเวอร์ชันสำหรับทรัพยากรที่ดู |
kind |
ระบุว่าช่องทางนี้เป็นช่องทางการแจ้งเตือนที่ใช้ในการดูการเปลี่ยนแปลงของแหล่งข้อมูล ซึ่งก็คือ " |
ขอบเขตการให้สิทธิ์
ต้องใช้ขอบเขต 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 และ Google Workspace 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 เท่านั้น |