Reports API: Drive Etkinlik Raporu

Drive etkinlik raporu, kullanıcılarınızın Google Workspace'te Google Drive'da dosya yönetirken, değiştirirken ve paylaşırken yaptıkları işlemler hakkında bilgi sağlar. Örneğin, belirli bir kullanıcının belirli bir tarih aralığında oluşturduğu tüm yeni Drive dokümanlarının listesini almak için Drive etkinlik raporunu kullanabilirsiniz. Bu bilgileri kullanarak içerik yönetimini iyileştirme ve olası veri sızıntıları hakkında bilgi edinebilirsiniz. Rapor almak için kullanıcının e-posta adresi veya belirli bir Google Drive değişikliği gibi rapora özel parametrelerle temel rapor uç noktası isteğini kullanırsınız. Raporlar son 180 güne kadar olan verileri içerebilir.

Google Drive etkinlik raporu, yalnızca lisans atanmış hesaplarda yasal amaçlar için 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 belgelerinizle ilgili bilgileri listelemek için Drive etkinlik raporunu kullanabilirsiniz. Örneğin, hesabınızın en son 25 Drive etkinliğini listeleyen ve 180 güne kadar olan bir rapor isteyebilirsiniz. Bu raporu almak için yetkilendirme kılavuzunda açıklandığı şekilde bir yetkilendirme jetonu alın ve 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ının örnek yanıtını görebilirsiniz.

Aşağıdaki örnekte, son 180 gün (maksimum süre) içindeki tüm Drive etkinliklerinin raporu alını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 etkinliklerine ilişkin 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 olur.

Aşağıdaki örnekte, belirtilen kullanıcı tarafından yapılan tüm değişiklikleri listeleyen 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/[e-mail]
/applications/drive

Ortak Drive'lar için Google Drive etkinliklerini alma

Yetkilendirme kılavuzunda açıklanan yetkilendirme jetonuyla bir HTTP GET isteği göndererek belirli bir paylaşılan Drive için Google Drive etkinliklerinin raporunu alabilirsiniz. Raporu çalıştırmak istediğiniz kullanıcının e-posta adresini userKey alanına girin veya raporu tüm kullanıcılar için çalıştırmak üzere all'ı 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 filtreleme yapın. 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 etkinliği 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

Belge oluşturma veya düzenleme gibi belirli bir etkinlik türünün tüm örneklerini içeren 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 olur.

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 HTTP GET isteği gönderdiğinizde başarılı bir yanıt HTTP 200 durum kodu döndürür. Yanıt, durum koduyla birlikte Drive için bir rapor döndürür. Bu raporlara Yönetici Konsolu'ndan da erişebilirsiniz. Daha fazla bilgi için Google Workspace Yönetici Yardım Merkezi'ne bakın. eventName hakkında bilgi edinmek 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": "[e-mail]",
   "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": "[e-mail]"
      }
      ]
     }
    ]
   },
  ]
 }