Bu sayfa, Cloud Translation API ile çevrilmiştir.

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

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` işlevini çağırın, ardından döndürülen `ID` değerini `userKey` olarak kullanın.
`applicationName`	`enum (ApplicationName)` Etkinliklerin alınacağı uygulamanın adı.

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 işlevini çağırı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ş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ı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` Verilerin alınacağı müşterinin benzersiz kimliği.
`endTime`	`string` Raporda gösterilen zaman aralığının sonunu ayarlar. Tarih, RFC 3339 biçimindedir (ör. 2010-10-28T10:26:35.000Z). Varsayılan değer, API isteğinin yaklaşık süresidir. API raporunda üç temel zaman kavramı bulunur: API'nin rapor isteğinde bulunduğu tarih: API'nin raporu oluşturup aldığı zaman. Raporun başlangıç zamanı: Raporda gösterilen zaman aralığının başlangıcı. İstek yapıldığında `startTime`, `endTime` (belirtilmişse) ve geçerli saatten ö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 ayında başlayıp Mayıs ayında sona erebilir. Raporun kendisi Ağustos ayında istenebilir. `endTime` belirtilmezse rapor, `startTime` tarihinden itibaren geçerli zamana kadar olan tüm etkinlikleri veya `startTime` 180 günden daha eski bir tarihse son 180 günü 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 ilgilidir. Örneğin, Yönetici Konsolu uygulamasının raporlarındaki Google Takvim etkinlikleri. Takvim Ayarları `type` yapısında, API tarafından bildirilen tüm Takvim `eventName` etkinlikleri bulunur. Bir yönetici 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örlerle değiştirilen etkinlik parametrelerinden oluşan, virgülle ayrılmış bir listedir. Etkinlik parametreleri şu biçimdedir: `{parameter1 name}{relational operator}{parameter1 value},{parameter2 name}{relational operator}{parameter2 value},...` Bu etkinlik parametreleri belirli bir `eventName` ile ilişkilendirilir. İsteğin parametresi `eventName`'ya ait değilse boş bir rapor döndürülür. Her uygulama için kullanılabilen `eventName` alanlar ve bunlarla ilişkili parametreler hakkında daha fazla bilgi edinmek için ApplicationName tablosuna gidin, ardından istediğiniz uygulamanın Ekler bölümündeki Etkinlik Etkinlikleri sayfasına tıklayın. Aşağıdaki Drive etkinliği örneklerinde, döndürülen liste, `edit` parametre değerinin ilişkisel operatör tarafından tanımlanan koşullarla eşleştiği tüm `doc_id` etkinliklerinden oluşur. İlk örnekte, istek `doc_id` değeri `12345` olan 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 URL biçiminde kodlanmıştır (`%3C%3E`): `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 kodlamalı olmalıdır (%3C%3E). `<`: "daha az". URL kodlamalı olmalıdır (%3C). `<=`: "küçük veya eşit" URL kodlamalı olmalıdır (%3C=). `>`: "Büyüktür". URL kodlamalı olmalıdır (%3E). `>=`: "büyük veya eşittir". URL kodlamalı olmalıdır (%3E=). Not: API, aynı parametrenin birden fazla değerini kabul etmez. Bir parametre API isteğinde 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. 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 ayarlanmışsa ve raporda iki etkinlik varsa raporda iki sayfa bulunur. Yanıtın `nextPageToken` özelliğinde ikinci sayfanın jetonu var. İstekteki `maxResults` sorgu dizesi 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ş birimine ait 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ı belirtmek için kullanılan jeton. Birden fazla sayfaya sahip bir raporda yanıtta `nextPageToken` özelliği bulunur. Raporun bir sonraki sayfasını almak için gönderdiğiniz takip eden istekte, `nextPageToken` değerini `pageToken` sorgu dizesine girin.
`startTime`	`string` Raporda gösterilen zaman aralığının başlangıcını ayarlar. Tarih, RFC 3339 biçimindedir (ör. 2010-10-28T10:26:35.000Z). Rapor, `startTime` ile `endTime` arasındaki tüm etkinlikleri döndürür. İstek yapıldığında `startTime`, `endTime` (belirtilmişse) ve geçerli saatten önce olmalıdır. Aksi takdirde API hata döndürür.
`groupIdFilter (deprecated)`	`string` `Deprecated`. Bu alan kullanımdan kaldırıldı ve artık desteklenmiyor. Kullanıcı etkinliklerinin filtrelendiği virgülle ayrılmış grup kimlikleri (karmaşıklaştırılmış). Örneğin, yanıt yalnızca burada belirtilen grup kimliklerinden en az birinin parçası olan kullanıcıların etkinliklerini içerir. Biçim: "id:abc123,id:xyz456" Önemli: Gruplara göre filtrelemek için grupları, filtreleme grupları izin verilenler listenize açıkça eklemeniz gerekir. Filtreleme grupları izin verilenler listesine grup ekleme hakkında daha fazla bilgi için Sonuçları Google Grubu'na göre filtreleme başlıklı makaleyi inceleyin.

İ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 }

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 bir UUID veya benzeri benzersiz dize.
`token`	`string` Bu kanal üzerinden gönderilen her bildirimle birlikte hedef adrese rastgele bir dize iletilir. İ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 kanalla ilgili bildirimlerin gönderildiğ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 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 kimlik. Farklı API sürümlerinde kararlıdır.
`resourceUri`	`string` İzlenen kaynağın sürüme özgü tanımlayıcısı.
`kind`	`string` Bunu, "`api#channel`" olan bir kaynağın 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ılavuzu'na bakın.

ApplicationName