Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
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.
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.
[[["Anlaması kolay","easyToUnderstand","thumb-up"],["Sorunumu çözdü","solvedMyProblem","thumb-up"],["Diğer","otherUp","thumb-up"]],[["İhtiyacım olan bilgiler yok","missingTheInformationINeed","thumb-down"],["Çok karmaşık / çok fazla adım var","tooComplicatedTooManySteps","thumb-down"],["Güncel değil","outOfDate","thumb-down"],["Çeviri sorunu","translationIssue","thumb-down"],["Örnek veya kod sorunu","samplesCodeIssue","thumb-down"],["Diğer","otherDown","thumb-down"]],["Son güncelleme tarihi: 2025-08-04 UTC."],[],[],null,["# Introduction to Google Drive Activity API\n\nThe Google Drive Activity API consists of the\n[`DriveActivity`](/workspace/drive/activity/v2/reference/rest/v2/activity/driveactivity) resource, which\nrepresents changes made to objects within a user's Google Drive, and the\n[`activity.query`](/workspace/drive/activity/v2/reference/rest/v2/activity/query) method, which allows you to retrieve\ninformation about those changes.\n\nRequest\n-------\n\nYour app requests a user's activity data using the\n[`activity.query`](/workspace/drive/activity/v2/reference/rest/v2/activity/query) method. You can request activity\neither for a specific Drive item or for everything contained under a Drive\nfolder. For a given request, you can choose to restrict the response by\n[constraints](/workspace/drive/activity/v2/requests#filters) such as time range or action type, and you\ncan choose to have the activity [consolidated](/workspace/drive/activity/v2/requests#consolidation) in the\nresponse. For more information, see [Make requests in the Drive Activity API](/workspace/drive/activity/v2/requests).\n\nResponse\n--------\n\nThe response to a request is a list of activities matching the given parameters,\nwhere a\n[`DriveActivity`](/workspace/drive/activity/v2/reference/rest/v2/activity/driveactivity) resource represents each activity:\n\nA [`DriveActivity`](/workspace/drive/activity/v2/reference/rest/v2/activity/driveactivity) resource is a collection of\n[`Action`](/workspace/drive/activity/v2/reference/rest/v2/activity/action) objects, each of which is\nself-contained like an *event* . An `Action` includes an\n[`ActionDetail`](/workspace/drive/activity/v2/reference/rest/v2/activity/actiondetail) (such as `Create`\nor `Edit`), an [`Actor`](/workspace/drive/activity/v2/reference/rest/v2/activity/actor) (such as `User`\nor `Administrator`), a [`Target`](/workspace/drive/activity/v2/reference/rest/v2/activity/target) (such\nas `DriveItem` or `Drive`), and either a\n[`Timestamp`](/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Timestamp)\nor [`TimeRange`](/workspace/drive/activity/v2/reference/rest/v2/activity/timerange).\n\nA `DriveActivity` resource also contains\nsummary information, such as every\n`Actor` and\n`Target` from all the actions, a unified\n`Timestamp`\nor `TimeRange`, and either the most\nimportant or representative\n`ActionDetail` of the\n`Action`.\n\nFor more information, see the [Drive Activity API data model](/workspace/drive/activity/v2/datamodel).\n\nActivity history visibility\n---------------------------\n\nSome activity on Drive may not be reported when you use this API. Whether the\nDrive Activity API reports a given change to an object depends on whether\nthe change, or information about the change, is visible to the authenticated\nuser in your application.\n\nVisibility is based on the permissions set for the object. There's several\nscenarios when files and folders are shared in Drive:\n\n- If an author shares a document, the activity history for the document is visible to not only the creator, but also to the authenticated users with whom it was shared.\n- If a document was shared with a user and then made private, the authenticated user can see all activity history while they had access and that the permissions are now restricted.\n- If a document was never shared with a user, the user can't see any activity history.\n\nGet started\n-----------\n\nTo get the most out of the Drive Activity API, integrate your app with the\n[Google Drive API](/workspace/drive/api) first. To get started with the Drive Activity API,\nlearn how to [create a project](/workspace/drive/activity/v2/guides/project) and\n[authorize requests](/workspace/guides/configure-oauth-consent). Or, dive right in and read\nabout activities in the\n[API reference](/workspace/drive/activity/v2/reference/rest/v2/activity)."]]
