Method: activities.watch

Hesap etkinlikleriyle ilgili bildirim almaya başlayın. Daha fazla bilgi 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

string

Verilerin filtrelenmesi gereken profil kimliğini veya kullanıcı e-posta adresini 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. Silinen 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 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 zamanıdır. Bir API raporunda üç temel zaman kavramı vardır:

  • API'nin rapor isteği tarihi: API'nin raporu oluşturduğu ve aldığı tarih.
  • 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'ta sona erebilir. Raporun kendisi ise 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 olarak gösterilebilir. Takvim Ayarları type yapısı, API tarafından raporlanan tüm Takvim eventName etkinliklerini içerir. 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 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ığı 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 olarak kodlanmış olmalıdır (%3C%3E).
  • <: "Daha az". URL kodlamalı olmalıdır (%3C).
  • <=: "Küçük veya eşittir". URL kodlamalı olmalıdır (%3C=).
  • >: "Büyüktür". URL olarak kodlanmış olmalıdır (%3E).
  • >=: "Büyük 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 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 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
(deprecated)

string

Deprecated. Bu alanın desteği sonlandırıldı ve artık desteklenmiyor.

Raporlanılacak kuruluş biriminin kimliği. Etkinlik kayıtları yalnızca belirtilen kuruluş birimine ait 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 bir sonraki sayfasını almak için gönderdiğiniz takip isteğinde, 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'ten (belirtildiyse) ve istek gönderildiği andaki mevcut zamandan önce olmalıdır. Aksi takdirde API bir 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, 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 benzer 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ının geçerlilik süresinin sona erdiği tarih ve saat (milisaniye cinsinden Unix zaman damgası olarak ifade edilir). İsteğe bağlı.
type

string

Bu kanal için kullanılan yayın 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, bir HTTP POST, PUT veya PATCH mesajının gövdesinde gönderilen ve istekle ilgili önemli bilgiler içeren verilerdir. İsteğe bağlı.
params

map (key: string, value: string)

Yayınlama 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 kimlik. Farklı API sürümlerinde kararlıdır.
resourceUri

string

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

string

Bu kaynağın "api#channel" olan değişikliklerini izlemek için kullanılan bir 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ı 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 raporunu yalnızca Google Workspace Business ve Google Workspace Enterprise müşterileri kullanabilir.
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.