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 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 (deprecated)	string Deprecated. Bu alan kullanımdan kaldırılmıştır ve artık desteklenmemektedir. Rapor oluşturulacak kuruluş biriminin kimliği. Etkinlik kayıtları yalnızca belirtilen kuruluş birimine ait olan kullanıcılar için gösterilir. 17 Aralık 2018 öncesine ait veriler, filtrelenmiş sonuçlar arasında görünmez.
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, SubscriptionChannel öğesinin bir örneğini içerir.

Yanıt gövdesi

Kaynak değişikliklerini izlemek için kullanılan bir 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 gönderilen rastgele dize. İsteğe bağlı.
expiration	string (int64 format) Bildirim kanalının süre sonunun milisaniye cinsinden, Unix zaman damgası olarak ifade edilen tarih ve saat. İ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 gönderildiği adrestir.
payload	boolean Yükün istenip istenmediğini gösteren bir Boole değeri. Yük, bir 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ınlama kanalı davranışını kontrol eden ek parametreler. İsteğe bağlı. "key": value çiftlerin 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ı.
resourceUri	string İzlenen kaynağın sürüme özgü tanımlayıcısı.
kind	string Bunu, "api#channel" adlı kaynakta yapılan değişiklikleri 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ılavuzu'na bakın.

ApplicationName

Etkinliklerin alınacağı uygulamanın adı.

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