Reports API: รายงานกิจกรรมโทเค็นการให้สิทธิ์

รายงานกิจกรรมของโทเค็นการให้สิทธิ์จะแสดงข้อมูลเกี่ยวกับเว็บไซต์และแอปพลิเคชันของบุคคลที่สามที่ผู้ใช้ให้สิทธิ์เข้าถึง แต่ละรายงานใช้คำขอปลายทางรายงานพื้นฐานที่มีพารามิเตอร์เฉพาะรายงาน เช่น โดเมนของบุคคลที่สามหรือขอบเขตการให้สิทธิ์ที่ได้รับ ระยะเวลาสูงสุดของแต่ละรายงานคือ 180 วันที่ผ่านมา

รายงานกิจกรรมของโทเค็น OAuth จะใช้เพื่อวัตถุประสงค์ที่ถูกต้องตามกฎหมายตามข้อตกลงของลูกค้าเท่านั้น

ดึงข้อมูลเหตุการณ์โทเค็นการให้สิทธิ์ทั้งหมดสำหรับโดเมน

หากต้องการเรียกเหตุการณ์การให้สิทธิ์ทั้งหมดสำหรับแอปพลิเคชันบุคคลที่สาม ให้ใช้คำขอ HTTP GET ต่อไปนี้และรวมโทเค็นการให้สิทธิ์ที่อธิบายไว้ในเอกสารการให้สิทธิ์ ดูข้อมูลเพิ่มเติมเกี่ยวกับสตริงการค้นหาและพร็อพเพอร์ตี้การตอบกลับได้ที่ข้อมูลอ้างอิง API ตัวอย่างต่อไปนี้จะจัดรูปแบบด้วยการขึ้นบรรทัดใหม่เพื่อให้อ่านได้ง่าย

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/token?endTime=end date&startTime=start date
&maxResults=maximum number of events returned on a response page

ตัวอย่างต่อไปนี้จะได้รับรายงานเกี่ยวกับกิจกรรมการให้สิทธิ์ทั้งหมดของบัญชีในช่วง 180 วันที่ผ่านมา พารามิเตอร์การค้นหา maxResults มีรายงานนี้แสดงผลลัพธ์ 25 รายการต่อหน้า

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/token?maxResults=25

เรียกเหตุการณ์โทเค็นการให้สิทธิ์ตามชื่อเหตุการณ์

ในบางกรณี คุณอาจต้องการเรียกข้อมูลเหตุการณ์ที่เฉพาะเจาะจง เช่น สิทธิ์เข้าถึงของแอปพลิเคชันถูกเพิกถอนหรือไม่ โดยใช้คำขอ HTTP GET จากแบบฟอร์มต่อไปนี้

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/token?maxResults=maximum number of events returned on a response page
&eventName=name of the OAuth token event

ตัวอย่างต่อไปนี้แสดงวิธีเรียกเหตุการณ์ revoke ทั้งหมดสำหรับโดเมน

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/token?eventName=revoke&maxResults=25