- HTTP isteği
- Yol parametreleri
- Sorgu parametreleri
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- ApplicationName
- Etkinlik
- NetworkInfo
- 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 etkinlik 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 gösterir. Tüm bilgiler için |
applicationName |
Etkinliklerin alınacağı uygulamanın 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 bir sanal özel ağ (VPN) adresi olabilir. Bu parametre hem IPv4 hem de IPv6 adres sürümlerini destekler. |
customerId |
Verilerin alınacağı müşterinin benzersiz kimliği. |
endTime |
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:
endTime belirtilmezse rapor, startTime tarihinden itibaren geçerli zamana kadar olan tüm etkinlikleri döndürür. startTime tarihi 180 günden daha eski bir tarihse rapor, son 180 gün içindeki etkinlikleri döndürür. Gmail istekleri için startTime ve endTime sağlanmalı ve aralarındaki fark 30 günden fazla olmamalıdı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. 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 |
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 kullanıcılar için gösterilir. |
pageToken |
Sonraki sayfayı belirtmek için kullanılan jeton. Birden fazla sayfaya sahip bir raporda yanıtta |
startTime |
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, |
groupIdFilter |
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" |
İstek içeriği
İstek metni boş olmalıdır.
Yanıt gövdesi
Bir 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ıtın her bir 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ılavuzu'na bakın.
ApplicationName
| Sıralamalar | |
|---|---|
access_transparency |
Google Workspace Erişim Şeffaflığı etkinlik raporları, farklı türlerdeki Erişim Şeffaflığı etkinlik olayları 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 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 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 etkinlikleri hakkında bilgi döndürür. |
gmail |
Gmail uygulamasının etkinlik raporları, çeşitli Gmail etkinlikleri hakkında bilgi döndürür. |
gplus |
Google+ uygulamasının etkinlik raporları, çeşitli Google+ etkinlikleri hakkında bilgi döndürür. |
groups |
Google Gruplar uygulamasının etkinlik raporları, çeşitli Gruplar etkinlikleri hakkında bilgi döndürür. |
groups_enterprise |
Enterprise Groups etkinlik raporları, çeşitli Enterprise Groups etkinlikleri hakkında bilgi döndürür. |
jamboard |
Jamboard etkinlik raporları, çeşitli Jamboard etkinlikleri hakkında bilgi döndürür. |
login |
Giriş uygulaması etkinlik raporları, farklı türlerdeki giriş etkinliği olayları hakkında hesap bilgileri döndürür. |
meet |
Meet denetleme etkinliği raporu, farklı türlerdeki Meet denetleme etkinliği etkinlikleri hakkında bilgi döndürür. |
mobile |
Cihaz denetimi etkinlik raporu, farklı türlerdeki cihaz denetimi etkinlikleri 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 etkinliği raporu, farklı türlerdeki SAML etkinliği etkinlikleri hakkında bilgi döndürür. |
token |
Token uygulamasının etkinlik raporları, farklı türlerdeki Token etkinlikleri hakkında hesap bilgileri döndürür. |
user_accounts |
Kullanıcı Hesapları uygulamasının etkinlik raporları, farklı türlerdeki Kullanıcı Hesapları etkinlikleri hakkında hesap bilgileri döndürür. |
context_aware_access |
Bağlama duyarlı erişim etkinliği raporları, kullanıcıların bağlama duyarlı erişim kuralları nedeniyle reddedilen erişim etkinlikleri hakkında bilgi 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 etkinlikleri hakkında bilgi döndürür. |
keep |
Keep uygulamasının etkinlik raporları, çeşitli Google Keep 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ı etkinlik raporları, çeşitli Apps Kasası etkinlikleri hakkında bilgi döndürür. |
gemini_in_workspace_apps |
Workspace için Gemini etkinlik raporları, Workspace uygulamasında kullanıcılar tarafından gerçekleştirilen çeşitli Gemini etkinlikleri hakkında bilgi döndürür. |
classroom |
Classroom etkinlik raporları, farklı türlerdeki Classroom etkinlikleri 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'i. |
ownerDomain |
Bu, raporun etkinliğinden etkilenen alan adıdır. Örneğin, Yönetici Konsolu'nun veya Drive uygulamasının doküman sahibinin alan adı. |
ipAddress |
İşlemi yapan kullanıcının IP adresi. Bu, Google Workspace'e giriş yaparken kullanıcının İnternet Protokolü (IP) adresidir. Kullanıcının fiziksel konumunu yansıtıp yansıtmayabilir. Örneğin, IP adresi kullanıcının proxy sunucusunun adresi veya bir 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 bildirilen etkinliğin adıdır. Her
eventName özellikleri 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, adres 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.list of |
events[].parameters[].multiMessageValue[].parameter[] |
Parametre değerleri |
events[].resourceIds[] |
Etkinlikle ilişkili kaynak kimlikleri. |
id |
Her etkinlik kaydı için benzersiz tanımlayıcı. |
id.time |
Etkinliğin gerçekleştiği zaman. Bu değer, saniye cinsinden UNIX sıfır zamanı biçimindedir. |
id.uniqueQualifier |
Birden fazla etkinlik aynı zamana sahipse benzersiz niteleyici. |
id.applicationName |
Etkinliğin ait olduğu uygulamanın 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 |
Aktörün benzersiz Google Workspace profil kimliği. Aktör bir Google Workspace kullanıcısı değilse bu değer mevcut olmayabilir veya yer tutucu kimlik olarak kullanılan 105250506097979753968 sayısı olabilir. |
actor.email |
İşlemi gerçekleştiren kullanıcının birincil e-posta adresi. İşlemi gerçekleştirenle ilişkili bir e-posta adresi yoksa bu alan bulunmayabilir. |
actor.callerType |
İşlemi gerçekleştiren kullanıcının türü. |
actor.key |
Yalnızca |
actor.applicationInfo |
Etkinliğin aktörü olan 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. |
networkInfo |
İşlemi yapan kullanıcının ağ bilgileri. |
resourceDetails[] |
İşlemin gerçekleştirildiği kaynakla ilgili ayrıntılar. |
NetworkInfo
İşlemi yapan kullanıcının ağ bilgileri.
| JSON gösterimi |
|---|
{ "ipAsn": [ integer ], "regionCode": string, "subdivisionCode": string } |
| Alanlar | |
|---|---|
ipAsn[] |
İşlemi yapan kullanıcının IP adresi. |
regionCode |
İşlemi yapan kullanıcının ISO 3166-1 alfa-2 bölge kodu. |
subdivisionCode |
İşlemi yapan kullanıcının bulunduğu ülkeler için ISO 3166-2 bölge kodu (eyaletler ve iller). |
ResourceDetails
İşlemin gerçekleştirildiği kaynakla ilgili ayrıntılar.
| JSON gösterimi |
|---|
{
"id": string,
"title": string,
"type": string,
"appliedLabels": [
{
object ( |
| Alanlar | |
|---|---|
id |
Kaynağın tanımlayıcısı. |
title |
Kaynağın başlığı. Örneğin, bir Drive belgesi söz konusu olduğunda bu, belgenin başlığı olur. E-posta söz konusu olduğunda bu, konu olur. |
type |
Kaynağın türü (belge, e-posta, sohbet mesajı) |
appliedLabels[] |
activities.list of labels applied on the resource |
relation |
Kaynağın etkinliklerle 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ı: Yalnızca etiket kimliği, tam OnePlatform kaynak adı değil. |
title |
Etiketin başlığı |
fieldValues[] |
Etiketin parçası olan ve kullanıcı tarafından ayarlanan alanların listesi. Etikette, kullanıcı tarafından ayarlanmamış bir alan varsa bu listede yer almaz. |
reason |
Etiketin kaynağa uygulanma nedeni. |
FieldValue
Kullanıcı tarafından belirli etiket için ayarlanan alan değerinin ayrıntıları.
| JSON gösterimi |
|---|
{ "id": string, "displayName": string, "type": string, "reason": { object ( |
| Alanlar | |
|---|---|
id |
Alan tanımlayıcısı |
displayName |
Alanın görünen adı |
type |
Alanın türü |
reason |
Alanının etikete uygulanma nedeni. |
value birleşik alanı. value alanında depolanan değerler yalnızca aşağıdakilerden biri olabilir: |
|
unsetValue |
Alan ayarlanmamışsa 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 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 of text values. |
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ı. |
displayName |
Seçimin görünen adı. |
badged |
Seçimin rozetli olup olmadığı. |
SelectionListValue
Açılır listeden birden fazla değer seçerek 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-posta adresi. |
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 tam veya kısmi bir takvim tarihini gösterir. Günün saati ve saat dilimi başka bir yerde belirtilmiştir veya önemsizdir. Tarih, Gregoryen Takvimi'ne göre belirlenir. Bu, aşağıdakilerden birini temsil edebilir:
- Yıl, ay ve gün değerleri sıfır olmayan tam bir tarih.
- Yılın sıfır olduğu bir ay ve gün (örneğin, yıl dönümü).
- Tek başına bir yıl, sıfır ay ve sıfır gün.
- Bir yıl ve ay, sıfır günle (örneğin, kredi kartının son kullanma tarihi).
İlgili türler:
google.type.TimeOfDaygoogle.type.DateTimegoogle.protobuf.Timestamp
| JSON gösterimi |
|---|
{ "year": integer, "month": integer, "day": integer } |
| Alanlar | |
|---|---|
year |
Tarihin yılı. 1 ile 9999 arasında olmalı veya yıl içermeyen bir tarih belirtmek için 0 olmalıdır. |
month |
Yılın ayı. 1 ile 12 arasında olmalı veya ay ve gün içermeyen 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. Yalnızca bir yılı veya günün önemli olmadığı bir yıl ve ayı belirtmek için 0 olmalıdır. |
Neden
Etiketin/alanın uygulanma nedeni.
| JSON gösterimi |
|---|
{ "reasonType": string } |
| Alanlar | |
|---|---|
reasonType |
Nedeni türü. |