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ı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ü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ıtlamalarla kısıtlayabilir ve yanıtta etkinliğin 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ğin yanıtı, belirtilen parametrelerle eşleşen etkinliklerin listesidir. Burada DriveActivity kaynağı her bir etkinliği temsil eder:
DriveActivity kaynağı, her biri bir etkinlik gibi bağımsız olan Action nesnelerinden oluşan bir koleksiyondur. Action; ActionDetail (ör. Create veya Edit), Actor (User veya Administrator gibi), Target (DriveItem veya Drive gibi) ve Timestamp ya da TimeRange içerir.
DriveActivity kaynağı, tüm işlemlerdeki her Actor ve Target gibi özet bilgileri, birleştirilmiş Timestamp veya TimeRange ve Action öğesinin en önemli veya temsiliActionDetail olanını da içerir.
Daha fazla bilgi için Drive Activity API veri modeli sayfasına göz atı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 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 vardır:
- Bir yazar bir dokümanı paylaşırsa dokümanın etkinlik geçmişi yalnızca oluşturan kişi 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şıldıktan sonra gizli hale getirildiyse kimliği doğrulanmış kullanıcı, erişimi varken tüm etkinlik geçmişini ve artık izinlerin kısıtlı olduğunu görebilir.
- Doküman hiç bir kullanıcıyla paylaşılmadıysa kullanıcı herhangi bir 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. Alternatif olarak, API referansından doğrudan etkinliklere göz atabilirsiniz.