Method: activities.list

Belirli bir müşterinin hesabı ve uygulaması (ör. Yönetici Konsolu uygulaması veya Google Drive uygulaması) için etkinliklerin listesini alır. Daha fazla bilgi için yönetici ve Google Drive etkinlik raporlarıyla ilgili kılavuzlara bakın. Etkinlik raporunun parametreleri hakkında daha fazla bilgi için etkinlik parametreleri referans kılavuzlarına bakın.

HTTP isteği

GET https://admin.googleapis.com/admin/reports/v1/activity/users/{userKey or all}/applications/{applicationName}

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
userKey

string

Verilerin filtrelenmesi gereken profil kimliğini veya kullanıcı e-posta adresini temsil eder. Tüm bilgiler için all veya kullanıcının benzersiz Google Workspace profil kimliği ya da birincil e-posta adresi için userKey olabilir. Silinmiş bir kullanıcı olmamalıdır. Silinen bir kullanıcı için Directory API'de showDeleted=true ile users.list çağrısı yapın, ardından döndürülen ID değerini userKey olarak kullanın.
applicationName

enum (ApplicationName)

Etkinliklerin alınacağı uygulama adı.

Sorgu parametreleri

Parametreler
actorIpAddress

string

Etkinliğin gerçekleştirildiği ana makinenin İnternet Protokolü (IP) adresi. Bu, etkinliği raporlanan kullanıcının IP adresini kullanarak bir raporun özetini filtrelemenin ek bir yoludur. Bu IP adresi, kullanıcının fiziksel konumunu yansıtabilir veya yansıtmayabilir. Örneğin, IP adresi kullanıcının proxy sunucusunun adresi veya sanal özel ağ (VPN) adresi olabilir. Bu parametre hem IPv4 hem de IPv6 adres sürümlerini destekler.
customerId

string

Verileri alınacağı müşterinin benzersiz kimliği.
endTime

string

Raporda gösterilen zaman aralığının sonunu ayarlar. Tarih, RFC 3339 biçiminde olmalıdır (ör. 2010-10-28T10:26:35.000Z). Varsayılan değer, API isteğinin yaklaşık süresidir. API raporlarında üç temel zaman kavramı vardır:

  • API'nin rapor isteğinin tarihi: API'nin raporu oluşturup aldığı zaman.
  • Raporun başlangıç zamanı: Raporda gösterilen zaman aralığının başlangıcı. startTime, endTime'ten (belirtildiyse) ve istek gönderildiği andaki mevcut zamandan önce olmalıdır. Aksi takdirde API bir hata döndürür.
  • Raporun bitiş zamanı: Raporda gösterilen zaman aralığının sonu. Örneğin, bir raporda özetlenen etkinliklerin zaman aralığı Nisan'da başlayıp Mayıs ayında sona erebilir. Raporun kendisi Ağustos'ta istenebilir.
endTime belirtilmezse rapor, startTime tarihinden geçerli zamana kadar veya startTime 180 günden daha eskiyse en son 180 güne ait tüm etkinlikleri döndürür.
eventName

string

API tarafından sorgulanan etkinliğin adı. Her eventName, API'nin etkinlik türlerine göre düzenlediği belirli bir Google Workspace hizmeti veya özelliğiyle ilgilidir. Yönetici Konsolu uygulamasının raporlarındaki Google Takvim etkinlikleri buna örnek gösterilebilir. API tarafından bildirilen tüm Takvim eventName etkinlikleri Takvim Ayarları type yapısında bulunur. Yönetici bir Takvim ayarını değiştirdiğinde, API bu etkinliği Takvim Ayarları type ve eventName parametrelerinde bildirir. eventName sorgu dizeleri ve parametreleri hakkında daha fazla bilgi için yukarıdaki applicationName bölümünde çeşitli uygulamalara ait etkinlik adlarının listesine bakın.
filters

string

filters sorgu dizesi, ilişkisel operatörler tarafından manipüle edilen etkinlik parametrelerinden oluşan virgülle ayrılmış bir listetir. Etkinlik parametreleri {parameter1 name}{relational operator}{parameter1 value},{parameter2 name}{relational operator}{parameter2 value},... biçimindedir

Bu etkinlik parametreleri belirli bir eventName ile ilişkilidir. İsteğin parametresi eventName alanına ait değilse boş bir rapor döndürülür. Her uygulama için kullanılabilen eventName alanları ve ilişkili parametreleri hakkında daha fazla bilgi edinmek istiyorsanız ApplicationName tablosuna gidin, ardından istediğiniz uygulamanın Ek'indeki Etkinlik Etkinlikleri sayfasını tıklayın.

