- HTTP isteği
- İstek metni
- Yanıt metni
- Yetkilendirme kapsamları
- ConsolidationStrategy
- NoConsolidation
- Eski
- Deneyin.
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 ( |
Alanlar | |
---|---|
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 |
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 |
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 |
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:
|
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 |
Bu Drive öğesi için iade etkinlikleri. Biçimi şöyledir: |
ancestorName |
Bu Drive klasörü ile tüm alt öğeler ve alt öğeler için gerçekleştirilen etkinlikler iade edilir. Biçimi şöyledir: |
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 ( |
Alanlar | |
---|---|
activities[] |
Etkinlik listesi istendi. |
nextPageToken |
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 |
Alanlar | |
---|---|
strategy alanı. Bağımsız etkinliklerin nasıl birleştirildiği. strategy şunlardan yalnızca biri olabilir: |
|
none |
Bağımsız etkinlikler birleştirilmez. |
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.