- HTTP isteği
- Yol parametreleri
- Sorgu parametreleri
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- ApplicationName
- Etkinlik
- ResourceDetails
- AppliedLabel
- FieldValue
- TextListValue
- SelectionValue
- SelectionListValue
- UserValue
- UserListValue
- Tarih
- Neden
- Deneyin.
Belirli bir müşterinin hesabı ve uygulaması (ör. Yönetici Konsolu uygulaması veya Google Drive uygulaması) için etkinliklerin listesini alır. Daha fazla bilgi için yönetici ve Google Drive etkinlik raporlarıyla ilgili kılavuzlara bakın. Etkinlik raporunun parametreleri hakkında daha fazla bilgi için etkinlik parametreleri referans kılavuzlarına bakın.
HTTP isteği
GET https://admin.googleapis.com/admin/reports/v1/activity/users/{userKey or all}/applications/{applicationName}
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
Parametreler | |
---|---|
userKey or all |
Verilerin filtrelenmesi gereken profil kimliğini veya kullanıcı e-posta adresini temsil eder. Tüm bilgiler için |
applicationName |
Etkinliklerin alınacağı uygulama adı. |
Sorgu parametreleri
Parametreler | |
---|---|
actorIpAddress |
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 |
Verileri alınacağı müşterinin benzersiz kimliği. |
endTime |
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. API raporlarında üç temel zaman kavramı vardır:
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 |
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 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 yoksayıp 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 |
Raporlanılacak kuruluş biriminin kimliği. Etkinlik kayıtları yalnızca belirtilen kuruluş birimine ait kullanıcılar için gösterilir. |
pageToken |
Sonraki sayfayı belirtmek için kullanılan jeton. Birden fazla sayfa içeren bir raporda yanıtta |
startTime |
Raporda gösterilen zaman aralığının başlangıcını ayarlar. Tarih, RFC 3339 biçiminde olmalıdır (ör. 2010-10-28T10:26:35.000Z). Rapor, |
groupIdFilter |
Kullanıcı etkinliklerinin filtrelendiği, virgül ile ayrılmış grup kimlikleri (gizlenmiş). Yani yanıtta yalnızca burada belirtilen grup kimliklerinden en az birinin parçası olan kullanıcıların etkinlikleri yer alır. Biçim: "id:abc123,id:xyz456" başlıklı makaleyi inceleyin. |
İstek içeriği
İstek metni boş olmalıdır.
Yanıt gövdesi
Etkinlik koleksiyonu için JSON şablonu.
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
JSON gösterimi |
---|
{
"kind": string,
"etag": string,
"items": [
{
object ( |
Alanlar | |
---|---|
kind |
API kaynağının türü. Etkinlik raporu için değer |
etag |
Kaynağın ETag'i. |
items[] |
Yanıtta yer alan her etkinlik kaydı. |
nextPageToken |
Raporun sonraki sayfasını almak için kullanılan jeton. |
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ılavuzuna bakın.
ApplicationName
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ı yönetici etkinliği etkinlikleri türleriyle ilgili 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 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 raporu yalnızca Google Workspace Business ve Enterprise müşterileri tarafından kullanılabilir. |
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 türleri hakkında bilgi döndürür. |
mobile |
Cihaz Denetleme etkinliği raporu, farklı cihaz denetimi etkinliği türleri hakkında bilgi döndürür. |
rules |
Kurallar etkinliği raporu, farklı kurallar etkinliği etkinlikleri türleri 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. |
vault |
Apps Kasası etkinliği raporları, çeşitli Apps Kasası etkinliği türleri hakkında bilgi döndürür. |
Etkinlik
Etkinlik kaynağı için JSON şablonu.
JSON gösterimi |
---|
{ "kind": string, "etag": string, "ownerDomain": string, "ipAddress": string, "events": [ { "type": string, "name": string, "parameters": [ { "messageValue": { "parameter": [ { object ( |
Alanlar | |
---|---|
kind |
API kaynağının türü. Etkinlik raporu için değer |
etag |
Girişin ETag'ı. |
ownerDomain |
Bu, raporun etkinliğinden etkilenen alandır. Örneğin, Yönetici Konsolu'nun veya Drive uygulamasının doküman sahibinin alanı. |
ipAddress |
İşlemi gerçekleştiren kullanıcının IP adresi. Bu, Google Workspace'e giriş yapan kullanıcının İnternet Protokolü (IP) adresidir. Bu adres, 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. API, IPv4 ve IPv6'yı destekler. |
events[] |
Rapordaki etkinlik etkinlikleri. |
events[].type |
Etkinlik türü. Bir yöneticinin değiştirdiği Google Workspace hizmeti veya özelliği, |
events[].name |
Etkinliğin adı. Bu, API tarafından raporlanan etkinliğin özel adıdır. Her
eventName mülkleri hakkında daha fazla bilgi için yukarıdaki applicationName bölümünde çeşitli uygulamalara ait etkinlik adlarının listesini inceleyin.
|
events[].parameters[] |
Çeşitli uygulamalar için parametre değeri çiftleri. |
events[].parameters[].messageValue |
Bu parametreyle ilişkili iç içe yerleştirilmiş parametre değeri çiftleri. Bir parametrenin karmaşık değer türü, parametre değerlerinin listesi olarak döndürülür. Örneğin, address parametresinin değeri |
events[].parameters[].messageValue.parameter[] |
Parametre değerleri |
events[].parameters[].name |
Parametrenin adı. |
events[].parameters[].value |
Parametrenin dize değeri. |
events[].parameters[].multiValue[] |
Parametrenin dize değerleri. |
events[].parameters[].intValue |
Parametrenin tam sayı değeri. |
events[].parameters[].multiIntValue[] |
Parametrenin tam sayı değerleri. |
events[].parameters[].boolValue |
Parametrenin boole değeri. |
events[].parameters[].multiMessageValue[] |
activities. |
events[].parameters[].multiMessageValue[].parameter[] |
Parametre değerleri |
events[].resourceIds[] |
Etkinlikle ilişkili kaynak kimlikleri. |
id |
Her etkinlik kaydının benzersiz tanımlayıcısı. |
id.time |
Etkinliğin gerçekleştiği zaman. Bu değer, saniye cinsinden UNIX sıfır zamanıdır. |
id.uniqueQualifier |
Birden fazla etkinliğin aynı saate sahip olması durumunda benzersiz niteleyici. |
id.applicationName |
Etkinliğin ait olduğu uygulama adı. Olası değerler için yukarıdaki |
id.customerId |
Google Workspace hesabının benzersiz tanımlayıcısı. |
actor |
İşlemi yapan kullanıcı. |
actor.profileId |
Kullanıcının benzersiz Google Workspace profili kimliği. Aktör bir Google Workspace kullanıcısı değilse bu değer bulunmayabilir veya yer tutucu kimlik görevi gören 105250506097979753968 numarası olabilir. |
actor.email |
İşlemi gerçekleştiren kullanıcının birincil e-posta adresi. Aktörle ilişkili bir e-posta adresi yoksa eksik olabilir. |
actor.callerType |
İşlemi gerçekleştiren kullanıcının türü. |
actor.key |
Yalnızca |
actor.applicationInfo |
Etkinliğin aktörlüğünü yapan uygulamanın ayrıntıları. |
actor.applicationInfo.oauthClientId |
İşlemi gerçekleştirmek için kullanılan üçüncü taraf uygulamasının OAuth istemci kimliği. |
actor.applicationInfo.applicationName |
İşlemi gerçekleştirmek için kullanılan uygulamanın adı. |
actor.applicationInfo.impersonation |
Uygulamanın bir kullanıcının kimliğine bürünüp bürünmediği. |
resourceDetails[] |
İşlemin gerçekleştirildiği kaynağın ayrıntıları. |
ResourceDetails
İşlemin gerçekleştirildiği kaynağın ayrıntıları.
JSON gösterimi |
---|
{
"id": string,
"title": string,
"type": string,
"appliedLabels": [
{
object ( |
Alanlar | |
---|---|
id |
Kaynağın tanımlayıcısıdır. |
title |
Kaynağın başlığı. Örneğin, Drive belgesi söz konusu olduğunda bu, belgenin başlığı olur. E-posta söz konusu olduğunda bu, e-postanın konusu olur. |
type |
Kaynağın türü (belge, e-posta, sohbet mesajı) |
appliedLabels[] |
activities.kaynağa uygulanan etiketlerin listesi |
relation |
Kaynağın etkinliklerle olan ilişkisini tanımlar |
AppliedLabel
Kaynağa uygulanan etiketin ayrıntıları.
JSON gösterimi |
---|
{ "id": string, "title": string, "fieldValues": [ { object ( |
Alanlar | |
---|---|
id |
Etiketin tanımlayıcısıdır. OnePlatform kaynak adının tamamı değil, yalnızca etiket kimliğidir. |
title |
Etiketin başlığı |
fieldValues[] |
activities.Etiketin parçası olan ve kullanıcı tarafından ayarlanmış alanların listesi. Etiketin kullanıcı tarafından ayarlanmayan bir alanı varsa bu listede yer almaz. |
reason |
Etiketin kaynağa uygulanma nedeni. |
FieldValue
Kullanıcı tarafından belirli bir etiket için ayarlanan alan değerinin ayrıntıları.
JSON gösterimi |
---|
{ "id": string, "displayName": string, "type": string, "reason": { object ( |
Alanlar | |
---|---|
id |
Alanın tanımlayıcısı |
displayName |
Alanın görünen adı |
type |
Alanın türü |
reason |
Alanın etikete uygulanma nedeni. |
Birlik alanı value . Alanda depolanan değerleri depolar. value yalnızca aşağıdakilerden biri olabilir: |
|
unsetValue |
Alan ayarlanmadan bırakılırsa bu değer doğru olur. |
longTextValue |
Uzun bir metin değeri ayarlama. |
textValue |
Metin değeri ayarlama. |
textListValue |
Metin listesi değeri ayarlama. |
selectionValue |
Açılır menüden tek bir değer seçerek seçim değeri ayarlama. |
selectionListValue |
Açılır listeden birden fazla değer seçerek bir seçim listesi değeri ayarlama. |
integerValue |
Tam sayı değeri ayarlama. |
userValue |
Tek bir kullanıcı seçerek kullanıcı değeri ayarlama. |
userListValue |
Birden fazla kullanıcı seçerek kullanıcı listesi değeri ayarlama. |
dateValue |
Tarih değeri ayarlama. |
TextListValue
Metin listesi değeri ayarlama.
JSON gösterimi |
---|
{ "values": [ string ] } |
Alanlar | |
---|---|
values[] |
activities.list metin değerlerinin listesi. |
SelectionValue
Açılır menüden tek bir değer seçerek seçim değeri ayarlama.
JSON gösterimi |
---|
{ "id": string, "displayName": string, "badged": boolean } |
Alanlar | |
---|---|
id |
Seçimin tanımlayıcısıdır. |
displayName |
Seçimin görünen adı. |
badged |
Seçeneğin rozetli olup olmadığı. |
SelectionListValue
Açılır listeden birden fazla değer seçerek bir seçim listesi değeri ayarlama.
JSON gösterimi |
---|
{
"values": [
{
object ( |
Alanlar | |
---|---|
values[] |
activities.list of selections. |
UserValue
Tek bir kullanıcı seçerek kullanıcı değeri ayarlama.
JSON gösterimi |
---|
{ "email": string } |
Alanlar | |
---|---|
email |
Kullanıcının e-postası. |
UserListValue
Birden fazla kullanıcı seçerek kullanıcı listesi değeri ayarlama.
JSON gösterimi |
---|
{
"values": [
{
object ( |
Alanlar | |
---|---|
values[] |
activities.list of users. |
Tarih
Doğum günü gibi takvim tarihlerinin tamamını veya bir kısmını temsil eder. Saat ve saat dilimi başka bir yerde belirtilmiş veya önemsizdir. Tarih, Gregoryen takvimine göredir. Bu durum aşağıdakilerden birini gösterebilir:
- Sıfır olmayan yıl, ay ve gün değerleri içeren tam tarih.
- Sıfır yılı olan bir ay ve gün (ör. yıldönümü).
- Ay ve gün bilgisi olmayan bir yıl.
- Sıfır gün içeren bir yıl ve ay (ör. kredi kartının son kullanma tarihi).
İlgili türler:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
JSON gösterimi |
---|
{ "year": integer, "month": integer, "day": integer } |
Alanlar | |
---|---|
year |
Tarihin yılı. 1 ile 9999 arasında veya yıl olmadan tarih belirtmek için 0 olmalıdır. |
month |
Yılın ayı. 1 ile 12 arasında veya ay ve gün olmadan bir yıl belirtmek için 0 olmalıdır. |
day |
Ayın günü. 1 ile 31 arasında olmalı ve yıl ile ay için geçerli olmalıdır. 0 değerini kullanarak da yıl veya gününün önemli olmadığı bir yıl ve ay belirtebilirsiniz. |
Neden
Etiketin/alanın uygulanma nedeni.
JSON gösterimi |
---|
{ "reasonType": string } |
Alanlar | |
---|---|
reasonType |
Nedenin türü. |