Drive etkinlik raporu, kullanıcılarınızın Google Workspace'te Google Drive'daki dosyaları yönetme, değiştirme ve paylaşma etkinlikleriyle ilgili bilgi sağlar. Örneğin, belirli bir kullanıcı tarafından belirli bir tarih aralığında oluşturulan tüm yeni Drive dokümanlarının listesini almak için Drive etkinlik raporunu kullanabilirsiniz. Bu bilgileri kullanarak daha iyi içerik yönetimi ve olası veri sızıntıları hakkında bilgi edinebilirsiniz. Rapor almak için raporla ilgili parametreleri (ör. kullanıcının e-posta adresi veya belirli bir Google Drive değişikliği) içeren temel rapor uç noktası isteğini kullanırsınız. Raporlar, son 180 güne ait verileri içerebilir.
Google Drive etkinlik raporu, yalnızca lisans atanmış hesaplarda yasal amaçlarla kullanılabilir.
İsteğin sorgu dizeleri ve yanıt özellikleri hakkında bilgi 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ı makaleyi inceleyin.
Bir alan için Google Drive etkinliklerini alma
Drive dokümanlarınızla ilgili bilgileri listelemek için Drive etkinlik raporunu kullanabilirsiniz. Örneğin, hesabınızın 180 güne kadar olan en son 25 Drive etkinliğini listeleyen bir rapor isteyebilirsiniz. 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 yanıtı inceleyebilirsiniz.
Aşağıdaki örnek, maksimum süre olan son 180 güne ait tüm Drive etkinliklerinin raporunu alır.
GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive
Kullanıcıya göre Google Drive etkinliklerini alma
Belirli bir kullanıcının Google Drive etkinlikleriyle ilgili bir rapor almak için Yetkilendirme kılavuzunda açıklanan yetkilendirme jetonuyla 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'dir.
Aşağıdaki örnekte, belirtilen kullanıcı tarafından yapılan tüm değişikliklerin listelendiği bir rapor alını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/kim@example.com
/applications/drive
Ortak Drive'lar için Google Drive etkinliklerini alma
Yetkilendirme kılavuzunda açıklanan yetkilendirme jetonuyla bir HTTP GET isteği kullanarak belirli bir paylaşılan sürücü 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 için çalıştırmak üzere all değerini belirtin.
Aşağıdaki örnekte, belirli bir ortak Drive'daki tüm değişikliklerin raporu alını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>
Ortak Drive'daki etkinlikleri almak için doc_type simgesini kullanarak filtreleyin. Aşağıdaki örnek, tüm ortak drive'ları etkileyen etkinlikleri alır:
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
event parametresini belirtin. Aşağıdaki örnek, ortak drive'lara eklenen tüm üyeleri 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
Belirli bir etkinlik türünün (ör. doküman oluşturma veya düzenleme) tüm örnekleriyle ilgili bir rapor 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'dir.
Aşağıdaki örnek, tüm hesap dokümanı oluşturma etkinliklerinin 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 HTTP 200 durum kodunu 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 kullanılabilir. Daha fazla bilgi için Google Workspace Yönetici Yardım Merkezi'ne bakı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"
}
]
}
]
},
]
}