Method: activity.query

Google Drive'daki geçmiş etkinlikleri sorgulama.

HTTP isteği

POST https://driveactivity.googleapis.com/v2/activity:query

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

İstek içeriği

İstek metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "consolidationStrategy": {
    object (ConsolidationStrategy)
  },
  "pageSize": integer,
  "pageToken": string,
  "filter": string,

  // Union field key can be only one of the following:
  "itemName": string,
  "ancestorName": string
  // End of list of possible types for union field key.
}
Alanlar
consolidationStrategy

object (ConsolidationStrategy)

Etkinliği oluşturan ilgili işlemlerin nasıl birleştirileceğine dair ayrıntılar. Ayarlanmazsa ilgili işlemler birleştirilmez.
pageSize

integer

Yanıtta istenen minimum etkinlik sayısı; sunucu en az bu miktarı döndürmeye çalışır. Sunucu, istek zaman aşımına uğramadan önce hazır kısmi bir yanıtı varsa daha az etkinlik döndürebilir. Ayarlanmazsa varsayılan değer kullanılır.
pageToken

string

Jeton, döndürülecek sonuç sayfasını tanımlar. Aşağıdaki sonuç sayfasını elde etmek için bunu, önceki sorgudan döndürülen nextPageToken değerine ayarlayın. Ayarlanmazsa sonuçların ilk sayfası döndürülür.
filter

string

Bu sorgu isteğinden döndürülen öğeler için filtreleme. Filtre dizesinin biçimi, isteğe bağlı bir "VE" ile birleştirilen bir ifade dizisidir. Her ifade "alan operatörü değer" biçimindedir.

Desteklenen alanlar:

  • time: Tarih değerlerinde 1 Ocak 1970'den itibaren milisaniye cinsinden veya RFC 3339 biçiminde sayısal operatörler kullanır. Örnekler:

    • time > 1452409200000 AND time <= 1492812924310
    • time >= "2016-01-10T01:02:03-05:00"

  • detail.action_detail_case: "has" kelimesini kullanır işleci (:) ile birlikte tekil bir değer veya parantez içinde boşlukla ayrılmış izin verilen işlem türlerinin bir listesidir. Bir sonucu yanıttan hariç tutmak için filtre dizesinin başına kısa çizgi (-) ekleyin. Örnekler:

    • detail.action_detail_case:RENAME
    • detail.action_detail_case:(CREATE RESTORE)
    • -detail.action_detail_case:MOVE
Birlik alanı key. Sorgudaki birincil ölçüt. Anahtar belirtilmezse varsayılan değer ancestorName = items/root şeklindedir. key yalnızca aşağıdakilerden biri olabilir:
itemName

string

Bu Drive öğesi için etkinlikleri geri ver. Biçim şöyledir: items/ITEM_ID.
ancestorName

string

Bu Drive klasörünün yanı sıra tüm alt klasörleri ve alt öğeleri için etkinlikleri döndürme. Biçimi items/ITEM_ID'tir.

Yanıt gövdesi

Drive etkinliğini sorgulamaya yönelik yanıt mesajı.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "activities": [
    {
      object (DriveActivity)
    }
  ],
  "nextPageToken": string
}
Alanlar
activities[]

object (DriveActivity)

Etkinlik listesi istendi.
nextPageToken

string

Sonuçların sonraki sayfasını almak için kullanılan jeton. Listede başka sonuç yoksa boş bırakın.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamlarından birini gerektirir:

  • https://www.googleapis.com/auth/drive.activity
  • https://www.googleapis.com/auth/drive.activity.readonly

Daha fazla bilgi için Yetkilendirme kılavuzunu inceleyin.

ConsolidationStrategy

Her bir etkinliğin nasıl bir araya getirildiği. Bir etkinlik grubu birbiriyle ilişkiliyse tek bir birleşik etkinlikte birleştirilebilir. Örneğin, bir aktör birden fazla hedefte aynı işlemi gerçekleştirebilir veya birden fazla aktör tek bir hedefte aynı işlemi gerçekleştirebilir. Strateji, etkinliklerin birbiriyle ilişkili olduğu kuralları tanımlar.

JSON gösterimi 
{

  // Union field strategy can be only one of the following:
  "none": {
    object (NoConsolidation)
  },
  "legacy": {
    object (Legacy)
  }
  // End of list of possible types for union field strategy.
}
Alanlar
Birleştirme alanı strategy. Ayrı ayrı etkinliklerin nasıl birleştirildiği. strategy şunlardan yalnızca biri olabilir:
none

object (NoConsolidation)

Ayrı etkinlikler birleştirilmez.
legacy

object (Legacy)

Ayrı etkinlikler eski strateji kullanılarak birleştirilir.

NoConsolidation

Bu türde alan yoktur.

Bağımsız etkinlikleri birleştirmeyen bir strateji.

Eski

Bu türde alan yoktur.

Eski V1 Activity API'nin gruplama kurallarını kullanarak etkinlikleri birleştiren bir strateji. Bir zaman aralığında gerçekleşen benzer işlemler, birden fazla hedef (ör. bir grup dosyayı aynı anda taşıma) veya birden fazla aktör (ör. aynı öğeyi düzenleyen birkaç kullanıcı) arasında gruplandırılabilir. Bu stratejinin gruplandırma kuralları her işlem türüne özeldir.