Method: activities.watch

Hesap etkinlikleri için bildirim almaya başlayın. Daha fazla bilgi edinmek için Push Bildirimleri Alma başlıklı makaleyi inceleyin.

HTTP isteği

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

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, 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
(deprecated)

string

Deprecated Bu alan kullanımdan kaldırıldı ve artık desteklenmiyor.

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, SubscriptionChannel öğesinin bir örneğini içerir.

Yanıt gövdesi

Kaynak değişikliklerini izlemek için kullanılan bildirim kanalı.

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

JSON gösterimi 
{
  "id": string,
  "token": string,
  "expiration": string,
  "type": string,
  "address": string,
  "payload": boolean,
  "params": {
    string: string,
    ...
  },
  "resourceId": string,
  "resourceUri": string,
  "kind": string
}
Alanlar
id

string

Bu kanalı tanımlayan UUID veya benzeri bir benzersiz dize.
token

string

Bu kanal üzerinden her bildirimle birlikte hedef adrese teslim edilen rastgele bir dize. İsteğe bağlı.
expiration

string (int64 format)

Bildirim kanalı süre sonunun tarihi ve saati (milisaniye cinsinden Unix zaman damgası olarak belirtilir). İsteğe bağlı.
type

string

Bu kanal için kullanılan yayınlama mekanizmasının türü. Değer "web_hook" olarak ayarlanmalıdır.
address

string

Bu kanal için bildirimlerin iletildiği adres.
payload

boolean

Yükün istenip istenmediğini belirten bir Boole değeri. Yük; HTTP POST, PUT veya PATCH mesajının gövdesinde gönderilen ve istekle ilgili önemli bilgileri içeren verilerdir. İsteğe bağlı.
params

map (key: string, value: string)

Yayın kanalı davranışını kontrol eden ek parametreler. İsteğe bağlı.

"key": value çiftlerinin listesini içeren bir nesne. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
resourceId

string

Bu kanalda izlenen kaynağı tanımlayan opak bir kimlik. Farklı API sürümlerinde kararlı.
resourceUri

string

İzlenen kaynak için sürüme özgü bir tanımlayıcı.
kind

string

Bu kanalı, "api#channel" adlı kaynaktaki değişiklikleri izlemek için kullanılan bildirim kanalı olarak tanımlar.

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

Etkinliklerin alınacağı uygulama adı.

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 Google Workspace 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.