דוח הפעילות של מנהלי מערכת מחזיר מידע על הפעילויות של כל מנהלי המערכת בחשבון שלך במסוף 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 parameter relational operator parameter 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
תגובת JSON לדוגמה לדוח פעילות של אדמין
תגובה מוצלחת מחזירה קוד סטטוס HTTP 200. יחד עם קוד הסטטוס, התגובה תחזיר דוח. לקבלת מידע על eventName, אפשר לעיין בפרטי העזר לשמות אירועים של מנהלי מערכת. מידע נוסף על מחרוזות השאילתה של כתובת ה-URL של הבקשה ועל מאפייני התגובה זמין בהפניית API.
{
"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": ""
}
]
}
]
}
]
}