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şikliklerle ilgili bilgileri almanıza olanak tanıyan 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 Drive klasöründeki her şey için etkinlik isteğinde bulunabilirsiniz. Belirli bir istek için yanıtı zaman aralığı veya işlem türü gibi kısıtlamalara göre kısıtlamayı ve etkinliğin yanıtta birleştirilmesini seçebilirsiniz. Daha fazla bilgi için Drive Activity API'de istek gönderme başlıklı makaleyi inceleyin.
Yanıt
Bir isteğe verilen yanıt, belirli parametrelerle eşleşen etkinliklerin listesidir. Bu listede her etkinlik bir DriveActivity kaynağıyla temsil edilir:
DriveActivity kaynağı, her biri etkinlik gibi kendi kendine yeten Action nesnelerinden oluşan bir koleksiyondur. Action, bir ActionDetail (Create veya Edit gibi), bir Actor (User veya Administrator gibi), bir Target (DriveItem veya Drive gibi) ve Timestamp veya TimeRange içerir.
DriveActivity kaynakları, tüm işlemlerdeki her Actor ve Target gibi özet bilgiler, birleşik bir Timestamp veya TimeRange ve Action'deki en önemli ya da temsili ActionDetail gibi özet bilgiler de içerir.
Daha fazla bilgi için Drive Activity API veri modeline bakın.
Etkinlik geçmişinin görünürlüğü
Bu API'yi kullandığınızda Drive'daki bazı etkinlikler raporlanmayabilir. Drive Activity API'nin bir nesnede yapılan belirli bir değişikliği bildirmesi, değişikliğin veya değişiklikle ilgili bilgilerin uygulamanızda kimliği doğrulanmış kullanıcı tarafından görülebilmesine bağlıdır.
Görünürlük, nesne için belirlenen izinlere bağlıdır. Drive'da dosya ve klasörlerin paylaşıldığı birkaç senaryo vardır:
- Bir yazar bir dokümanı paylaşırsa dokümanın etkinlik geçmişi yalnızca dokümanı oluşturan kullanıcıya değil, dokümanın paylaşıldığı kimliği doğrulanmış kullanıcılara da gösterilir.
- Bir doküman bir kullanıcıyla paylaşıldıktan sonra özelleştirildiyse kimliği doğrulanmış kullanıcı, erişimi olduğu sıradaki tüm etkinlik geçmişini ve izinlerin artık kısıtlandığını görebilir.
- Bir doküman hiç bir kullanıcıyla paylaşılmamışsa ilgili kullanıcı etkinlik geçmişini göremez.
Başlayın
Drive Activity API'den en iyi şekilde yararlanmak için uygulamanızı önce Google Drive API ile entegre edin. Drive Activity API'yi kullanmaya başlamak için proje oluşturmayı ve istekleri yetkilendirmeyi öğrenin. Dilerseniz hemen API referansında etkinlikler hakkında bilgi edinebilirsiniz.