Method: activities.list

Yönetici konsolu uygulaması veya Google Drive uygulaması gibi, belirli bir müşterinin hesabına ve uygulamasına ilişkin etkinliklerin listesini alır. Daha fazla bilgi için yönetici ve Google Drive etkinlik raporları kılavuzlarına göz atı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 or all

string

Verilerin filtrelenmesi gereken profil kimliğini veya kullanıcı e-postasını temsil eder. Tüm bilgiler için all, kullanıcının benzersiz Google Workspace profil kimliği veya 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 öğesini 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 rapor ö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 bir sanal özel ağ (VPN) adresi olabilir. Bu parametre hem IPv4 hem de IPv6 adres sürümlerini destekler.
customerId

string

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

string

Raporda gösterilen zaman aralığının sonunu ayarlar. Tarih, RFC 3339 biçiminde (ör. 2010-10-28T10:26:35.000Z) olur. Varsayılan değer, API isteğinin yaklaşık süresidir. Bir API raporunda üç 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 değeri, endTime (belirtilmişse) ve isteğin yapıldığı geçerli zamandan önce olmalıdır, aksi takdirde API 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'ta sona erebilir. Raporun kendisi Ağustos'ta istenebilir.
endTime belirtilmezse rapor, startTime tarihinden geçerli zamana veya startTime değeri 180 günden daha uzunsa en son 180 güne kadar olan tüm etkinlikleri döndürür.
eventName

string

API tarafından sorgulanan etkinliğin adı. Her eventName, API'nin etkinlik türleri halinde düzenlediği belirli bir Google Workspace hizmeti veya özelliğiyle ilişkilidir. Yönetici konsolu uygulamasının raporlarındaki Google Takvim etkinlikleri buna örnek olarak 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ıda, applicationName içinde yer alan çeşitli uygulamalara ait etkinlik adları listesine bakın.
filters

string

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

Bu etkinlik parametreleri belirli bir eventName ile ilişkilendirilir. İsteğin parametresi eventName öğesine ait değilse boş bir rapor döndürülür. Her uygulamaya ait kullanılabilir eventName alanları ve bunlarla ilişkili parametreler hakkında daha fazla bilgi için ApplicationName (Uygulama Adı) tablosuna gidip istediğiniz uygulamanın Ek bölümünde yer alan 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 etkinliklerini içerir. İlk örnekte istek, 12345 değerine eşit olan 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ığı düzenlenmiş dokümanları döndürür. <> operatörü, isteğin sorgu dizesinde (%3C%3E) URL olarak kodlanmıştı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 olarak kodlanmış olmalıdır (%3C%3E).
  • < - "küçüktür". URL olarak kodlanmış (%3C) olmalıdır.
  • <= - "küçüktür veya eşittir". URL olarak kodlanmış (%3C=) olmalıdır.
  • > - "büyüktür". URL olarak kodlanmış (%3E) olmalıdır.
  • >= - "büyüktür veya eşittir". URL olarak kodlanmış (%3E=) olmalıdır.

Not: API, aynı parametrenin birden fazla değerini kabul etmez. Bir parametre, API isteğinde birden fazla kez sağlanırsa API yalnızca söz konusu parametrenin son değerini kabul eder. Ayrıca, API isteğinde geçersiz bir parametre sağlanırsa API bu parametreyi yoksayar ve 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 raporun iki sayfası vardır. Yanıtın nextPageToken özelliği, ikinci sayfanın jetonuna sahiptir. maxResults sorgu dizesi istekteki 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ı belirtme jetonu. Birden fazla sayfa içeren bir raporun yanıtta nextPageToken özelliği bulunur. Raporun sonraki sayfasını alma konusundaki 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 (ör. 2010-10-28T10:26:35.000Z) olur. 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ülle ayrılmış grup kimlikleri (karartılmış). Yani yanıt, yalnızca burada bahsedilen grup kimliklerinden en az birinin parçası olan kullanıcılara yönelik etkinlikleri içerir. 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 şeklindedir.
etag

string

Kaynağın eTag'i.
items[]

object (Activity)

Yanıttaki her etkinlik kaydedilir.
nextPageToken

string

Raporun takip eden 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ı Erişim Şeffaflığı etkinlikleri hakkında bilgi döndürür.
admin

Yönetici konsolu uygulamasının etkinlik raporları, farklı yönetici etkinliği etkinlikleri ile ilgili hesap bilgilerini 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+ etkinliği 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 Gruplar etkinlik raporları, çeşitli Kurumsal grup etkinliği 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 denetleme etkinlik raporu, farklı Meet denetleme etkinliği etkinlikleri hakkında bilgi döndürür.
mobile Cihaz Denetimi etkinlik raporu, farklı Cihaz Denetimi etkinlik etkinliği türleriyle ilgili bilgileri 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 etkinliği türleri hakkında bilgi döndürür.
token

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

Kullanıcı Hesapları uygulamasının etkinlik raporları, farklı Kullanıcı Hesapları etkinlik etkinliği türleriyle ilgili hesap bilgilerini döndürür.
context_aware_access

Bağlama duyarlı erişim etkinliği raporları, kullanıcıların Bağlama duyarlı erişim kuralları nedeniyle reddedilen etkinlikler.
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 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ı etkinlik raporları, çeşitli Apps Kasası etkinlik türleri hakkında bilgi döndürür.

Etkinlik

Etkinlik kaynağının 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'i.
ownerDomain

string

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

string

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

object

Rapordaki etkinlik etkinlikleri.
events[].type

string

Etkinliğin türü. Yöneticinin değiştirdiği Google Workspace hizmeti veya özelliği, eventName özelliğini kullanarak etkinlikleri tanımlayan type özelliğinde tanımlanır. API'nin type kategorilerinin tam listesi için yukarıda, applicationName içinde yer alan çeşitli uygulamalara ait etkinlik adlarının listesine bakın.
events[].name

string

Etkinliğin adı. Bu, API tarafından bildirilen etkinliğin adıdır. Ayrıca her eventName, belirli bir Google Workspace hizmeti veya özelliğiyle ilişkilidir. Bu hizmet veya özelliklerle ilgili API, etkinlik türleri halinde düzenlenir.
Genel olarak eventName istek parametreleri için:

  • Herhangi bir eventName sağlanmazsa rapor, eventName olası tüm örneklerini 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 özellikleri hakkında daha fazla bilgi için yukarıda applicationName bölümünde bulunan çeşitli uygulamalara ait etkinlik adları listesine bakın.
events[].parameters[]

object

Çeşitli uygulamalar için parametre değer ç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ğerleri listesi olarak döndürülür. Örneğin, adres parametresi [{parameter: [{name: city, value: abc}]}] değerine 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

messageValue nesne içeren activity.list var.
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 saat. Bu, saniye cinsinden UNIX dönem zamanıdır.
id.uniqueQualifier

string (int64 format)

Birden fazla etkinlik aynı zamana sahipse 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ıdır.
actor

object

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

string

İşlemi yapan kullanıcının benzersiz Google Workspace profili kimliği. İşlemi gerçekleştiren Google Workspace kullanıcısı değilse bu değer eksik olabilir veya yer tutucu kimlik olarak işlev gören 105250506097979753968 sayısı olabilir.
actor.email

string

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

string

Oyuncunun türü.
actor.key

string

Yalnızca callerType KEY olduğunda mevcut olur. OAuth 2LO API istekleri için istekte bulunanın consumer_key öğesi veya robot hesapları için bir tanımlayıcı olabilir.