Menelusuri drive bersama

Panduan ini menjelaskan cara Google Drive API mendukung beberapa cara untuk menelusuri drive bersama.

Untuk menelusuri kumpulan drive bersama tertentu, gunakan kolom string kueri q dengan metode list pada resource drives untuk memfilter drive yang akan ditampilkan dengan menggabungkan satu atau beberapa istilah penelusuran.

String kueri berisi tiga bagian berikut:

query_term operator values

Dengan:

  • query_term adalah istilah kueri atau kolom yang akan ditelusuri.

  • operator menentukan kondisi untuk istilah kueri.

  • values adalah nilai spesifik yang ingin Anda gunakan untuk memfilter hasil penelusuran.

Misalnya, string kueri berikut memfilter penelusuran untuk hanya menampilkan drive bersama dengan nama "Google Drive API resources".

q: name = 'Google Drive API resources' & useDomainAdminAccess=false

Untuk melihat semua istilah kueri drive bersama, lihat Istilah kueri khusus drive bersama.

Untuk melihat semua operator kueri yang dapat Anda gunakan untuk membuat kueri, lihat Operator kueri.

Contoh string kueri

Tabel berikut mencantumkan contoh beberapa string kueri dasar untuk drive bersama. Kode sebenarnya berbeda-beda, bergantung pada library klien yang Anda gunakan untuk penelusuran.

Anda juga harus meng-escape karakter khusus dalam nama file untuk memastikan kueri berfungsi dengan benar. Misalnya, jika nama file berisi karakter apostrof (') dan garis miring terbalik ("\"), gunakan garis miring terbalik untuk mengonversinya: name contains 'quinn\'s paper\\essay'.

Yang harus dikueri Contoh Setelan useDomainAdminAccess
Operator pencocokan string (contains)
Drive bersama dengan kata 'rahasia' dalam judul di antara semua drive bersama yang penggunanya adalah anggota name contains 'confidential' false
Operator persamaan dan pertidaksamaan (=, !=)
Drive bersama yang terlihat di tampilan default hidden = false false
Drive bersama disembunyikan dari tampilan default hidden = true false
Drive bersama tanpa penyelenggara yang ditetapkan organizerCount = 0 true
Drive bersama dengan tepat satu anggota memberCount = 1 true
Drive bersama yang termasuk dalam ID unit organisasi orgUnitId = 'C03az79cb' true
Drive bersama yang tidak berisi ID unit organisasi orgUnitId != 'C03az79cb' true
Drive bersama dengan nama yang tidak cocok dengan nama tertentu name != 'Archived Projects' true
Operator perbandingan (>, >=, <, <=)
Drive bersama yang dibuat setelah 1 Juni 2017 createdTime > '2017-06-01T12:00:00' true
Drive bersama yang dibuat sebelum 1 Januari 2023 createdTime < '2023-01-01T00:00:00' true
Drive bersama dengan lebih dari satu anggota memberCount > 1 true
Drive bersama dengan kurang dari 5 anggota memberCount < 5 true
Drive bersama dengan 3 penyelenggara atau kurang organizerCount <= 3 true
Operator logika (and, or, not)
Drive bersama dengan kata 'rahasia' dalam judul dan 20 anggota atau lebih name contains 'confidential' and memberCount >= 20 true
Drive bersama dengan kata 'rahasia' dalam judul di antara semua drive bersama organisasi name contains 'confidential' and orgUnitId = 'C03az79cb' true
Drive bersama dengan nama yang berisi 'Project' atau 'Archive' name contains 'Project' or name contains 'Archive' true
Drive bersama yang tidak berisi 'Draf' dalam namanya not name contains 'Draft' true
Drive bersama yang bukan milik unit organisasi target dan dibuat setelah tanggal tertentu orgUnitId != 'C03az79cb' and createdTime > '2023-01-01T00:00:00' true

Mengkueri beberapa istilah dengan tanda kurung

Anda dapat menggunakan tanda kurung untuk mengelompokkan beberapa istilah kueri. Misalnya, untuk menelusuri drive bersama yang dibuat setelah tanggal tertentu dan yang memiliki lebih dari lima pengelola atau lebih dari 20 anggota, gunakan kueri ini:

createdTime > '2019-01-01T12:00:00' and (organizerCount > 5 or memberCount > 20)

Penelusuran ini menampilkan semua drive bersama yang dibuat setelah 1 Januari 2019 dan yang memiliki lebih dari lima pengelola atau lebih dari 20 anggota.

Drive API mengevaluasi operator and dan or dari kiri ke kanan, sehingga penelusuran yang sama tanpa tanda kurung akan menampilkan:

  • Hanya drive bersama dengan lebih dari lima penyelenggara yang dibuat setelah 1 Januari 2019.
  • Semua drive bersama dengan lebih dari 20 anggota, bahkan yang dibuat sebelum 1 Januari 2019.