Drive etkinlik raporu, kullanıcılarınızın Google Workspace'te Google Drive'daki dosyaları yönetirken, değiştirirken ve paylaşırken gerçekleştirdiği etkinlikler hakkında bilgi sağlar. Örneğin, Drive etkinlik raporunu belirli bir tarih aralığında belirli bir kullanıcı tarafından oluşturulan tüm yeni Drive dokümanlarının listesini almak için kullanabilirsiniz. Bu bilgileri, daha iyi içerik yönetimi ve olası veri sızıntıları hakkında fikir edinmek için kullanabilirsiniz. Bir rapor almak için, temel rapor uç nokta isteğini kullanıcının e-posta adresi veya belirli bir Google Drive değişikliği türü gibi rapora özgü parametrelerle birlikte kullanırsınız. Raporlar son 180 güne kadar olan verileri içerebilir.
Google Drive etkinlik raporu, atanmış lisans bulunan hesaplarda yalnızca yasal amaçlarla kullanılabilir.
İsteğin sorgu dizeleri ve yanıt özellikleri hakkında bilgi edinmek için API Referansı'na bakın. Google Drive ile ilgili belirli etkinlikler hakkında bilgi edinmek için Drive etkinlik adları başlıklı makaleye göz atın.
Bir alan için Google Drive etkinliklerini alma
Drive etkinlik raporunu Drive dokümanlarınızla ilgili bilgileri listelemek için kullanabilirsiniz. Örneğin, hesabınızla ilişkili en son 25 Drive etkinliğini listeleyen bir rapor isteğinde bulunabilirsiniz. Bu etkinlikler, 180 günü bulabilir. Bu raporu almak için yetkilendirme kılavuzunda açıklandığı şekilde bir yetkilendirme jetonu alın, ardından aşağıdaki HTTP GET isteğini kullanın:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?maxResults=25
Bu API çağrısına verilen örnek bir yanıt görebilirsiniz.
Aşağıdaki örnek, maksimum süre olan son 180 güne ait tüm Drive etkinliklerinin bir raporunu alır.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive
Kullanıcıya göre Google Drive etkinliklerini al
Belirli bir kullanıcının Google Drive etkinliklerinin raporunu almak için yetkilendirme kılavuzunda açıklanan yetkilendirme jetonuna sahip bir HTTP GET isteği kullanın.
userKey alanı, rapordaki kullanıcının birincil e-posta adresidir veya tüm kullanıcılar için all kullanılır.
Aşağıdaki örnek, belirtilen kullanıcı tarafından yapılan tüm değişiklikleri listeleyen bir rapor getirir. API yanıtı örneği için örnek JSON yanıtına bakın.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/kim@example.com
/applications/drive
Ortak Drive'lar için Google Drive etkinliklerini alma
Yetkilendirme kılavuzunda açıklanan yetkilendirme jetonuna sahip bir HTTP GET isteğini kullanarak belirli bir ortak drive için Google Drive etkinliklerinin raporunu alabilirsiniz. userKey alanında, raporu çalıştırmak istediğiniz kullanıcının e-posta adresini belirtin veya raporu tüm kullanıcılar üzerinde çalıştırmak için all değerini belirtin.
Aşağıdaki örnek, belirli bir ortak drive'daki tüm değişikliklerin raporunu alır. API yanıtı örneği için örnek JSON yanıtına bakın.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?filters=shared_drive_id==<id of shared drive>
Bir ortak Drive'la ilgili etkinlikleri almak için doc_type kullanarak filtreleyin. Aşağıdaki örnekte, tüm ortak Drive'ları etkileyen etkinlikler gösterilmektedir:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?filters=doc_type=shared_drive
Üyelik değişiklikleriyle ilgili etkinlikleri almak için shared_drive_membership_change etkinliğini belirtin. Aşağıdaki örnek, ortak Drive'lara eklenen tüm üye eklemelerini alır:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?evetName=shared_drive_membership_change&
filters=membership_change_type==add_to_shared_drive
Google Drive etkinliklerini etkinlik türüne göre alma
Doküman oluşturma veya düzenleme gibi belirli bir etkinlik türünün tüm örneklerinin raporunu almak için yetkilendirme kılavuzunda açıklanan yetkilendirme jetonunu içeren bir HTTP GET isteği kullanın.
userKey alanı, rapordaki kullanıcının birincil e-posta adresidir veya tüm kullanıcılar için all kullanılır.
Aşağıdaki örnek, tüm hesap belgesi oluşturma etkinliklerinin bir raporunu alır. API yanıtı örneği için örnek JSON yanıtına bakın:
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive?eventName=create
Örnek JSON yanıtı
API'ye bir HTTP GET isteği gönderdiğinizde başarılı bir yanıt, bir HTTP 200 durum kodu döndürür. Yanıt, durum koduyla birlikte Drive için bir rapor döndürür. Bu raporlar Yönetici Konsolu'nda da
sunulabilir. Daha fazla bilgi için Google Workspace Yönetici Yardım Merkezi'ne göz atın.
eventName bilgileri için Drive etkinlik adları referansına bakın. İsteğin sorgu dizeleri ve yanıt özellikleri hakkında daha fazla bilgi için API Referansı'na bakın.
{
"kind": "reports#auditActivities",
"nextPageToken": "next page's token",
"items": [
{
"kind": "audit#activity",
"id": {
"time": "2014-03-17T15:39:18.460Z",
"uniqQualifier": "report's unique ID",
"applicationName": "drive",
"customerId": "ABC123xyz"
},
"actor": {
"callerType": "USER",
"email": "kim@example.com",
"profileId": "user's unique Google Workspace profile ID",
"key": "consumer key of requestor in an OAuth 2LO request"
},
"ownerDomain": "domain of the source owner",
"ipAddress": "user's IP address",
"events": [
{
"type": "access",
"name": "edit",
"parameters": [
{
"name": "primary_event",
"boolValue": true
},
{
"name": "owner_is_shared_drive",
"boolValue": false
}, {
"name": "doc_id",
"value": "1DWuYM3ot_sAyEQqOz0xWJ9bVMSYzOmRNeBqbgtSwuK8"
},
{
"name": "doc_title",
"value": "Meeting notes"
},
{
"name": "doc_type",
"value": "document"
},
{
"name": "owner",
"value": "mary@example.com"
}
]
}
]
},
]
}