Menelusuri file dan folder

Panduan ini menjelaskan cara Google Drive API mendukung beberapa cara untuk menelusuri file dan folder.

Anda dapat menggunakan metode list pada resource files untuk menampilkan semua atau sebagian file dan folder pengguna Drive. Metode list juga dapat digunakan untuk mengambil fileId yang diperlukan untuk beberapa metode resource (seperti metode get dan metode update).

Menggunakan parameter kolom

Jika ingin menentukan kolom yang akan ditampilkan dalam respons, Anda dapat menyetel parameter sistem fields dengan metode apa pun dari resource files. Jika Anda menghapus parameter fields, server akan menampilkan kumpulan kolom default yang khusus untuk metode tersebut. Misalnya, metode list hanya menampilkan kolom kind, id, name, mimeType, dan resourceKey untuk setiap file. Untuk menampilkan kolom yang berbeda, lihat Menampilkan kolom tertentu.

Mendapatkan file

Untuk mendapatkan file, gunakan metode get pada resource files dengan parameter jalur fileId. Jika Anda tidak mengetahui ID file, Anda dapat mencantumkan semua file menggunakan metode list.

Metode ini menampilkan file sebagai instance resource files. Jika Anda memberikan parameter kueri alt=media, respons akan menyertakan konten file dalam isi respons. Untuk mendownload atau mengekspor file, lihat Mendownload dan mengekspor file.

Untuk mengonfirmasi risiko mendownload malware yang diketahui atau file berbahaya lainnya, tetapkan parameter kueri acknowledgeAbuse ke true. Kolom ini hanya berlaku jika parameter alt=media ditetapkan dan pengguna adalah pemilik file atau penyelenggara drive bersama tempat file berada.

Menelusuri semua file dan folder di Drive Saya milik pengguna saat ini

Gunakan metode list tanpa parameter apa pun untuk menampilkan semua file dan folder.

GET https://www.googleapis.com/drive/v3/files

Menelusuri file atau folder tertentu di Drive Saya milik pengguna saat ini

Untuk menelusuri sekumpulan file atau folder tertentu, gunakan kolom string kueri q dengan metode list untuk memfilter file yang akan ditampilkan dengan menggabungkan satu atau beberapa istilah penelusuran.

Sintaksis 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 folder dengan menyetel jenis MIME:

q: mimeType = 'application/vnd.google-apps.folder'

Untuk melihat semua istilah kueri file, lihat Istilah kueri khusus file.

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. 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 ingin Anda kueri Contoh
File dengan nama "hello" name = 'hello'
File dengan nama yang berisi kata "hello" dan "goodbye" name contains 'hello' and name contains 'goodbye'
File dengan nama yang tidak berisi kata "hello" not name contains 'hello'
File yang berisi teks "penting" dan berada di sampah fullText contains 'important' and trashed = true
File yang berisi kata "hello" fullText contains 'hello'
File yang tidak memiliki kata "hello" not fullText contains 'hello'
File yang berisi frasa "hello world" yang sama persis fullText contains '"hello world"'
File dengan kueri yang berisi karakter "\" (misalnya, "\authors") fullText contains '\\authors'
File yang berupa folder mimeType = 'application/vnd.google-apps.folder'
File yang bukan folder mimeType != 'application/vnd.google-apps.folder'
File yang diubah setelah tanggal tertentu (zona waktu default adalah UTC) modifiedTime > '2012-06-04T12:00:00'
File gambar atau video yang diubah setelah tanggal tertentu modifiedTime > '2012-06-04T12:00:00' and (mimeType contains 'image/' or mimeType contains 'video/')
File yang diberi bintang starred = true
File dalam koleksi (misalnya, ID folder dalam koleksi parents) '1234567' in parents
File dalam folder data aplikasi dalam koleksi 'appDataFolder' in parents
File yang pemiliknya adalah pengguna "test@example.org" 'test@example.org' in owners
File yang izin tulisnya dimiliki oleh pengguna "test@example.org" 'test@example.org' in writers
File yang memiliki izin tulis untuk anggota grup "group@example.org" 'group@example.org' in writers
File yang dibagikan kepada pengguna yang berwenang dengan "hello" dalam namanya sharedWithMe and name contains 'hello'
File dengan properti file kustom yang terlihat oleh semua aplikasi properties has { key='mass' and value='1.3kg' }
File dengan properti file kustom yang bersifat pribadi untuk aplikasi yang meminta appProperties has { key='additionalID' and value='8e8aceg2af2ge72e78' }
File yang belum dibagikan kepada siapa pun atau domain (hanya pribadi, atau dibagikan kepada pengguna atau grup tertentu) visibility = 'limited'

