Google Drive Activity API, kullanıcının Google Drive'ındaki nesnelerde yapılan değişiklikleri temsil eden DriveActivity kaynağından ve bu değişiklikler hakkında bilgi alabilmenizi sağlayan activity.query yönteminden oluşur.
İstek
Uygulamanız, activity.query yöntemini kullanarak bir kullanıcının etkinlik verilerini istiyor. Belirli bir Drive öğesi veya bir Drive klasöründe bulunan her şey için etkinlik isteğinde bulunabilirsiniz. Belirli bir istekte, zaman aralığı veya işlem türü gibi kısıtlamaları kullanarak yanıtı kısıtlamayı ve etkinliğin yanıtta birleştirilmiş olmasını tercih edebilirsiniz. Daha fazla bilgi için Drive Activity API'de istek yapma bölümüne bakın.
Yanıt
Bir isteğe verilen yanıt, belirtilen parametrelerle eşleşen etkinliklerin bir listesidir. Bu listede, bir DriveActivity kaynağı her etkinliği temsil eder:
DriveActivity kaynağı, her biri etkinlik gibi bağımsız olan Action nesnelerinden oluşan bir koleksiyondur. Action, ActionDetail (ör. Create veya Edit), Actor (ör. User veya Administrator), Target (DriveItem veya Drive gibi) ve Timestamp ya da TimeRange içerir.
Ayrıca DriveActivity kaynağı, tüm eylemlerden her Actor ve Target, birleştirilmiş bir Timestamp veya TimeRange ve en önemli veya temsili ActionDetail gibi Action bilgilerini içerir.
Daha fazla bilgi için Drive Activity API veri modeline göz atın.
Etkinlik geçmişi görünürlüğü
Bu API'yi kullanırken Drive'daki bazı etkinlikler raporlanmayabilir. Drive Activity API'nin bir nesnede yapılan belirli bir değişikliği bildirip bildirmeyeceği, değişikliğin veya değişiklikle ilgili bilgilerin uygulamanızda kimliği doğrulanmış kullanıcıya görünür olup olmadığına bağlıdır.
Görünürlük, nesne için ayarlanan izinlere bağlıdır. Drive'da dosya ve klasörler paylaşıldığında birkaç senaryo olur:
- Yazar bir dokümanı paylaşırsa dokümanın etkinlik geçmişi yalnızca içerik üretici tarafından değil, dokümanın paylaşıldığı kimliği doğrulanmış kullanıcılar tarafından da görülebilir.
- Bir doküman bir kullanıcıyla paylaşılmış ve daha sonra gizli hale getirilmişse, kimliği doğrulanmış kullanıcı, erişim sahibiyken tüm etkinlik geçmişini ve artık izinlerin kısıtlandığını görebilir.
- Bir doküman hiçbir zaman bir kullanıcıyla paylaşılmadıysa kullanıcı herhangi bir etkinlik geçmişini göremez.
Başla
Drive Activity API'den en iyi şekilde yararlanmak için önce uygulamanızı Google Drive API ile entegre edin. Drive Activity API'yi kullanmaya başlamak için proje oluşturmayı ve istekleri yetkilendirmeyi öğrenin. Alternatif olarak, hemen başlayın ve API referansındaki etkinlikler hakkında bilgi edinin.