- Permintaan HTTP
- Isi permintaan
- Isi respons
- Cakupan otorisasi
- ConsolidationStrategy
- NoConsolidation
- Lama
- Cobalah!
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 ( |
Kolom | |
---|---|
consolidationStrategy |
Detail tentang cara menggabungkan tindakan terkait yang membentuk aktivitas. Jika tidak ditetapkan, tindakan terkait tidak akan digabungkan. |
pageSize |
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 |
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 |
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:
|
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 |
Tampilkan aktivitas untuk item Drive ini. Formatnya adalah |
ancestorName |
Menampilkan aktivitas untuk folder Drive ini, serta semua turunan dan turunan. Formatnya adalah |
Isi respons
Jika berhasil, isi respons memuat data dengan struktur berikut:
Pesan respons untuk mengkueri aktivitas Drive.
Representasi JSON |
---|
{
"activities": [
{
object ( |
Kolom | |
---|---|
activities[] |
Daftar aktivitas yang diminta. |
nextPageToken |
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 |
Kolom | |
---|---|
Kolom union strategy . Cara menggabungkan setiap aktivitas. strategy hanya ada berupa salah satu diantara berikut: |
|
none |
Setiap aktivitas tidak digabungkan. |
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.