Rechercher des fichiers et des dossiers

Ce guide explique comment l'API Google Drive permet de rechercher des fichiers et des dossiers de plusieurs façons.

Vous pouvez utiliser la méthode list sur la ressource files pour renvoyer tout ou partie des fichiers et dossiers d'un utilisateur Drive. La méthode list peut également être utilisée pour récupérer le fileId requis pour certaines méthodes de ressources (telles que les méthodes get et update).

Utiliser le paramètre "fields"

Si vous souhaitez spécifier les champs à renvoyer dans la réponse, vous pouvez définir le paramètre système fields avec n'importe quelle méthode de la ressource files. Si vous omettez le paramètre fields, le serveur renvoie un ensemble de champs par défaut spécifiques à la méthode. Par exemple, la méthode list ne renvoie que les champs kind, id, name, mimeType et resourceKey pour chaque fichier. Pour renvoyer différents champs, consultez Renvoyer des champs spécifiques.

Obtenir un fichier

Pour obtenir un fichier, utilisez la méthode get sur la ressource files avec le paramètre de chemin d'accès fileId. Si vous ne connaissez pas l'ID du fichier, vous pouvez lister tous les fichiers à l'aide de la méthode list.

La méthode renvoie le fichier sous la forme d'une instance de ressource files. Si vous fournissez le paramètre de requête alt=media, la réponse inclut le contenu du fichier dans le corps de la réponse. Pour télécharger ou exporter le fichier, consultez Télécharger et exporter des fichiers.

Pour reconnaître le risque de télécharger des logiciels malveillants connus ou d'autres fichiers abusifs, définissez le paramètre de requête acknowledgeAbuse sur true. Ce champ ne s'applique que lorsque le paramètre alt=media est défini et que l'utilisateur est le propriétaire du fichier ou un organisateur du Drive partagé dans lequel se trouve le fichier.

Rechercher tous les fichiers et dossiers dans le Drive de l'utilisateur actuel

Utilisez la méthode list sans aucun paramètre pour renvoyer tous les fichiers et dossiers.

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

Rechercher des fichiers ou des dossiers spécifiques dans le dossier "Mon Drive" de l'utilisateur actuel

Pour rechercher un ensemble spécifique de fichiers ou de dossiers, utilisez le champ de chaîne de requête q avec la méthode list pour filtrer les fichiers à renvoyer en combinant un ou plusieurs termes de recherche.

La syntaxe de la chaîne de requête contient les trois parties suivantes :

query_term operator values

Où :

• query_term correspond au terme ou au champ de requête sur lequel effectuer la recherche.

• operator spécifie la condition pour le terme de requête.

• values correspond aux valeurs spécifiques que vous souhaitez utiliser pour filtrer les résultats de recherche.

Par exemple, la chaîne de requête suivante filtre la recherche pour ne renvoyer que les dossiers en définissant le type MIME :

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

Pour afficher tous les termes de requête de fichier, consultez Termes de requête spécifiques aux fichiers.

Pour afficher tous les opérateurs de requête que vous pouvez utiliser pour créer une requête, consultez Opérateurs de requête.

Exemples de chaînes de requête

Le tableau suivant présente des exemples de chaînes de requête de base. Le code réel diffère selon la bibliothèque cliente que vous utilisez pour votre recherche.

Vous devez également échapper les caractères spéciaux dans les noms de fichiers pour vous assurer que la requête fonctionne correctement. Par exemple, si un nom de fichier contient à la fois une apostrophe (') et une barre oblique inverse ("\"), utilisez une barre oblique inverse pour les échapper : name contains 'quinn\'s paper\\essay'.

Filtrer les résultats de recherche avec une bibliothèque cliente

L'exemple de code suivant montre comment utiliser une bibliothèque cliente pour filtrer les résultats de recherche sur les noms et les ID de fichiers JPEG. Cet exemple utilise le terme de requête mimeType pour limiter les résultats aux fichiers de type image/jpeg. Il définit également spaces sur drive pour affiner davantage la recherche à l'espace Drive. Lorsque nextPageToken renvoie null, cela signifie qu'il n'y a plus de résultats.

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;
  }
}

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()

/**
 * 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
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;
    }
}

Rechercher des fichiers avec une propriété de fichier personnalisée

Pour rechercher des fichiers avec une propriété de fichier personnalisée, utilisez le terme de requête de recherche properties ou appProperties avec une clé et une valeur. Par exemple, pour rechercher une propriété de fichier personnalisée privée à l'application qui envoie la requête, appelée additionalID avec une valeur de 8e8aceg2af2ge72e78 :

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

Pour en savoir plus, consultez Ajouter des propriétés de fichier personnalisées.

Rechercher des fichiers avec un libellé ou une valeur de champ spécifiques

Pour rechercher des fichiers avec des libellés spécifiques, utilisez le terme de requête labels avec un ID de libellé spécifique. Exemple : 'labels/LABEL_ID' in labels. Si la requête aboutit, le corps de la réponse contient toutes les instances de fichier auxquelles le libellé est appliqué.

Pour rechercher des fichiers sans ID de libellé spécifique : Not 'labels/LABEL_ID' in labels.

Vous pouvez également rechercher des fichiers en fonction de valeurs de champ spécifiques. Par exemple, pour rechercher des fichiers avec une valeur de texte : labels/LABEL_ID.text_field_id ='TEXT'.

Pour en savoir plus, consultez Rechercher des fichiers avec un libellé ou une valeur de champ spécifiques.

Rechercher dans les corpus

Les recherches qui appellent la méthode list utilisent le corpora de user par défaut. Pour rechercher d'autres corpus, tels que les fichiers partagés avec un domain, définissez le paramètre corpora.

Vous pouvez effectuer des recherches dans plusieurs corpus en une seule requête. Toutefois, des résultats incomplets peuvent être renvoyés si les corpus combinés sont trop volumineux. Si la valeur incompleteSearch est définie sur true dans le corps de la réponse, cela signifie que tous les documents n'ont pas été renvoyés. Si cela se produit, vous devez affiner votre requête en choisissant un autre corpus, tel que user ou drive.

Articles associés

• Rechercher des Drive partagés
• Termes et opérateurs de requête de recherche
• Types MIME compatibles avec Google Workspace et Google Drive
• Rôles et autorisations
• Rechercher des fichiers avec un libellé ou une valeur de champ spécifique