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

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

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

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