Aşağıdaki Drive etkinliği örneklerinde, döndürülen liste, doc_id parametre değerinin ilişkisel operatör tarafından tanımlanan koşullarla eşleştiği tüm edit etkinliklerinden oluşur. İlk örnekte istek, 12345 değerine eşit bir doc_id değerine sahip tüm düzenlenmiş dokümanları döndürür. İkinci örnekte rapor, doc_id değerinin 98765 değerine eşit olmadığı tüm düzenlenmiş dokümanları döndürür. <> operatörü, isteğin sorgu dizesinde (%3C%3E) URL olarak kodlanır:

GET...&eventName=edit&filters=doc_id==12345
GET...&eventName=edit&filters=doc_id%3C%3E98765

filters sorgusu şu ilişkisel operatörleri destekler:

  • ==: "eşittir".
  • <>: "eşit değil". URL kodlamalı olmalıdır (%3C%3E).
  • <: "Daha az". URL kodlamalı olmalıdır (%3C).
  • <=: "Küçük veya eşittir". URL olarak kodlanmış (%3C=) olmalıdır.
  • >: "Büyüktür". URL olarak kodlanmış olmalıdır (%3E).
  • >= - "büyüktür veya eşittir". URL olarak kodlanmış olmalıdır (%3E=).

Not: API, aynı parametrenin birden fazla değerini kabul etmez. API isteğinde bir parametre birden fazla kez sağlanırsa API yalnızca bu parametrenin son değerini kabul eder. Ayrıca, API isteğinde geçersiz bir parametre sağlanırsa API bu parametreyi yoksayıp kalan geçerli parametrelere karşılık gelen yanıtı döndürür. Hiçbir parametre istenmezse tüm parametreler döndürülür.
maxResults

integer

Her yanıt sayfasında kaç etkinlik kaydının gösterileceğini belirler. Örneğin, istek maxResults=1 değerini ayarlarsa ve raporda iki etkinlik varsa raporda iki sayfa vardır. Yanıtın nextPageToken mülkünde ikinci sayfanın jetonu bulunur. maxResults sorgu dizesi istekte isteğe bağlıdır. Varsayılan değer 1.000'dir.
orgUnitID

string

Rapor oluşturulacak kuruluş biriminin kimliği. Etkinlik kayıtları yalnızca belirtilen kuruluş biriminde yer alan kullanıcılar için gösterilir.

pageToken

string

Sonraki sayfayı belirtmek için kullanılan jeton. Birden fazla sayfa içeren bir raporda yanıtta nextPageToken mülkü bulunur. Raporun sonraki sayfasını almak için takip isteğinizde pageToken sorgu dizesine nextPageToken değerini girin.
startTime

string

Raporda gösterilen zaman aralığının başlangıcını ayarlar. Tarih, RFC 3339 biçiminde olmalıdır (ör. 2010-10-28T10:26:35.000Z). Rapor, startTime ile endTime arasındaki tüm etkinlikleri döndürür. startTime, endTime (belirtilmişse) ve isteğin yapıldığı geçerli zamandan önce olmalıdır, aksi takdirde API hata döndürür.
groupIdFilter

string

Kullanıcı etkinliklerinin filtrelendiği, virgül ile ayrılmış grup kimlikleri (gizlenmiş). Yani yanıtta yalnızca burada belirtilen grup kimliklerinden en az birine ait olan kullanıcıların etkinlikleri yer alır. Biçim: "id:abc123,id:xyz456"

İstek içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

Etkinlik koleksiyonu için JSON şablonu.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "kind": string,
  "etag": string,
  "items": [
    {
      object (Activity)
    }
  ],
  "nextPageToken": string
}
Alanlar
kind

string

API kaynağının türü. Etkinlik raporu için değer reports#activities olur.
etag

string

Kaynağın ETag'i.
items[]

object (Activity)

Yanıttaki her etkinlik kaydedilir.
nextPageToken

string

Raporun sonraki sayfasını almak için kullanılan jeton. nextPageToken değeri, isteğin pageToken sorgu dizesinde kullanılır.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/admin.reports.audit.readonly

Daha fazla bilgi için Yetkilendirme kılavuzunu inceleyin.

ApplicationName

Sıralamalar
access_transparency

Google Workspace Erişim Şeffaflığı etkinlik raporları, farklı türde Erişim Şeffaflığı etkinlik etkinlikleri hakkında bilgi döndürür.
admin

