Google Drive Activity API, kullanıcının Google Drive'ındaki nesnelerde yapılan değişiklikleri temsil eden DriveActivity kaynağı 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. Etkinlik isteğini belirli bir Drive öğesi veya Drive klasöründe yer alan her şey için yapabilirsiniz. Belirli bir istek için yanıtı zaman aralığı veya işlem türü gibi kısıtlamalarla sınırlandırmayı seçebilir ve etkinliğin yanıtta birleştirilmesini sağlayabilirsiniz. Daha fazla bilgi için Drive Activity API'de istek oluşturma başlıklı makaleyi inceleyin.
Yanıt
İsteğe verilen yanıt, belirtilen parametrelerle eşleşen etkinliklerin listesidir. Burada DriveActivity kaynağı her etkinliği temsil eder:
DriveActivity kaynağı, her biri etkinlik gibi bağımsız olan Action nesnelerden oluşan bir koleksiyondur. Bir Action, ActionDetail (ör. Create veya Edit), Actor (ör. User veya Administrator), Target (ör. DriveItem veya Drive) ve Timestamp veya TimeRange içerir.
DriveActivity kaynağı, tüm işlemlerden elde edilen her Actor ve Target gibi özet bilgilerin yanı sıra birleştirilmiş bir Timestamp veya TimeRange ve Action'nin en önemli ya da temsili ActionDetail öğesini 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 bildirilmez. Drive Activity API'nin bir nesnede yapılan belirli bir değişikliği bildirip bildirmediği, 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 ayarlanan izinlere bağlıdır. Drive'da dosya ve klasörlerin paylaşıldığı çeşitli senaryolar vardır:
- Bir yazar bir dokümanı paylaştığında, dokümanın etkinlik geçmişi yalnızca oluşturucu 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 kullanıcıyla paylaşıldıktan sonra gizli hale getirilirse kimliği doğrulanmış kullanıcı, erişimi olduğu süre boyunca tüm etkinlik geçmişini görebilir ve izinlerin artık kısıtlandığını anlayabilir.
- Bir doküman hiçbir zaman kullanıcıyla paylaşılmadıysa 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şturma ve istekleri yetkilendirme hakkında bilgi edinin. İsterseniz doğrudan API referansındaki etkinlikler hakkında bilgi edinebilirsiniz.