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 akan mencoba menampilkan setidaknya kuantitas ini. Server juga dapat menampilkan lebih sedikit aktivitas jika respons sebagian sudah siap sebelum waktu permintaan habis. Jika tidak disetel, nilai default akan digunakan.

pageToken

string

Token mengidentifikasi halaman hasil yang akan ditampilkan. Setel ini ke nilai nextPageToken yang ditampilkan dari kueri sebelumnya untuk mendapatkan halaman hasil berikut. Jika tidak disetel, halaman pertama hasil akan ditampilkan.

filter

string

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

Kolom yang didukung:

  • time: Menggunakan operator numerik pada nilai tanggal baik dalam 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. Defaultnya adalah ancestorName = items/root, jika tidak ada kunci yang ditentukan. key hanya dapat berupa salah satu dari berikut:
itemName

string

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

ancestorName

string

Menampilkan 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 lagi hasil 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 informasi selengkapnya, lihat Panduan otorisasi.

ConsolidationStrategy

Cara menggabungkan setiap aktivitas. Jika sekumpulan aktivitas terkait, aktivitas tersebut dapat digabungkan menjadi satu aktivitas gabungan, seperti satu pelaku yang melakukan tindakan yang sama pada beberapa target, atau beberapa pelaku yang melakukan tindakan yang sama pada satu target. Strategi menentukan aturan yang berkaitan 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 menggabungkan setiap aktivitas. strategy hanya ada berupa salah satu diantara berikut:
none

object (NoConsolidation)

Setiap aktivitas tidak digabungkan.

legacy

object (Legacy)

Setiap aktivitas digabungkan menggunakan strategi lama.

NoConsolidation

Strategi yang tidak melakukan konsolidasi aktivitas individual.

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 sekumpulan file sekaligus) atau beberapa pelaku (seperti beberapa pengguna yang mengedit item yang sama). Pengelompokan aturan untuk strategi ini bersifat khusus untuk setiap jenis tindakan.