Bu belgede, Google Drive Activity API'ye genel bir bakış sunulmaktadır.
Drive Activity API, son etkinlikleri sorgulamanıza olanak tanır. Her etkinlikle ilgili ayrıntılı bilgiler de dahil olmak üzere tüm etkinliklerin ayrıntılı geçmişini getirebilirsiniz. ActionDetail, Actor ve Target bilgilerini içeren kesin etkinlikleri alabileceğiniz için bu özellik, denetim gibi görevler için kullanışlıdır.
Drive Activity API, kullanıcının Google Drive'ındaki nesnelerde yapılan değişiklikleri temsil eden DriveActivity kaynağı ve bu değişikliklerle ilgili bilgileri almanızı sağlayan activity.query yönteminden oluşur.
İstek
Uygulamanız, activity.query yöntemini kullanarak kullanıcının etkinlik verilerini istiyor. Belirli bir Drive öğesi veya bir Drive klasöründe yer alan her şey için etkinlik isteğinde bulunabilirsiniz. Belirli bir istek için yanıtı zaman aralığı veya işlem türü gibi bir filtre kullanarak kısıtlamayı seçebilir ve yanıtta etkinliğin birleştirilmesini seçebilirsiniz. Daha fazla bilgi için Google Drive Activity API'de istek oluşturma başlıklı makaleyi inceleyin.
Yanıt
Yanıt, verilen parametrelerle eşleşen etkinliklerin listesini içerir. Burada DriveActivity kaynağı her etkinliği temsil eder:
DriveActivity kaynağı, her biri etkinlik gibi bağımsız olan Action nesnelerden oluşan bir koleksiyondur. Bir Action, ActionDetail (ör. Create veya Edit), Actor (ör. User veya Administrator), Target (ör. DriveItem veya Drive) ve Timestamp veya TimeRange içerir.
DriveActivity kaynağı, tüm işlemlerden elde edilen her Actor ve Target gibi özet bilgilerin yanı sıra birleştirilmiş bir Timestamp veya TimeRange ve Action'nin en önemli ya da temsili ActionDetail'ını da içerir.
Daha fazla bilgi için Drive Activity API veri modeline bakın.
Etkinlik geçmişinin görünürlüğü
Drive Activity API'yi kullandığınızda Drive'daki bazı etkinlikler raporlanmayabilir. API'nin bir nesnedeki belirli bir değişikliği bildirip bildirmediği, değişikliğin veya değişiklikle ilgili bilgilerin uygulamanızdaki kimliği doğrulanmış kullanıcı tarafından görülebilmesine bağlıdır.
Görünürlük, nesne için ayarlanan izinlere bağlıdır. Drive'da dosya ve klasörlerin paylaşıldığı çeşitli senaryolar vardır:
Bir yazar bir dokümanı paylaştığında, dokümanın etkinlik geçmişi hem oluşturucu hem de dokümanın paylaşıldığı kullanıcılar tarafından görülebilir.
Bir doküman kullanıcıyla paylaşıldıktan sonra gizli hale getirilirse kullanıcı, erişimi olduğu dönemdeki tüm etkinlik geçmişini görebilir ancak izinler kısıtlandıktan sonraki etkinlikleri göremez.
Bir doküman hiçbir zaman kullanıcıyla paylaşılmadıysa kullanıcı, etkinlik geçmişini göremez.
İlgili konular
- Drive Activity API'den en iyi şekilde yararlanmak için öncelikle uygulamanızı Google Drive API ile entegre edin.
- Google Workspace API'leriyle geliştirme (ör. proje oluşturma veya kimlik doğrulama ve yetkilendirme işlemleri) hakkında bilgi edinmek için Google Workspace'te geliştirme başlıklı makaleyi inceleyin.
- Etkinlikler hakkında bilgi edinmek için API referansına bakın.