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 gövdesi aşağıdaki yapıya sahip 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 bir değer kullanılır.
pageToken

string

Jeton, hangi sonuç sayfasının döndürüleceğini 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, her ifadenin "alan operatörü değeri" biçiminde olduğu, isteğe bağlı bir "VE" ile birleştirilen bir ifadeler dizisidir.

Desteklenen alanlar:

  • time: 1 Ocak 1970 tarihinden itibaren milisaniye cinsinden veya RFC 3339 biçiminde, tarih değerlerinde 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
Birleştirme alanı key. Sorgudaki birincil ölçüt. Anahtar belirtilmezse varsayılan değer ancestorName = items/root şeklindedir. key şunlardan yalnızca biri olabilir:
itemName

string

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

string

Bu Drive klasörü ile birlikte tüm alt öğeleri ve alt öğeleri döndür. Biçim şöyledir: items/ITEM_ID.

Yanıt gövdesi

Drive etkinliğini sorgulamak için gönderilen 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 kümesi birbiriyle ilişkiliyse bunlar birleşik tek bir etkinlikte birleştirilebilir. Örneğin, bir kullanıcının aynı işlemi birden çok hedefte yapması veya birden fazla kullanıcının tek bir hedef üzerinde aynı işlemi gerçekleştirmesi. 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. Her bir etkinliğin nasıl bir araya getirildiği. strategy şunlardan yalnızca biri olabilir:
none

object (NoConsolidation)

Tek tek etkinlikler birleştirilmez.
legacy

object (Legacy)

Tek tek etkinlikler eski strateji kullanılarak birleştirilir.

NoConsolidation

Bu türde alan yok.

Tek tek faaliyetlerin birleştirilmediği bir strateji.

Eski

Bu türde alan yok.

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