- HTTP isteği
- Yol parametreleri
- Sorgu parametreleri
- İstek metni
- Yanıt metni
- 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 |
Verilerinin filtrelenmesi gereken profil kimliğini veya kullanıcı e-postasını temsil eder. Tüm bilgiler için |
applicationName |
Etkinliklerin alınacağı uygulamanın adı. |
Sorgu parametreleri
Parametreler | |
---|---|
actorIpAddress |
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 |
Verileri alınacak müşterinin benzersiz kimliği. |
endTime |
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:
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 |
API tarafından sorgulanan etkinliğin adı. Her |
filters |
Bu etkinlik parametreleri belirli bir Aşağıdaki Drive etkinliği örneklerinde, döndürülen liste
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 |
Her yanıt sayfasında kaç etkinlik kaydının gösterileceğini belirler. Örneğin, istek |
orgUnitID |
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 |
Sonraki sayfayı belirtecek jeton. Birden fazla sayfa içeren bir raporun yanıtında |
startTime |
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, |
groupIdFilter |
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 |
Bu kanalı tanımlayan UUID veya benzer bir benzersiz dize. |
token |
Bu kanal üzerinden her bildirimle birlikte hedef adrese gönderilen rastgele dize. İsteğe bağlı. |
expiration |
Bildirim kanalının süre sonunun milisaniye cinsinden, Unix zaman damgası olarak ifade edilen tarih ve saat. İsteğe bağlı. |
type |
Bu kanal için kullanılan yayınlama mekanizmasının türü. Değer |
address |
Bu kanal için bildirimlerin gönderildiği adrestir. |
payload |
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 |
Yayınlama kanalı davranışını kontrol eden ek parametreler. İsteğe bağlı.
|
resourceId |
Bu kanalda izlenen kaynağı tanımlayan opak kimlik. Farklı API sürümlerinde kararlı. |
resourceUri |
İzlenen kaynağın sürüme özgü tanımlayıcısı. |
kind |
Bunu, " |
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. |