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