קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
דוח פעילות האדמין מחזיר מידע על הפעילויות במסוף Admin של כל מנהלי המערכת בחשבון. כל דוח משתמש בבקשה הבסיסית לנקודת הקצה של הדוח עם פרמטרים ספציפיים לדוח, כמו שם האדמין או אירוע ספציפי במסוף Admin. תקופת הזמן המקסימלית לכל דוח היא 180 הימים האחרונים.
ניתן להשתמש בדוח פעילות של אדמין רק למטרות חוקיות, בהתאם להסכם הלקוח שלך. הדוחות האלה חלים על חשבונות Google Workspace, Education ו-ISP.
אחזור כל פעילויות הניהול
כדי לאחזר דוח של כל פעילויות הניהול שבוצעו בחשבון, צריך להשתמש בבקשת ה-HTTP הבאה מסוג GET ולכלול את אסימון ההרשאה המתואר במסמכי ההרשאה. מידע נוסף על מחרוזות השאילתה של הבקשה ועל מאפייני התגובה זמין בחומר העזר בנושא API. כדי לשמור על קריאוּת, הדוגמה הבאה בפורמט של החזרות שורות:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/admin?endTime=a date&startTime=a date
&maxResults=number of events listed on each page of the report
הדוגמה הבאה מציגה דוח על כל פעילויות הניהול בחשבון שלך ב-180 הימים האחרונים. זוהי תקופת הזמן המקסימלית לדוח. מחרוזת השאילתה maxResults קובעת שהדוח הזה מכיל שני אירועים לכל דף דוח. דוגמה לתגובת API מופיעה בדוגמה לתגובת JSON:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/admin?maxResults=2
בדוגמה הבאה מוצג דוח על כל הפעילויות הניהוליות של לקוח ב-180 הימים האחרונים. השדה customerId מציין לגבי איזה לקוח שלגביו רוצים לאחזר את הדוח.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/admin?customerId=C03az79cb
אחזור כל הפעילויות על ידי האדמין
כדי לאחזר דוח של כל הפעילויות במסוף Admin שבוצעו על ידי אדמין מסוים, צריך להשתמש בבקשת ה-HTTP הבאה של GET ולכלול את אסימון ההרשאה המתואר במסמכי ההרשאה. userKey היא כתובת האימייל הראשית של האדמין בדוח. מידע נוסף על מחרוזות השאילתה של הבקשה ועל מאפייני התגובה זמין בחומר העזר בנושא API. כדי לשמור על קריאוּת, הדוגמה הבאה בפורמט של החזרות שורות:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/userKey
/applications/admin?endTime=a date&startTime=a date
&maxResults=number of events listed on each page of the report
&filters=event name parameterrelational operatorparameter value
בדוגמה הבאה מופיע דוח על כל השינויים באפליקציה של מסוף Admin שבוצעו על ידי john@example.com, והתשובה מסוננת כדי להחזיר פעילויות שהערך שלהן הוא OLD_VALUE שווה ל-ALLOW_CAMERA. דוגמה לתגובת API מופיעה בדוגמה לתגובת JSON. למידע על הפעילויות, ראו שמות האירועים של אדמין:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/john@example.com
/applications/admin?maxResults=2&filters=OLD_VALUE==ALLOW_CAMERA
אחזור כל הפעילויות לפי שם האירוע
כדי לאחזר דוח של כל הפעילויות עבור שם אירוע ספציפי, צריך להשתמש בבקשת ה-HTTP הבאה של GET ולכלול את אסימון ההרשאה המתואר במסמכי ההרשאה. למידע על eventName, ראו מידע על שמות של אירועים לאדמינים. מידע נוסף על מחרוזות השאילתה של הבקשה ועל מאפייני התגובה זמין בחומר העזר בנושא API. כדי לשמור על קריאוּת, הדוגמה הבאה בפורמט של החזרות שורות:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/admin?endTime=a date&startTime=a date
&maxResults=maximum number of events returned on a response page
&eventName=name of the administrative event
הדוגמה הבאה מאחזרת דוח לכל המופעים של מסוף Admin של שינוי שם המשפחה של משתמש. דוגמה לתגובת API מופיעה בדוגמה לתגובת JSON:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/admin?maxResults=1&eventName=CHANGE_LAST_NAME
אחזור כל הפעילויות לפי אירוע ואדמין
כדי לאחזר דוח של כל השינויים במסוף Admin עבור שם של אירוע ספציפי שבוצע על ידי אדמין ספציפי, צריך להשתמש בבקשת ה-HTTP הבאה של GET ולכלול את אסימון ההרשאה המתואר במסמכי ההרשאה. userKey היא כתובת האימייל הראשית של האדמין בדוח. למידע על eventName, ראו מידע על שמות של אירועים לאדמינים. מידע נוסף על מחרוזות השאילתה של הבקשה ועל מאפייני התגובה זמין בחומר העזר בנושא API. כדי לשמור על קריאוּת, הדוגמה הבאה בפורמט של החזרות שורות:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/userKey
/applications/admin?endTime=a date&startTime=a date
&maxResults=maximum number of events returned on a response page
&eventName=name of the administrative event
הדוגמה הבאה מאחזרת דוח על כל השינויים במסוף Admin בשם המשפחה של משתמש ספציפי, שבוצעו על ידי john@example.com. דוגמה לתגובת API מופיעה בדוגמה לתגובת JSON:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/john@example.com
/applications/admin?maxResults=1&eventName=CHANGE_LAST_NAME
{"kind":"reports#auditActivities","nextPageToken":"the next page's token","items":[{"kind":"audit#activity","id":{"time":"2011-06-17T15:39:18.460Z","uniqueQualifier":"report's unique ID","applicationName":"admin","customerId":"C03az79cb"},"actor":{"callerType":"USER","email":"liz@example.com","profileId":"user's unique Google Workspace profile ID","key":"consumer key of requestor in OAuth 2LO requests"},"ownerDomain":"example.com","ipAddress":"user's IP address","events":[{"type":"GROUP_SETTINGS","name":"CHANGE_GROUP_SETTING","parameters":[{"name":"SETTING_NAME","value":"WHO_CAN_JOIN","intValue":"integer value of parameter","boolValue":"boolean value of parameter"}]}]},{"kind":"audit#activity","id":{"time":"2011-06-17T15:39:18.460Z","uniqueQualifier":"reports unique ID","applicationName":"admin","customerId":"C03az79cb"},"actor":{"callerType":"USER","email":"liz@example.com","profileId":"user's unique Google Workspace profile ID","key":"consumer key of requestor in an OAuth 2LO request"},"ownerDomain":"example.com","ipAddress":"user's IP address","events":[{"type":"GROUP_SETTINGS","name":"CREATE_GROUP","parameters":[{"name":"GROUP_EMAIL","value":"helpdesk@example.com","intValue":"","boolValue":""}]}]}]}
[null,null,["עדכון אחרון: 2025-08-29 (שעון UTC)."],[],[],null,["# Admin Activity Report\n\nThe admin activity report returns information on the Admin console activities of all of your account's administrators. Each report uses the basic report endpoint request with report-specific parameters such as an administrator's name or a specific Admin console event. The maximum time period for each report is the last 180 days.\n\nThe admin activity report may be used only for lawful purposes in accordance with your Customer Agreement. And these reports apply to Google Workspace, Education, and ISP accounts.\n\nRetrieve all administrative activities\n--------------------------------------\n\nTo retrieve a report of all administrative activities done for an account, use the following `GET` HTTP request and include the authorization token described in the [authorization documentation](/workspace/admin/reports/v1/guides/authorizing). For more information about the request's query strings and the response properties, see the [API Reference](/workspace/admin/reports/v1/reference/activities/list). For readability, the following example is formatted with line returns: \n\n```\nGET https://admin.googleapis.com/admin/reports/v1/activity/users/all\n/applications/admin?endTime=a date&startTime=a date\n&maxResults=number of events listed on each page of the report\n```\n\nThe following example gets a report on all of your account's administrative activities for the past 180 days which is the maximum time period for a report. And the `maxResults` query string determines this report contains two events per report page. For an example of an API response, see the [JSON response example](#example_response): \n\n```\nGET https://admin.googleapis.com/admin/reports/v1/activity/users/all\n/applications/admin?maxResults=2\n```\n\nThe following example gets a report on all of a customer's administrative activities for the past 180 days. The `customerId` specifies which customer the report is to be retrieved for. \n\n```\nGET https://admin.googleapis.com/admin/reports/v1/activity/users/all\n/applications/admin?customerId=C03az79cb\n```\n\nRetrieve all activities by administrator\n----------------------------------------\n\nTo retrieve a report of all Admin console activities done by a specific administrator, use the following `GET` HTTP request and include the authorization token described in the [authorization documentation](/workspace/admin/reports/v1/guides/authorizing). The `userKey` is the primary email address of the administrator in the report. For more information about the request's query strings and the response properties, see the [API Reference](/workspace/admin/reports/v1/reference/activities/list). For readability, the following example is formatted with line returns: \n\n```\nGET https://admin.googleapis.com/admin/reports/v1/activity/users/userKey\n/applications/admin?endTime=a date&startTime=a date\n&maxResults=number of events listed on each page of the report\n&filters=event name parameter relational operator parameter value\n```\n\nThe following example gets a report on all changes to the Admin console application done by `john@example.com`, and the response is filtered to return any activities which have an `OLD_VALUE` equal to `ALLOW_CAMERA`. For an example of an API response, see the [JSON response example](#example_response). And for information about the activities, see the [administrator event names](/workspace/admin/reports/v1/reference/activity-ref-appendix-a/admin-event-names): \n\n```\nGET https://admin.googleapis.com/admin/reports/v1/activity/users/john@example.com\n/applications/admin?maxResults=2&filters=OLD_VALUE==ALLOW_CAMERA\n```\n\nRetrieve all activities by event name\n-------------------------------------\n\nTo retrieve a report of all activities for a specific event name, use the following `GET` HTTP request and include the authorization token described in the [authorization documentation](/workspace/admin/reports/v1/guides/authorizing). For the `eventName` information, see the [administrator event names reference information](/workspace/admin/reports/v1/reference/activity-ref-appendix-a/admin-event-names). For more information about the request's query strings and the response properties, see the [API Reference](/workspace/admin/reports/v1/reference/activities/list). For readability, the following example is formatted with line returns: \n\n```\nGET https://admin.googleapis.com/admin/reports/v1/activity/users/all\n/applications/admin?endTime=a date&startTime=a date\n&maxResults=maximum number of events returned on a response page\n&eventName=name of the administrative event\n```\n\nThe following example retrieves a report for all Admin console instances of changing a user's last name. For an example of an API response, see the [JSON response example](#example_response): \n\n```\nGET https://admin.googleapis.com/admin/reports/v1/activity/users/all\n/applications/admin?maxResults=1&eventName=CHANGE_LAST_NAME\n```\n| **Note:** When retrieving by `eventName`, the API retrieves the activities where this event occurred. For each activity, the response includes all of the activity's events including the event specified in the API request.\n\nRetrieve all activities by event and administrator\n--------------------------------------------------\n\nTo retrieve a report of all Admin console changes for a specific event name done by a specific administrator, use the following `GET` HTTP request and include the authorization token described in the [authorization documentation](/workspace/admin/reports/v1/guides/authorizing). The `userKey` is the primary email address of the administrator in the report. For the `eventName` information, see the [administrator event names reference information](/workspace/admin/reports/v1/reference/activity-ref-appendix-a/admin-event-names). For more information about the request's query strings and the response properties, see the [API Reference](/workspace/admin/reports/v1/reference/activities/list). For readability, the following example is formatted with line returns: \n\n```\nGET https://admin.googleapis.com/admin/reports/v1/activity/users/userKey\n/applications/admin?endTime=a date&startTime=a date\n&maxResults=maximum number of events returned on a response page\n&eventName=name of the administrative event\n```\n\nThe following example retrieves a report for all Admin console changes to a specific user's last name that were done by `john@example.com`. For an example of an API response, see the [JSON response example](#example_response): \n\n```\nGET https://admin.googleapis.com/admin/reports/v1/activity/users/john@example.com\n/applications/admin?maxResults=1&eventName=CHANGE_LAST_NAME\n```\n| **Note:** When retrieving by `eventName`, the API retrieves the activities where this event occurred. For each activity, the response includes all of the activity's events including the event specified in the API request.\n\nAdmin activity report example JSON response\n-------------------------------------------\n\nA successful response returns an [HTTP 200 status code](http://wikipedia.org/wiki/List_of_HTTP_status_codes). Along with the status code, the response returns a report. For the `eventName` information, see the [administrator event names reference information](/workspace/admin/reports/v1/reference/activity-ref-appendix-a/admin-event-names). For more information about the request's URL query strings and the response properties, see the [API Reference](/workspace/admin/reports/v1/reference/activities/list). \n\n```carbon\n{\n \"kind\": \"reports#auditActivities\",\n \"nextPageToken\": \"\u003cvar class=\"apiparam\" translate=\"no\"\u003ethe next page's token\u003c/var\u003e\",\n \"items\": [\n {\n \"kind\": \"audit#activity\",\n \"id\": {\n \"time\": \"2011-06-17T15:39:18.460Z\",\n \"uniqueQualifier\": \"\u003cvar class=\"apiparam\" translate=\"no\"\u003ereport's unique ID\u003c/var\u003e\",\n \"applicationName\": \"admin\",\n \"customerId\": \"C03az79cb\"\n },\n \"actor\": {\n \"callerType\": \"USER\",\n \"email\": \"liz@example.com\",\n \"profileId\": \"\u003cvar class=\"apiparam\" translate=\"no\"\u003euser's unique Google Workspace profile ID\u003c/var\u003e\",\n \"key\": \"\u003cvar class=\"apiparam\" translate=\"no\"\u003econsumer key of requestor in OAuth 2LO requests\u003c/var\u003e\"\n },\n \"ownerDomain\": \"example.com\",\n \"ipAddress\": \"\u003cvar class=\"apiparam\" translate=\"no\"\u003euser's IP address\u003c/var\u003e\",\n \"events\": [\n {\n \"type\": \"GROUP_SETTINGS\",\n \"name\": \"CHANGE_GROUP_SETTING\",\n \"parameters\": [\n {\n \"name\": \"SETTING_NAME\",\n \"value\": \"WHO_CAN_JOIN\",\n \"intValue\": \"\u003cvar class=\"apiparam\" translate=\"no\"\u003einteger value of parameter\u003c/var\u003e\",\n \"boolValue\": \"\u003cvar class=\"apiparam\" translate=\"no\"\u003eboolean value of parameter\u003c/var\u003e\"\n }\n ]\n }\n ]\n },\n {\n \"kind\": \"audit#activity\",\n \"id\": {\n \"time\": \"2011-06-17T15:39:18.460Z\",\n \"uniqueQualifier\": \"\u003cvar class=\"apiparam\" translate=\"no\"\u003ereports unique ID\u003c/var\u003e\",\n \"applicationName\": \"admin\",\n \"customerId\": \"C03az79cb\"\n },\n \"actor\": {\n \"callerType\": \"USER\",\n \"email\": \"liz@example.com\",\n \"profileId\": \"\u003cvar class=\"apiparam\" translate=\"no\"\u003euser's unique Google Workspace profile ID\u003c/var\u003e\",\n \"key\": \"\u003cvar class=\"apiparam\" translate=\"no\"\u003econsumer key of requestor in an OAuth 2LO request\u003c/var\u003e\"\n },\n \"ownerDomain\": \"example.com\",\n \"ipAddress\": \"\u003cvar class=\"apiparam\" translate=\"no\"\u003euser's IP address\u003c/var\u003e\",\n \"events\": [\n {\n \"type\": \"GROUP_SETTINGS\",\n \"name\": \"CREATE_GROUP\",\n \"parameters\": [\n {\n \"name\": \"GROUP_EMAIL\",\n \"value\": \"helpdesk@example.com\",\n \"intValue\": \"\",\n \"boolValue\": \"\"\n }\n ]\n }\n ]\n }\n ]\n }\n```"]]
