Method: activity.query

Google Drive'daki geçmiş etkinliği sorgulayın.

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ıyla birlikte veriler 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. Politika ayarlanmazsa ilgili işlemler birleştirilmez.
pageSize

integer

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

string

Bu jeton, hangi sonuç sayfasının döndürüleceğini tanımlar. Aşağıdaki sonuç sayfasını elde etmek için önceki sorgudan döndürülen nextPageToken değerine ayarlayın. Politika 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ştirilen bir ifadeler dizisidir. Her ifade, "alan operatör değeri" biçimindedir.

Desteklenen alanlar:

  • time: 1 Ocak 1970'ten 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" operatörünü (:) ve tekil bir değeri veya izin verilen işlem türlerinin boşlukla ayrılmış parantez içine alınmış bir 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
key alanı. Sorgudaki birincil ölçüt. Herhangi bir anahtar belirtilmezse varsayılan değer ancestorName = items/root değeridir. key şunlardan yalnızca biri olabilir:
itemName

string

Bu Drive öğesi için iade etkinlikleri. Biçimi şöyledir: items/ITEM_ID.
ancestorName

string

Bu Drive klasörü ile tüm alt öğeler ve alt öğeler için gerçekleştirilen etkinlikler iade edilir. Biçimi şöyledir: items/ITEM_ID.

Yanıt gövdesi

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

Drive etkinliğini sorgulamak için yanıt mesajı.

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

object (DriveActivity)

Etkinlik listesi istendi.
nextPageToken

string

Sonraki sonuç sayfasını almak için jeton veya listede başka sonuç yoksa boştur.

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ılavuzuna göz atın.

ConsolidationStrategy

Bağımsız etkinliklerin nasıl birleştirildiği. Bir dizi etkinlik ilişkiliyse, bu etkinlikler birleştirilmiş tek bir etkinlik halinde birleştirilebilir (ör. birden fazla hedef üzerinde aynı işlemi gerçekleştiren bir oyuncu veya tek bir hedef üzerinde aynı işlemi gerçekleştiren birden fazla kişi). Strateji, etkinliklerin ilgili 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
strategy alanı. Bağımsız etkinliklerin nasıl birleştirildiği. strategy şunlardan yalnızca biri olabilir:
none

object (NoConsolidation)

Bağımsız etkinlikler birleştirilmez.
legacy

object (Legacy)

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

NoConsolidation

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

Eski

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 çok hedefte (bir grup dosyayı aynı anda taşımak gibi) veya birden çok kullanıcıya (örneğin, aynı öğeyi düzenleyen birkaç kullanıcı) yönelik olarak gruplandırabilir. Bu stratejinin gruplandırma kuralları her işlem türüne özeldir.