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 bir Drive klasörünün altında bulunan her şey için etkinlik isteyebilirsiniz. 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 bir etkinlik gibi bağımsız olan Action nesnelerinden oluşan bir koleksiyondur. Action, ActionDetail (Create veya Edit gibi), Actor (User veya Administrator gibi), 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 nesneyle ilgili belirli bir değişikliği bildirip bildirmemesi, değişikliğin veya değişiklikle ilgili bilgilerin uygulamanızdaki kimliği doğrulanmış kullanıcıya görünür olup olmamasına bağlıdır.
Görünürlük, nesne için belirlenen izinlere bağlıdır. Drive'da dosya ve klasörler paylaşıldığında 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.