Yönetici Konsolu uygulamasının etkinlik raporları, farklı türde yönetici etkinliği etkinlikleri hakkında hesap bilgileri döndürür.
calendar

Google Takvim uygulamasının etkinlik raporları, çeşitli Takvim etkinliği etkinlikleri hakkında bilgi döndürür.
chat Chat etkinliği raporları, çeşitli Chat etkinliği etkinlikleri hakkında bilgi döndürür.
drive

Google Drive uygulamasının etkinlik raporları, çeşitli Google Drive etkinlik etkinlikleri hakkında bilgi döndürür. Drive etkinlik raporu yalnızca Google Workspace Business ve Enterprise müşterileri tarafından kullanılabilir.
gcp Google Cloud Platform uygulamasının etkinlik raporları, çeşitli GCP etkinlik etkinlikleri hakkında bilgi döndürür.
gplus Google+ uygulamasının etkinlik raporları, çeşitli Google+ etkinlik etkinlikleri hakkında bilgi döndürür.
groups

Google Gruplar uygulamasının etkinlik raporları, çeşitli Gruplar etkinlik etkinlikleri hakkında bilgi döndürür.
groups_enterprise

Enterprise Groups etkinlik raporları, çeşitli Enterprise Groups etkinlik etkinlikleri hakkında bilgi döndürür.
jamboard Jamboard etkinlik raporları, çeşitli Jamboard etkinlik etkinlikleri hakkında bilgi döndürür.
login

Giriş uygulamasının etkinlik raporları, farklı giriş etkinliği etkinlikleri türleriyle ilgili hesap bilgilerini döndürür.
meet Meet denetimi etkinlik raporu, farklı Meet denetimi etkinlik etkinlikleri türleri hakkında bilgi döndürür.
mobile Cihaz Denetleme etkinliği raporu, farklı türde Cihaz Denetleme etkinliği etkinlikleri hakkında bilgi döndürür.
rules

Kurallar etkinlik raporu, farklı Kural etkinliği etkinlikleri hakkında bilgi döndürür.
saml

SAML etkinlik raporu, farklı SAML etkinlik etkinlikleri türleri hakkında bilgi döndürür.
token

Jeton uygulamasının etkinlik raporları, farklı jeton etkinliği etkinlikleri türleriyle ilgili hesap bilgilerini döndürür.
user_accounts

Kullanıcı Hesapları uygulamasının etkinlik raporları, farklı türde Kullanıcı Hesapları etkinliği etkinlikleri hakkında hesap bilgileri döndürür.
context_aware_access

Bağlama duyarlı erişim etkinliği raporları, bağlama duyarlı erişim kuralları nedeniyle kullanıcıların erişimlerinin reddedildiği etkinliklerle ilgili bilgileri döndürür.
chrome

Chrome etkinlik raporları, Chrome Tarayıcı ve Chrome OS etkinlikleri hakkında bilgi döndürür.
data_studio Data Studio etkinlik raporları, çeşitli Data Studio etkinlik etkinlikleri türleri hakkında bilgi döndürür.
keep Keep uygulamasının etkinlik raporları, çeşitli Google Keep etkinlik etkinlikleri hakkında bilgi döndürür. Keep etkinlik raporu yalnızca Google Workspace Business ve Enterprise müşterileri tarafından kullanılabilir.
vault Apps Kasası etkinliği raporları, çeşitli Apps Kasası etkinliği türleri hakkında bilgi döndürür.

Etkinlik

Etkinlik kaynağı için JSON şablonu.

JSON gösterimi 
{
  "kind": string,
  "etag": string,
  "ownerDomain": string,
  "ipAddress": string,
  "events": [
    {
      "type": string,
      "name": string,
      "parameters": [
        {
          "messageValue": {
            "parameter": [
              {
                object (NestedParameter)
              }
            ]
          },
          "name": string,
          "value": string,
          "multiValue": [
            string
          ],
          "intValue": string,
          "multiIntValue": [
            string
          ],
          "boolValue": boolean,
          "multiMessageValue": [
            {
              "parameter": [
                {
                  object (NestedParameter)
                }
              ]
            }
          ]
        }
      ]
    }
  ],
  "id": {
    "time": string,
    "uniqueQualifier": string,
    "applicationName": string,
    "customerId": string
  },
  "actor": {
    "profileId": string,
    "email": string,
    "callerType": string,
    "key": string
  }
}
Alanlar
kind

string

API kaynağının türü. Etkinlik raporu için değer audit#activity şeklindedir.
etag

string

Girişin ETag'ı.
ownerDomain

string

