קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
בדוח פעילות של טוקן הרשאה מוצג מידע על אתרים ואפליקציות של צד שלישי שהמשתמשים העניקו להם גישה. כל דוח משתמש בבקשת נקודת הקצה הבסיסית של הדוח עם פרמטרים ספציפיים לדוח, כמו דומיין של צד שלישי או היקפי הרשאה שהוענקו. התקופה המקסימלית לכל דוח היא 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
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2025-08-29 (שעון UTC)."],[],[],null,["# Reports API: Authorization Tokens Activity Report\n\nThe authorization token activity report returns information about third party\nwebsites and applications your users have granted access for. Each report\nuses the basic report endpoint request with report-specific parameters such\nas the third party domain or authorization scopes granted. The maximum time\nperiod for each report is the last 180 days.\n\nThe OAuth token activity report may be used only for lawful purposes in accordance with your Customer Agreement.\n\nRetrieve all authorization token events for a domain\n----------------------------------------------------\n\nTo retrieve all authorization events for third party applications, use the\nfollowing `GET` HTTP request and include the authorization token described in the\n[authorization documentation](https://developers.google.com/workspace/admin/reports/v1/guides/authorizing.html).\nFor more information about the request query strings and response properties,\nsee the [API Reference](/workspace/admin/reports/v1/reference/activity-ref-appendix-a/token-event-names).\nFor readability purposes, the following example is formatted with line returns: \n\n```\nGET https://admin.googleapis.com/admin/reports/v1/activity/users/all\n/applications/token?endTime=end date&startTime=start date\n&maxResults=maximum number of events returned on a response page\n```\n\nThe following example gets a report on all of your account's authorization events\nfor the past 180 days. The `maxResults` query parameter has this report return\n25 results per page. \n\n```\nGET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/token?maxResults=25\n```\n\nRetrieve authorization token events by event name\n-------------------------------------------------\n\nIn some instances, you may want to retrieve specific events, such as whether an\napplication's access has been revoked. To do this, use a `GET` HTTP request\nof the following form: \n\n```\nGET https://admin.googleapis.com/admin/reports/v1/activity/users/all\n/applications/token?maxResults=maximum number of events returned on a response page\n&eventName=name of the OAuth token event\n```\n\nThe following example shows how to retrieve all `revoke` events for a domain: \n\n```\nGET https://admin.googleapis.com/admin/reports/v1/activity/users/all/applications/token?eventName=revoke&maxResults=25\n```"]]