Memfilter hasil penelusuran dengan library klien

Contoh kode berikut menunjukkan cara menggunakan library klien untuk memfilter hasil penelusuran ke nama dan ID file JPEG. Contoh ini menggunakan istilah kueri mimeType untuk mempersempit hasil ke file berjenis image/jpeg. Tindakan ini juga menetapkan spaces ke drive untuk lebih mempersempit penelusuran ke ruang Drive. Jika nextPageToken menampilkan null, tidak ada lagi hasil.

Java

drive/snippets/drive_v3/src/main/java/SearchFile.java
import com.google.api.client.http.HttpRequestInitializer;
import com.google.api.client.http.javanet.NetHttpTransport;
import com.google.api.client.json.gson.GsonFactory;
import com.google.api.services.drive.Drive;
import com.google.api.services.drive.DriveScopes;
import com.google.api.services.drive.model.File;
import com.google.api.services.drive.model.FileList;
import com.google.auth.http.HttpCredentialsAdapter;
import com.google.auth.oauth2.GoogleCredentials;
import java.io.IOException;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.List;

/* Class to demonstrate use-case of search files. */
public class SearchFile {

  /**
   * Search for specific set of files.
   *
   * @return search result list.
   * @throws IOException if service account credentials file not found.
   */
  public static List<File> searchFile() throws IOException {
           /*Load pre-authorized user credentials from the environment.
           TODO(developer) - See https://developers.google.com/identity for
           guides on implementing OAuth2 for your application.*/
    GoogleCredentials credentials = GoogleCredentials.getApplicationDefault()
        .createScoped(Arrays.asList(DriveScopes.DRIVE_FILE));
    HttpRequestInitializer requestInitializer = new HttpCredentialsAdapter(
        credentials);

    // Build a new authorized API client service.
    Drive service = new Drive.Builder(new NetHttpTransport(),
        GsonFactory.getDefaultInstance(),
        requestInitializer)
        .setApplicationName("Drive samples")
        .build();

    List<File> files = new ArrayList<File>();

    String pageToken = null;
    do {
      FileList result = service.files().list()
          .setQ("mimeType='image/jpeg'")
          .setSpaces("drive")
          .setFields("nextPageToken, items(id, title)")
          .setPageToken(pageToken)
          .execute();
      for (File file : result.getFiles()) {
        System.out.printf("Found file: %s (%s)\n",
            file.getName(), file.getId());
      }

      files.addAll(result.getFiles());

      pageToken = result.getNextPageToken();
    } while (pageToken != null);

    return files;
  }
}

Python

drive/snippets/drive-v3/file_snippet/search_file.py
import google.auth
from googleapiclient.discovery import build
from googleapiclient.errors import HttpError


def search_file():
  """Search file in drive location

  Load pre-authorized user credentials from the environment.
  TODO(developer) - See https://developers.google.com/identity
  for guides on implementing OAuth2 for the application.
  """
  creds, _ = google.auth.default()

  try:
    # create drive api client
    service = build("drive", "v3", credentials=creds)
    files = []
    page_token = None
    while True:
      # pylint: disable=maybe-no-member
      response = (
          service.files()
          .list(
              q="mimeType='image/jpeg'",
              spaces="drive",
              fields="nextPageToken, files(id, name)",
              pageToken=page_token,
          )
          .execute()
      )
      for file in response.get("files", []):
        # Process change
        print(f'Found file: {file.get("name")}, {file.get("id")}')
      files.extend(response.get("files", []))
      page_token = response.get("nextPageToken", None)
      if page_token is None:
        break

  except HttpError as error:
    print(f"An error occurred: {error}")
    files = None

  return files