Bu, raporun etkinliğinden etkilenen alandır. Örneğin, Yönetici Konsolu'nun veya Drive uygulamasının doküman sahibinin alanı.
ipAddress

string

İşlemi gerçekleştiren kullanıcının IP adresi. Bu, Google Workspace'e giriş yapan kullanıcının İnternet Protokolü (IP) adresidir. Bu adres, kullanıcının fiziksel konumunu yansıtabilir veya yansıtmayabilir. Örneğin, IP adresi kullanıcının proxy sunucusunun adresi veya sanal özel ağ (VPN) adresi olabilir. API IPv4 ve IPv6'yı destekler.
events[]

object

Rapordaki etkinlik etkinlikleri.
events[].type

string

Etkinlik türü. Bir yöneticinin değiştirdiği Google Workspace hizmeti veya özelliği, eventName özelliğini kullanarak bir etkinliği tanımlayan type mülkünde tanımlanır. API'nin type kategorilerinin tam listesi için yukarıdaki applicationName bölümünde çeşitli uygulamalara ait etkinlik adlarının listesine bakın.
events[].name

string

Etkinliğin adı. Bu, API tarafından raporlanan etkinliğin özel adıdır. Her eventName, API'nin etkinlik türlerine göre düzenlediği belirli bir Google Workspace hizmeti veya özelliğiyle ilgilidir.
Genel olarak eventName istek parametreleri için:

  • eventName belirtilmezse rapor, eventName için mümkün olan tüm örnekleri döndürür.
  • Bir eventName isteğinde bulunduğunuzda API'nin yanıtı, söz konusu eventName öğesini içeren tüm etkinlikleri döndürür.

eventName mülkleri hakkında daha fazla bilgi için yukarıdaki applicationName bölümünde çeşitli uygulamalara ait etkinlik adlarının listesini inceleyin.
events[].parameters[]

object

Çeşitli uygulamalar için parametre değeri çiftleri. eventName parametreleri hakkında daha fazla bilgi için yukarıda, applicationName bölümünde yer alan çeşitli uygulamalara ait etkinlik adları listesine bakın.
events[].parameters[].messageValue

object

Bu parametreyle ilişkili iç içe yerleştirilmiş parametre değeri çiftleri. Bir parametrenin karmaşık değer türü, parametre değerlerinin listesi olarak döndürülür. Örneğin, adres parametresi [{parameter: [{name: city, value: abc}]}] gibi bir değere sahip olabilir.
events[].parameters[].messageValue.parameter[]

object (NestedParameter)

Parametre değerleri
events[].parameters[].name

string

Parametrenin adı.
events[].parameters[].value

string

Parametrenin dize değeri.
events[].parameters[].multiValue[]

string

Parametrenin dize değerleri.
events[].parameters[].intValue

string (int64 format)

Parametrenin tam sayı değeri.
events[].parameters[].multiIntValue[]

string (int64 format)

Parametrenin tam sayı değerleri.
events[].parameters[].boolValue

boolean

Parametrenin Boole değeri.
events[].parameters[].multiMessageValue[]

object

activity.list (messageValue nesne)
events[].parameters[].multiMessageValue[].parameter[]

object (NestedParameter)

Parametre değerleri
id

object

Her etkinlik kaydının benzersiz tanımlayıcısı.
id.time

string

Etkinliğin gerçekleştiği zaman. Bu değer, saniye cinsinden UNIX sıfır zamanıdır.
id.uniqueQualifier

string (int64 format)

Birden fazla etkinliğin aynı saate sahip olması durumunda benzersiz niteleyici.
id.applicationName

string

Etkinliğin ait olduğu uygulama adı. Olası değerler için yukarıdaki applicationName bölümünde uygulama listesine bakın.
id.customerId

string

Google Workspace hesabının benzersiz tanımlayıcısı.
actor

object

İşlemi yapan kullanıcı.
actor.profileId

string

Aktörün benzersiz Google Workspace profil kimliği. Aktör bir Google Workspace kullanıcısı değilse bu değer bulunmayabilir veya yer tutucu kimlik görevi gören 105250506097979753968 numarası olabilir.
actor.email

string

İşlemi gerçekleştiren kullanıcının birincil e-posta adresi. İşlemi yapan kişiyle ilişkili bir e-posta adresi yoksa eksik olabilir.
actor.callerType

string

İşlemi gerçekleştiren kullanıcının türü.
actor.key

string

Yalnızca callerType KEY olduğunda mevcuttur. OAuth 2LO API isteklerinde istek sahibinin consumer_key değeri veya robot hesapları için bir tanımlayıcı olabilir.