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