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 disetel, tindakan terkait tidak akan digabungkan.
pageSize

integer

Jumlah minimum aktivitas yang diinginkan dalam respons; server mencoba menampilkan setidaknya jumlah ini. Server juga dapat menampilkan lebih sedikit aktivitas jika memiliki respons parsial yang siap sebelum permintaan kehabisan waktu. 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 berikutnya. 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 "field operator value".

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 yang diapit dalam tanda kurung, yang dipisahkan oleh 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. Nilai defaultnya adalah ancestorName = items/root, jika tidak ada kunci yang ditentukan. key hanya dapat berupa salah satu dari hal berikut:
itemName

string

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

string

Menampilkan aktivitas untuk folder Drive ini, ditambah semua turunan dan keturunan. Formatnya adalah items/ITEM_ID.

Isi respons

Pesan respons untuk membuat kueri 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 mengetahui informasi selengkapnya, lihat Panduan otorisasi.

ConsolidationStrategy

Cara aktivitas individual 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 menentukan aturan untuk 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. Cara aktivitas individual digabungkan. strategy hanya dapat berupa salah satu dari berikut:
none

object (NoConsolidation)

Aktivitas individual tidak digabungkan.
legacy

object (Legacy)

Aktivitas individual digabungkan menggunakan strategi lama.

NoConsolidation

Jenis ini tidak memiliki kolom.

Strategi yang tidak menggabungkan aktivitas individual.

Lama

Jenis ini tidak memiliki kolom.

Strategi yang menggabungkan aktivitas menggunakan aturan pengelompokan dari Activity API V1 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). Aturan pengelompokan untuk strategi ini khusus untuk setiap jenis tindakan.