- 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
- OwnerDetails
- OwnerIdentity
- CustomerIdentity
- UserIdentity
- GroupIdentity
- 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-postasını temsil eder. 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 zamanıdır. API raporunda üç temel zaman kavramı bulunur:
endTime belirtilmezse rapor, startTime tarihinden itibaren geçerli zamana kadar olan tüm etkinlikleri veya startTime tarihi 180 günden daha eski bir tarihse son 180 günü döndürür. Gmail istekleri için startTime ve endTime sağlanmalı ve aradaki 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, Bir
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" |
resourceDetailsFilter |
İsteğe bağlı. Kaynak ayrıntıları filtreleri Tüm iç alanlar, aşağıdaki örnekte gösterildiği gibi
Doğada tekrarlanan Örneğin, aşağıdaki filtrede Kullanım Aşağıdakileri göz önünde bulundurun:
|
networkInfoFilter |
İsteğe bağlı. Kullanım |
statusFilter |
İsteğe bağlı. Kullanım |
applicationInfoFilter |
İsteğe bağlı. Kullanım |
İstek metni
İstek metni boş olmalıdır.
Yanıt metni
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 olayları 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 Group 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 denetleme etkinliği raporu, farklı türlerdeki cihaz denetleme etkinliği etkinlikleri hakkında bilgi döndürür. |
rules |
Kural etkinliği raporu, farklı kural 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 etkinliği 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. |
assignments |
Ödevler uygulamasının etkinlik raporları, çeşitli ödev etkinliği etkinlikleri hakkında bilgi döndürür. |
cloud_search |
Cloud Search uygulamasının etkinlik raporları, çeşitli cloud_search etkinlikleri hakkında bilgi döndürür. |
tasks |
Görevler uygulamasının etkinlik raporları, çeşitli Görevler etkinliği etkinlikleri hakkında bilgi döndürür. |
data_migration |
Veri Taşıma uygulamasının etkinlik raporları, çeşitli veri taşıma etkinliği türleri hakkında bilgi döndürür. |
meet_hardware |
Meet Donanım uygulamasının etkinlik raporları, çeşitli Meet Donanım etkinlikleri hakkında bilgi döndürür. |
directory_sync |
Directory Sync uygulamasının etkinlik raporları, çeşitli Directory Sync etkinlikleri hakkında bilgi döndürür. |
ldap |
LDAP uygulamasının etkinlik raporları, çeşitli LDAP etkinliği etkinlikleri hakkında bilgi döndürür. |
profile |
Profil uygulamasının etkinlik raporları, çeşitli Profil etkinliği etkinlikleri hakkında bilgi döndürür. |
access_evaluation |
Erişim değerlendirme etkinliği raporları, çeşitli erişim değerlendirme etkinliği etkinlikleri hakkında bilgi döndürür. |
admin_data_action |
Yönetici Verileri İşlemi uygulamasının etkinlik raporları, çeşitli Yönetici Verileri İşlemi etkinlikleri hakkında bilgi döndürür. |
contacts |
Kişiler uygulamasının etkinlik raporları, çeşitli Kişiler etkinliği etkinlikleri hakkında bilgi döndürür. |
takeout |
Takeout uygulamasının etkinlik raporları, çeşitli Takeout etkinliği etkinlikleri hakkında bilgi döndürür. |
graduation |
Graduation uygulamasının etkinlik raporları, çeşitli Graduation 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'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 kullandığı İ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[] |
Rapor kapsamındaki 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. |
events[].status |
Etkinliğin durumu. Not: Tüm etkinliklerin durumu yoktur. |
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ı 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ştirenin 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 ülkeleri 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ı (ör. Drive dokümanı için doc_id, Meet konferansı için conference_id veya e-posta için "gaia_id/rfc2822_message_id"). |
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. |
ownerDetails |
Kaynağın sahibiyle ilgili ayrıntılar. |
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 listeden 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 listeden 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.
- 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 değeri kullanılabilir. |
Neden
Etiketin/alanın uygulanma nedeni.
| JSON gösterimi |
|---|
{ "reasonType": string } |
| Alanlar | |
|---|---|
reasonType |
Nedeni türü. |
OwnerDetails
Kaynağın sahibinin ayrıntıları.
| JSON gösterimi |
|---|
{
"ownerType": string,
"ownerIdentity": [
{
object ( |
| Alanlar | |
|---|---|
ownerType |
Kaynağın sahibinin türü. |
ownerIdentity[] |
Kaynağın sahibinin/sahiplerinin kimlik bilgileri. |
OwnerIdentity
Kaynağın sahibinin kimlik bilgileri.
| JSON gösterimi |
|---|
{ "customerIdentity": { object ( |
| Alanlar | |
|---|---|
identity birleşik alanı. Bu, oneof alanıdır ve yalnızca aşağıdaki alanlardan biri ayarlanabilir. identity aşağıdakilerden yalnızca biri olabilir: |
|
customerIdentity |
Kaynağın sahibi olan Google Workspace müşterisinin kimliği. |
userIdentity |
Kaynağın sahibi olan kullanıcının kimliği. |
groupIdentity |
Kaynağın sahibi olan grubun kimliği. |
CustomerIdentity
Kaynağın sahibi olan Google Workspace müşterisinin kimliği.
| JSON gösterimi |
|---|
{ "id": string } |
| Alanlar | |
|---|---|
id |
Müşteri kimliği. |
UserIdentity
Kaynağın sahibi olan kullanıcının kimliği.
| JSON gösterimi |
|---|
{ "id": string, "userEmail": string } |
| Alanlar | |
|---|---|
id |
Kullanıcı GAIA kimliği. |
userEmail |
Kullanıcı e-posta adresi. |
GroupIdentity
Kaynağın sahibi olan grubun kimliği.
| JSON gösterimi |
|---|
{ "id": string, "groupEmail": string } |
| Alanlar | |
|---|---|
id |
Grup GAIA kimliği. |
groupEmail |
Grup e-postası. |