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