Method: activity.query

Mengkueri 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 jumlah ini. Server juga dapat menampilkan lebih sedikit aktivitas jika memiliki respons parsial yang siap sebelum waktu permintaan habis. Jika tidak disetel, nilai default akan digunakan.
pageToken

string

Token mengidentifikasi halaman hasil yang akan ditampilkan. Tetapkan 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 berupa "nilai operator kolom".

Kolom yang didukung:

  • time: Menggunakan operator numerik pada nilai tanggal dalam milidetik sejak 1 Jan 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 "has" operator (:) dan nilai tunggal atau daftar jenis tindakan yang diizinkan dan diapit oleh tanda kurung, dipisahkan dengan spasi. Untuk mengecualikan hasil dari respons, tambahkan tanda hubung (-) ke 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 yang 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 turunannya. Formatnya adalah items/ITEM_ID.

Isi respons

Pesan respons untuk mengkueri aktivitas Drive.

Jika berhasil, isi respons memuat data dengan struktur berikut:

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

Bagaimana masing-masing aktivitas digabungkan. Jika serangkaian aktivitas terkait, aktivitas tersebut dapat digabungkan menjadi satu aktivitas gabungan, seperti satu aktor yang melakukan tindakan yang sama pada beberapa target, atau beberapa aktor yang melakukan tindakan yang sama pada satu target. Strategi ini menetapkan aturan terkait aktivitas mana yang terkait.

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. Bagaimana masing-masing aktivitas digabungkan. strategy hanya dapat berupa salah satu dari berikut:
none

object (NoConsolidation)

Masing-masing aktivitas tidak dikonsolidasikan.
legacy

object (Legacy)

Setiap aktivitas digabungkan menggunakan strategi lama.

NoConsolidation

Jenis ini tidak memiliki kolom.

Strategi yang tidak melakukan konsolidasi atas aktivitas individual.

Lama

Jenis ini tidak memiliki kolom.

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