Google Drive Activity API'sine giriş

Google Drive Activity API şunları içerir: DriveActivity kaynağı, Bir kullanıcının Google Drive'ındaki nesnelerde yapılan değişiklikleri temsil eder ve activity.query yöntemini kullanır ve böylece bilgi edinirsiniz.

İstek

Uygulamanız, şunu kullanarak kullanıcının etkinlik verilerini istiyor: activity.query yöntemini kullanabilirsiniz. Etkinlik isteyebilirsiniz belirli bir Drive öğesi için veya bir Drive'da bulunan her şey için emin olmanız gerekir. Belirli bir istek için yanıtı şu kadar kısıtlamayı seçebilirsiniz: Zaman aralığı veya işlem türü gibi kısıtlamalar ve etkinliğin şurada birleştirilmiş olmasını seçebilir: tıklayın. Daha fazla bilgi için Drive Activity API'de istek gönderme başlıklı makaleyi inceleyin.

Yanıt

İsteğin yanıtı, belirtilen parametrelerle eşleşen etkinliklerin listesidir. burada DriveActivity kaynağı her bir etkinliği temsil eder:

Drive Etkinliği açıklaması.

DriveActivity kaynağı, Her biri bulunan Action nesne etkinlik gibi bağımsız koşullar içerir. Action, bir ActionDetail (ör. Create) veya Edit), bir Actor (User gibi) veya Administrator), Target ( DriveItem veya Drive olarak) ve Timestamp veya TimeRange adresine gidin.

DriveActivity kaynağında şunlar da yer alır: özet bilgileri içerir, örneğin Actor ve tüm işlemlerden Target, birleştirilmiş Timestamp veya TimeRange ve en çok önemli veya temsili ActionDetail Action.

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. İster Drive Activity API, bir nesnede yapılan belirli bir değişikliğin değişikliği veya değişiklikle ilgili bilgilerin, kimliği en iyi uygulamaları görelim.

Görünürlük, nesne için ayarlanan izinlere bağlıdır. Birkaç tane dosya ve klasörlerin Drive'da paylaşıldığı senaryolar:

  • Bir yazar bir dokümanı paylaşırsa dokümanın etkinlik geçmişi yalnızca içeriği oluşturan kişi değil, kimliği doğrulanmış kullanıcılar tarafından da görülebilir. kiminle paylaşıldığını gösterir.
  • Bir doküman bir kullanıcıyla paylaşılmışsa ve ardından gizli hale getirilmişse, Kullanıcı, erişimi varken tüm etkinlik geçmişini görebilir ve izinler kısıtlanmış durumda.
  • Doküman hiç bir kullanıcıyla paylaşılmadıysa kullanıcı herhangi bir etkinlik göremez geçmişi'ne dokunun.

Başlayın

Drive Activity API'den en iyi şekilde yararlanmak için uygulamanızı Öncelikle Google Drive API. Drive Activity API'yi kullanmaya başlamak için proje oluşturmayı ve istekleri yetkilendirin. İsterseniz hemen konuya girip programdaki etkinliklerle ilgili API referansı.