if __name__ == "__main__":
  search_file()

Node.js

drive/snippets/drive_v3/file_snippets/search_file.js
/**
 * Search file in drive location
 * @return{obj} data file
 * */
async function searchFile() {
  const {GoogleAuth} = require('google-auth-library');
  const {google} = require('googleapis');

  // Get credentials and build service
  // TODO (developer) - Use appropriate auth mechanism for your app
  const auth = new GoogleAuth({
    scopes: 'https://www.googleapis.com/auth/drive',
  });
  const service = google.drive({version: 'v3', auth});
  const files = [];
  try {
    const res = await service.files.list({
      q: 'mimeType=\'image/jpeg\'',
      fields: 'nextPageToken, files(id, name)',
      spaces: 'drive',
    });
    Array.prototype.push.apply(files, res.files);
    res.data.files.forEach(function(file) {
      console.log('Found file:', file.name, file.id);
    });
    return res.data.files;
  } catch (err) {
    // TODO(developer) - Handle error
    throw err;
  }
}

PHP

drive/snippets/drive_v3/src/DriveSearchFiles.php
<?php
use Google\Client;
use Google\Service\Drive;
function searchFiles()
{
    try {
        $client = new Client();
        $client->useApplicationDefaultCredentials();
        $client->addScope(Drive::DRIVE);
        $driveService = new Drive($client);
        $files = array();
        $pageToken = null;
        do {
            $response = $driveService->files->listFiles(array(
                'q' => "mimeType='image/jpeg'",
                'spaces' => 'drive',
                'pageToken' => $pageToken,
                'fields' => 'nextPageToken, files(id, name)',
            ));
            foreach ($response->files as $file) {
                printf("Found file: %s (%s)\n", $file->name, $file->id);
            }
            array_push($files, $response->files);

            $pageToken = $response->pageToken;
        } while ($pageToken != null);
        return $files;
    } catch(Exception $e) {
       echo "Error Message: ".$e;
    }
}

Menelusuri file dengan properti file kustom

Untuk menelusuri file dengan properti file kustom, gunakan istilah kueri penelusuran properties atau appProperties dengan kunci dan nilai. Misalnya, untuk menelusuri properti file kustom yang bersifat pribadi untuk aplikasi yang meminta bernama additionalID dengan nilai 8e8aceg2af2ge72e78:

appProperties has { key='additionalID' and value='8e8aceg2af2ge72e78' }

Untuk mengetahui informasi selengkapnya, lihat Menambahkan properti file kustom.

Menelusuri file dengan nilai kolom atau label tertentu

Untuk menelusuri file dengan label tertentu, gunakan istilah kueri penelusuran labels dengan ID label tertentu. Contoh: 'labels/LABEL_ID' in labels. Jika berhasil, isi respons akan berisi semua instance file tempat label diterapkan.

Untuk menelusuri file tanpa ID label tertentu: Not 'labels/LABEL_ID' in labels.

Anda juga dapat menelusuri file berdasarkan nilai kolom tertentu. Misalnya, untuk menelusuri file dengan nilai teks: labels/LABEL_ID.text_field_id ='TEXT'.

Untuk mengetahui informasi selengkapnya, lihat Menelusuri file dengan nilai kolom atau label tertentu.

Menelusuri set data

Penelusuran yang memanggil metode list menggunakan corpora dari user secara default. Untuk menelusuri korpus lain, seperti file yang dibagikan dengan domain, tetapkan parameter corpora.

Beberapa korpora dapat ditelusuri dalam satu kueri, meskipun hasil yang tidak lengkap dapat ditampilkan jika korpora gabungan terlalu besar. Jika incompleteSearch adalah true dalam isi respons, berarti tidak semua dokumen ditampilkan. Jika hal ini terjadi, Anda harus mempersempit kueri dengan memilih korpora lain seperti user atau drive.