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.