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