דוח פעילות של אדמין

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