Method: activities.list

Belirli bir müşteri hesabı ve uygulamasındaki, Yönetici konsolu uygulaması veya Google Drive uygulaması gibi etkinliklerin listesini alır. Daha fazla bilgi için yönetici ve Google Drive etkinlik raporlarına ilişkin kılavuzlara 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

Verilerinin filtrelenmesi gereken profil kimliğini veya kullanıcı e-postasını 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. Silinmiş 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ğı uygulamanın adı.

Sorgu parametreleri

Parametreler
actorIpAddress

string

Etkinliğin gerçekleştiğ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ümünü 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 olmalıdır; örneğin, 2010-10-28T10:26:35.000Z. Varsayılan değer, API isteğinin yaklaşık süresidir. API raporlarında üç temel zaman kavramı bulunur:

  • 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 tarihinden (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 bitebilir. Raporun kendisi Ağustos'ta istenebilir.
endTime belirtilmezse rapor, startTime tarihinden geçerli saate kadar olan tüm etkinlikleri veya startTime, geçmişteki 180 günden daha eskiyse son 180 güne kadarki 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 bir örnek olarak gösterilebilir. API tarafından bildirilen tüm Takvim eventName etkinlikleri Takvim Ayarları type yapısında bulunur. Bir 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ı 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 bir uygulamaya ait eventName alanları ve ilişkili parametreleri hakkında daha fazla bilgi edinmek için ApplicationName tablosuna gidin ve ardından 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 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ğeri 98765 değerine eşit olmayan 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 sorguları şu ilişkisel operatörleri destekler:

  • ==—"eşittir".
  • <>—'eşit değildir'. URL olarak kodlanmış olmalıdır (%3C%3E).
  • <—"küçüktür". URL olarak kodlanmış olmalıdır (%3C).
  • <=—'küçük veya eşittir'. URL olarak kodlanmış olmalıdır (%3C=).
  • >—"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 çok 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. Buna ek olarak, 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 olarak ayarlandıysa ve raporda iki etkinlik varsa raporda iki sayfa olur. 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ş birimine ait olan kullanıcılar için gösterilir.

pageToken

string

Sonraki sayfayı belirtecek jeton. Birden fazla sayfa içeren bir raporun yanıtında nextPageToken özelliği vardır. Raporun sonraki sayfasını alma 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; örneğin, 2010-10-28T10:26:35.000Z. Rapor, startTime ile endTime arasındaki tüm etkinlikleri döndürür. startTime, endTime tarihinden (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 belirtilen grup kimliklerinden en az birinin parçası olan kullanıcılara ilişkin 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ü. Bir etkinlik raporu için bu değer reports#activities şeklindedir.
etag

string

Kaynağın ETag.
items[]

object (Activity)

Yanıttaki her etkinlik kaydı.
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ılavuzu'na bakın.

ApplicationName

Sıralamalar
access_transparency

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

Yönetici konsolu uygulamasının etkinlik raporları, farklı türlerdeki yönetici etkinliği etkinlikleri hakkında 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 etkinlik 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 etkinliği 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 etkinliği hakkında bilgi döndürür.
groups_enterprise

Kurumsal Gruplar etkinlik raporları, çeşitli Kurumsal grup etkinliği etkinlikleri hakkında bilgi döndürür.
jamboard Jamboard etkinlik raporları, çeşitli Jamboard etkinliği 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 etkinliği raporu, farklı türlerdeki Meet denetleme etkinlikleri hakkında bilgi döndürür.
mobile Cihaz Denetleme etkinliği raporu, farklı türlerdeki Cihaz Denetleme etkinlikleri hakkında bilgi döndürür.
rules

Kural etkinlik raporu, farklı Kural etkinliği etkinlikleri türleriyle ilgili bilgileri döndürür.
saml

SAML etkinlik raporu, farklı türlerdeki SAML etkinlik etkinlikleri hakkındaki bilgileri döndürür.
token

Jeton uygulamasının etkinlik raporları, farklı Jeton etkinliği etkinlikleri türleri hakkında hesap bilgilerini döndürür.
user_accounts

Kullanıcı Hesapları uygulamasının etkinlik raporları, farklı türlerdeki Kullanıcı Hesapları etkinlik 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şiminin 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 etkinliği 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 etkinliği raporunu yalnızca Google Workspace Business ve Enterprise müşterileri kullanabilir.
vault Apps Kasası etkinlik raporları, çeşitli Apps Kasası etkinlik 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ü. Bir etkinlik raporu için bu değer audit#activity şeklindedir.
etag

string

Girişin ETag.
ownerDomain

string

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

string

İşlemi yapan kullanıcının IP adresi. Bu, Google Workspace'e giriş yapan kullanıcının İnternet Protokolü (IP) adresidir. 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ü. 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 çeşitli uygulamaların etkinlik adlarının yukarıdaki applicationName listesine bakın.
events[].name

string

Etkinliğin adı. Bu, API tarafından bildirilen etkinliğin adıdır. Her eventName, API'nin etkinlik türleri halinde düzenlediği belirli bir Google Workspace hizmeti veya özelliğiyle ilişkilidir.
Genel olarak eventName istek parametresi için:

  • eventName özelliği verilmezse rapor, tüm olası eventName örneklerini döndürür.
  • Bir eventName isteğinde bulunduğunuzda API'nin yanıtı, bu eventName öğesini içeren tüm etkinlikleri döndürür.

eventName özellikleri 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.
events[].parameters[]

object

Çeşitli uygulamalara ilişkin parametre değer çiftleri. eventName 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.
events[].parameters[].messageValue

object

Bu parametreyle ilişkilendirilmiş iç içe geçmiş 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}]}] 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

messageValue nesne içeren actions.list.
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şme zamanı. Saniye cinsinden UNIX sıfır zamanıdır.
id.uniqueQualifier

string (int64 format)

Birden fazla etkinlik aynı zamana sahipse benzersiz niteleyicidir.
id.applicationName

string

Etkinliğin ait olduğu uygulama adı. Olası değerler için yukarıdaki applicationName ile ilgili 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 gerçekleştirenin benzersiz Google Workspace profil kimliği. İşlemi yapan kullanıcı Google Workspace kullanıcısı değilse bu değer eksik olabilir veya yer tutucu kimliği görevi gören 105250506097979753968 sayısı olabilir.
actor.email

string

İşlemi gerçekleştirenin birincil e-posta adresi. İşlemi gerçekleştirenle ilişkili bir e-posta adresi yoksa eksik olabilir.
actor.callerType

string

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

string

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