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şlemleri birleştirme hakkında ayrıntılar. Ayarlanmazsa ilgili işlemler birleştirilmez.
pageSize

integer

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

string

Jeton, hangi sonuç sayfasının döndürüleceğini tanımlar. Sonraki sonuç sayfasını almak için bunu önceki bir 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 "AND" ile birleştirilmiş bir ifade dizisidir. Her ifade "alan operatör değeri" biçimindedir.

Desteklenen alanlar:

  • time: Tarih değerlerinde 1 Ocak 1970'ten 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: "Şunu içerir" operatörünü (:) ve tek bir değer ya da parantez içinde boşlukla ayrılmış olarak izin verilen işlem türlerinin listesini kullanır. 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
Birleştirme alanı key. Sorgudaki birincil ölçütler. Hiçbir anahtar belirtilmezse varsayılan değer ancestorName = items/root olur. key yalnızca aşağıdakilerden biri olabilir:
itemName

string

Bu Drive öğesi için döndürülen etkinlikler. Biçim items/ITEM_ID'dır.
ancestorName

string

Bu Drive klasörü ve tüm alt öğeleri ile torunları için etkinlikleri döndürür. Biçim items/ITEM_ID'dır.

Yanıt gövdesi

Drive etkinliğini sorgulama için 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)

İstenen etkinliklerin listesi.
nextPageToken

string

Sonraki sonuç sayfasını almak için kullanılan jeton. Listede başka sonuç yoksa boş olur.

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ılavuzu'na bakın.

ConsolidationStrategy

Ayrı ayrı etkinliklerin nasıl birleştirildiği. Bir dizi etkinlik ilişkiliyse tek bir birleşik etkinlikte birleştirilebilir. Örneğin, bir aktörün aynı işlemi birden fazla hedefte gerçekleştirmesi veya birden fazla aktörün aynı işlemi tek bir hedefte gerçekleştirmesi. Strateji, hangi etkinliklerin ilişkili olduğuna dair 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 yalnızca aşağıdakilerden 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 yok.

Ayrı etkinliklerin birleştirilmediği bir strateji.

Eski

Bu türde alan yok.

Eski V1 Activity API'deki gruplandırma kurallarını kullanarak etkinlikleri birleştiren bir strateji. Belirli bir zaman aralığında gerçekleşen benzer işlemler birden fazla hedef (ör. bir dizi dosyanın aynı anda taşınması) veya birden fazla aktör (ör. aynı öğenin birden fazla kullanıcı tarafından düzenlenmesi) arasında gruplandırılabilir. Bu stratejideki gruplandırma kuralları her işlem türüne özeldir.