Reports API: Drive Etkinlik Raporu

Drive etkinlik raporu, kullanıcılarınızın etkinlikler Google Workspace üzerinden Google Drive'da dosya yönetme, değiştirme ve paylaşma Örneğin, Drive etkinlik raporunu kullanarak Belirli bir kullanıcı tarafından oluşturulan tüm yeni Drive dokümanlarının belirtilen tarih aralığı. Bu bilgileri, müşteri yolculuğunun her aşamasında olası veri sızıntılarını giderir. Rapor almak için Rapora özel parametrelere sahip temel rapor uç nokta isteği: veya belirli bir türdeki Google Drive'da yapılan bir değişikliktir. Raporlar son 180 güne kadarki verileri dahil etmelidir.

Google Drive etkinlik raporu, bir lisans atanmış olmalıdır.

İsteğin sorgu dizeleri ve yanıt özellikleri hakkında bilgi için API Referansı'nı inceleyin. Örneğin, Google Drive ile ilişkili etkinlikler hakkında bilgi, bkz. Drive etkinlik adları.

Bir alan adı için Google Drive etkinliklerini alma

Drive etkinlik raporunu kullanarak, Drive dokümanları. Örneğin bir rapor girişi isteyebilirsiniz. hesabınızın 180'e kadar veriyi kapsayan en son 25 Drive etkinliği gün. Bu raporu almak için, yetkilendirme rehberine göz atın, ardından aşağıdaki HTTP GET isteği:

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, tüm Drive verilerinin etkinlik sayısı: son 180 gündeki maksimum dönem.

GET https://admin.googleapis.com/admin/reports/v1/activity/users/all
/applications/drive

Google Drive etkinliklerini kullanıcıya göre alma

Belirli bir kullanıcının Google Drive etkinlikleriyle ilgili raporu almak için Şurada açıklanan yetkilendirme jetonuna sahip HTTP GET isteği: yetkilendirme kılavuzu kılavuzu. userKey alanı, rapordaki kullanıcının birincil e-posta adresidir veya Tüm kullanıcılar için all.

Aşağıdaki örnek, belirtilen kullanıcı. API yanıtı örneği için bkz. sample JSON response (örnek JSON yanıtı).

GET https://admin.googleapis.com/admin/reports/v1/activity/users/kim@example.com
/applications/drive

Ortak Drive'lar için Google Drive etkinliklerini alma

Belirli bir paylaşılan kullanıcıyla ilgili Google Drive etkinliklerinin raporunu alabilirsiniz GET yetkilendirme rehberine bakın. Belirtin: userKey alanında, raporu çalıştırmak istediğiniz kullanıcının e-posta adresini girin. veya raporu tüm kullanıcılar üzerinde çalıştırmak için all değerini belirtin.

Aşağıdaki örnekte, paylaşılan belirli bir rapora ait tüm değişikliklerin gerekir. 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'daki etkinlikleri almak için doc_type kullanarak filtreleyin. İlgili içeriği oluşturmak için kullanılan 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 özelliğini belirtin. unutmayın. Aşağıdaki örnekte, ortak Drive'lara yapılan tüm üye eklemeleri alınmıştı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 tüm örneklerinin raporunu almak için (örneğin, Bir dokümanı düzenlemek için yetkilendirme ile HTTP GET anahtarı yetkilendirme kılavuzunda açıklanmıştır. userKey alanı, rapordaki kullanıcının birincil e-posta adresidir veya Tüm kullanıcılar için all.

Aşağıdaki örnek, tüm hesap belgeleri oluşturma işlemini gösteren bir rapor alır yardımcı olur. 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ğinde bulunduğunuzda başarılı bir yanıt HTTP 200 durum kodu. Yanıt, durum koduyla birlikte bir rapor döndürür Drive için. Bu raporlar ayrıca, Yönetici Konsolu. Daha fazla bilgi için Google Workspace Yönetici Yardım Merkezi. eventName bilgileri için bkz. Drive etkinlik adları bir referans noktası olarak kabul edilir. İsteğin sorgu dizeleri ve özellikleri 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"
      }
      ]
     }
    ]
   },
  ]
 }