דוח פעילות האדמין מחזיר מידע על הפעילויות במסוף 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": ""
}
]
}
]
}
]
}