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

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

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

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

หากต้องการเรียกข้อมูลเหตุการณ์การให้สิทธิ์ทั้งหมดสำหรับแอปพลิเคชันของบุคคลที่สาม ให้ใช้ ต่อไปนี้ GET คำขอ HTTP และรวมโทเค็นการให้สิทธิ์ที่อธิบายไว้ใน เอกสารการให้สิทธิ์ สำหรับข้อมูลเพิ่มเติมเกี่ยวกับสตริงการค้นหาคำขอและพร็อพเพอร์ตี้การตอบกลับ ดูเอกสารอ้างอิง 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