Method: activities.watch

• HTTP isteği
• Yol parametreleri
• Sorgu parametreleri
• İstek metni
• Yanıt metni
  • JSON gösterimi
• Yetkilendirme kapsamları
• ApplicationName

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. 17 Aralık 2018'den önceki veriler filtrelenmiş sonuçlar arasında görünmez.
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.