בדוח פעילות של טוקן הרשאה מוצג מידע על אתרים ואפליקציות של צד שלישי שהמשתמשים העניקו להם גישה. כל דוח משתמש בבקשת נקודת הקצה הבסיסית של הדוח עם פרמטרים ספציפיים לדוח, כמו דומיין של צד שלישי או היקפי הרשאה שהוענקו. התקופה המקסימלית לכל דוח היא 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
אחזור אירועים של אסימוני הרשאה לפי שם האירוע
במקרים מסוימים, יכול להיות שתרצו לאחזר אירועים ספציפיים, כמו ביטול הגישה של אפליקציה. כדי לעשות את זה, משתמשים ב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