Method: activity.query

Membuat kueri aktivitas sebelumnya di Google Drive.

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "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.
}
Kolom
consolidationStrategy

object (ConsolidationStrategy)

Detail tentang cara menggabungkan tindakan terkait yang membentuk aktivitas. Jika tidak ditetapkan, tindakan terkait tidak akan digabungkan.
pageSize

integer

Jumlah minimum aktivitas yang diinginkan dalam respons; server berusaha mengembalikan setidaknya jumlah ini. Server juga dapat menampilkan lebih sedikit aktivitas jika respons sebagian sudah siap sebelum waktu permintaan habis. Jika tidak ditetapkan, nilai default akan digunakan.
pageToken

string

Token mengidentifikasi halaman hasil yang akan ditampilkan. Tetapkan parameter ini ke nilai nextPageToken yang ditampilkan dari kueri sebelumnya untuk mendapatkan halaman hasil berikut. Jika tidak ditetapkan, halaman pertama hasil akan ditampilkan.
filter

string

Pemfilteran untuk item yang ditampilkan dari permintaan kueri ini. Format string filter adalah urutan ekspresi, digabungkan dengan "AND", opsional, dan setiap ekspresi berbentuk "nilai operator kolom".

Kolom yang didukung:

  • time: Menggunakan operator numerik pada nilai tanggal dalam bentuk milidetik sejak 1 Januari 1970 atau dalam format RFC 3339. Contoh:

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

  • detail.action_detail_case: Menggunakan operator "has" (:) dan nilai tunggal atau daftar jenis tindakan yang diizinkan dalam tanda kurung, dipisahkan dengan spasi. Untuk mengecualikan hasil dari respons, tambahkan tanda hubung (-) di awal string filter. Contoh:

    • detail.action_detail_case:RENAME
    • detail.action_detail_case:(CREATE RESTORE)
    • -detail.action_detail_case:MOVE
Kolom union key. Kriteria utama dalam kueri. Jika tidak ada kunci yang ditentukan, defaultnya adalah ancestorName = items/root. key hanya dapat berupa salah satu dari berikut:
itemName

string

Tampilkan aktivitas untuk item Drive ini. Formatnya adalah items/ITEM_ID.
ancestorName

string

Tampilkan aktivitas untuk folder Drive ini, serta semua turunan dan turunan. Formatnya adalah items/ITEM_ID.

Isi respons

Jika berhasil, isi respons memuat data dengan struktur berikut:

Pesan respons untuk mengkueri aktivitas Drive.

Representasi JSON 
{
  "activities": [
    {
      object (DriveActivity)
    }
  ],
  "nextPageToken": string
}
Kolom
activities[]

object (DriveActivity)

Daftar aktivitas yang diminta.
nextPageToken

string

Token untuk mengambil halaman hasil berikutnya, atau kosong jika tidak ada hasil lagi dalam daftar.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Panduan otorisasi.

Strategi Konsolidasi

Cara aktivitas gabungan digabungkan. Jika serangkaian aktivitas terkait, mereka dapat digabungkan ke dalam satu aktivitas gabungan, seperti satu aktor yang melakukan tindakan yang sama di beberapa target, atau beberapa aktor yang melakukan tindakan yang sama pada satu target. Strategi ini menentukan aturan yang terkait dengan aktivitas.

Representasi JSON 
{

  // 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.
}
Kolom
Kolom union strategy. Cara aktivitas gabungan digabungkan. strategy hanya dapat berupa salah satu dari berikut:
none

object (NoConsolidation)

Aktivitas individu tidak digabungkan.
legacy

object (Legacy)

Aktivitas individu digabungkan menggunakan strategi lama.

Tanpa Konsolidasi

Strategi yang tidak menggabungkan aktivitas individu.

Lama

Strategi yang menggabungkan aktivitas menggunakan aturan pengelompokan dari V1 Activity API lama. Tindakan serupa yang terjadi dalam jangka waktu tertentu dapat dikelompokkan di beberapa target (seperti memindahkan kumpulan file sekaligus) atau beberapa aktor (seperti beberapa pengguna mengedit item yang sama). Aturan pengelompokan untuk strategi ini spesifik untuk setiap jenis tindakan.