Yönetici etkinliği raporu, hesabınızdaki tüm yöneticilerin Yönetici Konsolu etkinlikleriyle ilgili bilgileri döndürür. Her raporda, yönetici adı veya belirli bir Yönetici Konsolu etkinliği gibi rapora özel parametrelerle temel rapor uç nokta isteği kullanılır. Her rapor için maksimum süre son 180 gündür.
Yönetici etkinliği raporu yalnızca Müşteri Sözleşmeniz uyarınca yasal amaçlarla kullanılabilir. Bu raporlar Google Workspace, Education ve ISP hesapları için geçerlidir.
Tüm yönetim etkinliklerini alma
Bir hesap için yapılan tüm yönetim etkinliklerinin raporunu almak üzere aşağıdaki GET HTTP isteğini kullanın ve yetkilendirme belgelerinde açıklanan yetkilendirme jetonunu ekleyin. İsteğin sorgu dizeleri ve yanıt özellikleri hakkında daha fazla bilgi için API Referansı'na bakın.
Okunabilirliği artırmak açısından aşağıdaki örnekte satır sonları kullanılmıştır:
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, hesabınızın son 180 gündeki tüm yönetim etkinlikleriyle ilgili bir rapor alınır. Bu, bir rapor için izin verilen maksimum süredir.
maxResults sorgu dizesi ise bu raporun, rapor sayfası başına iki etkinlik içerdiğini belirler. API yanıtı örneği için JSON yanıtı örneği bölümüne bakın:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/admin?maxResults=2
Aşağıdaki örnek, bir müşterinin son 180 gün içindeki tüm yönetim etkinlikleriyle ilgili bir rapor alı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
Tüm etkinlikleri yöneticiye göre alma
Belirli bir yönetici tarafından yapılan tüm Yönetici Konsolu etkinliklerinin raporunu almak için aşağıdaki GET HTTP isteğini kullanın ve yetkilendirme belgelerinde açıklanan yetkilendirme jetonunu ekleyin. 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.
Okunabilirliği artırmak açısından aşağıdaki örnekte satır sonları kullanılmıştır:
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, john@example.com tarafından yapılan Yönetici Konsolu uygulamasındaki tüm değişikliklerle ilgili bir rapor alınır ve yanıt, OLD_VALUE değeri ALLOW_CAMERA olan tüm etkinlikleri döndürecek şekilde filtrelenir. API yanıtı örneği için JSON yanıtı örneği bölümüne bakın.
Etkinlikler hakkında bilgi edinmek için yönetici etkinlik adları bölümüne bakın:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/john@example.com /applications/admin?maxResults=2&filters=OLD_VALUE==ALLOW_CAMERA
Etkinlik adına göre tüm etkinlikleri alma
Belirli bir etkinlik adına ait tüm etkinliklerin raporunu almak için aşağıdaki GET HTTP isteğini kullanın ve yetkilendirme belgelerinde açıklanan yetkilendirme jetonunu ekleyin. eventName bilgileri için yönetici
olay adları referans bilgilerine bakın. İsteğin sorgu dizeleri ve yanıt özellikleri hakkında daha fazla bilgi için API Referansı'na bakın.
Okunabilirliği artırmak açısından aşağıdaki örnekte satır sonları kullanılmıştır:
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 örnekte, kullanıcının soyadını değiştirme işleminin tüm Yönetici Konsolu örnekleri için bir rapor alınır. API yanıtı örneği için JSON yanıtı örneği bölümüne bakın:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all /applications/admin?maxResults=1&eventName=CHANGE_LAST_NAME
Tüm etkinlikleri etkinliğe ve yöneticiye göre alma
Belirli bir yönetici tarafından yapılan belirli bir etkinlik adıyla ilgili tüm Yönetici Konsolu değişikliklerinin raporunu almak için aşağıdaki GET HTTP isteğini kullanın ve yetkilendirme belgelerinde açıklanan yetkilendirme jetonunu ekleyin. userKey, rapordaki yöneticinin birincil e-posta adresidir. eventName bilgileri için yönetici
olay adları referans bilgilerine bakın. İsteğin sorgu dizeleri ve yanıt özellikleri hakkında daha fazla bilgi için API Referansı'na bakın.
Okunabilirliği artırmak açısından aşağıdaki örnekte satır sonları kullanılmıştır:
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 örnekte, john@example.com tarafından yapılan ve belirli bir kullanıcının soyadında Yönetici Konsolu'nda yapılan tüm değişikliklerle ilgili bir rapor alınmaktadır. API yanıtı örneği için JSON yanıtı örneği bölümüne bakın:
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 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
olay adları referans bilgilerine bakı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 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": "" } ] } ] } ] }