Yönetici etkinliği raporu, hesabınızın tüm yöneticilerinin Yönetici Konsolu etkinliklerine ilişkin bilgileri döndürür. Her rapor, yönetici adı veya belirli bir Yönetici konsolu etkinliği gibi rapora özgü parametreleri içeren temel rapor uç noktası isteğini kullanır. Her rapor için maksimum dönem son 180 gündür.
Yönetici etkinliği raporu, Müşteri Sözleşmenize uygun şekilde yalnızca yasal amaçlarla kullanılabilir. Ayrıca bu raporlar Google Workspace, Education ve İSS hesapları için geçerlidir.
Tüm yönetim etkinliklerini alın
Bir hesapla ilgili gerçekleştirilen tüm yönetimsel etkinliklerin raporunu almak için aşağıdaki GET HTTP isteğini kullanın ve yetkilendirme belgelerinde açıklanan yetkilendirme jetonunu dahil edin. İsteğin sorgu dizeleri ve yanıt özellikleri hakkında daha fazla bilgi için API Referansı'na bakın. Okunabilirlik açısından aşağıdaki örnek, satır sonları ile biçimlendirilmiştir:
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
Aşağıdaki örnekte, son 180 gün içinde hesabınızın tüm yönetici etkinlikleri hakkında bir rapor bulunmaktadır. Bu, bir rapor için maksimum süredir. maxResults sorgu dizesi, bu raporun rapor sayfası başına iki etkinlik içerdiğini belirler. API yanıtı örneği için JSON yanıtı örneğini inceleyin:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/admin?maxResults=2
Aşağıdaki örnekte, bir müşterinin son 180 gün içindeki tüm yönetici etkinlikleri hakkında bir rapor alınmıştır. customerId, raporun hangi müşteri için alınacağını belirtir.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/admin?customerId=C03az79cb
Yöneticiye göre tüm etkinlikleri al
Belirli bir yönetici tarafından gerçekleştirilen tüm Yönetici Konsolu etkinliklerinin raporunu almak için aşağıdaki GET HTTP isteğini kullanın ve yetkilendirme dokümanlarında açıklanan yetkilendirme jetonunu dahil edin. userKey, rapordaki yöneticinin birincil e-posta adresidir. İsteğin sorgu dizeleri ve yanıt özellikleri hakkında daha fazla bilgi için API Referansı'na bakın. Okunabilirlik açısından aşağıdaki örnek, satır sonları ile biçimlendirilmiştir:
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
Aşağıdaki örnekte, Yönetici Konsolu uygulamasında john@example.com tarafından yapılan tüm değişiklikler hakkında bir rapor alınmıştır ve yanıt, ALLOW_CAMERA değerine eşit OLD_VALUE olan tüm etkinlikleri döndürecek şekilde filtrelenir. API yanıtı örneği için JSON yanıtı örneğini inceleyin. Etkinliklerle ilgili bilgiler için de yönetici etkinlik adlarına göz atın:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/john@example.com /applications/admin?maxResults=2&filters=OLD_VALUE==ALLOW_CAMERA
Tüm etkinlikleri etkinlik adına göre al
Belirli bir etkinlik adıyla ilişkili tüm etkinliklerin raporunu almak için aşağıdaki GET HTTP isteğini kullanın ve yetkilendirme belgelerinde açıklanan yetkilendirme jetonunu dahil edin. eventName bilgileri için yönetici etkinlik adları referans bilgilerine göz atın. İsteğin sorgu dizeleri ve yanıt özellikleri hakkında daha fazla bilgi için API Referansı'na bakın. Okunabilirlik açısından aşağıdaki örnek, satır sonları ile biçimlendirilmiştir:
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
Aşağıdaki örnek, bir kullanıcının soyadının değiştirilmesiyle ilgili tüm Yönetici Konsolu örnekleri için bir rapor almaktadır. API yanıtı örneği için JSON yanıtı örneğini inceleyin:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/admin?maxResults=1&eventName=CHANGE_LAST_NAME
Etkinliğe ve yöneticiye göre tüm etkinlikleri al
Belirli bir etkinlik adı ile ilgili olarak belirli bir yönetici tarafından yapılan tüm Yönetici Konsolu değişikliklerinin raporunu almak için aşağıdaki GET HTTP isteğini kullanın ve yetkilendirme dokümanlarında açıklanan yetkilendirme jetonunu dahil edin. userKey, rapordaki yöneticinin birincil e-posta adresidir. eventName bilgileri için yönetici etkinlik adları referans bilgilerine göz atın. İsteğin sorgu dizeleri ve yanıt özellikleri hakkında daha fazla bilgi için API Referansı'na bakın. Okunabilirlik açısından aşağıdaki örnek, satır sonları ile biçimlendirilmiştir:
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
Aşağıdaki örnek, Yönetici Konsolu'nda belirli bir kullanıcının soyadında john@example.com tarafından yapılan tüm değişiklikler için bir rapor getirir. API yanıtı örneği için JSON yanıtı örneğini inceleyin:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/john@example.com /applications/admin?maxResults=1&eventName=CHANGE_LAST_NAME
Yönetici etkinliği raporu örneği JSON yanıtı
Başarılı bir yanıt, bir HTTP 200 durum kodu döndürür. Yanıt, durum koduyla birlikte bir rapor döndürür. eventName bilgileri için yönetici etkinlik adları referans bilgilerine göz atın. İsteğin URL sorgu dizeleri ve yanıt özellikleri hakkında daha fazla bilgi için API Referansı'na bakın.
{
"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": ""
}
]
}
]
}
]
}