Créer et gérer des fichiers

Ce guide explique comment créer et gérer des fichiers dans Google Drive à l'aide de l'API Google Drive.

Créer un fichier

Pour créer un fichier dans Drive qui ne contient aucune métadonnée ni aucun contenu, utilisez la méthode files.create sans aucun paramètre. Le fichier reçoit un kind de drive.file, un id, un name "Sans titre" et un mimeType de application/octet-stream. Le uploadType est marqué comme obligatoire, mais sa valeur par défaut est media. Vous n'avez donc pas besoin de le fournir.

Pour en savoir plus sur les limites applicables aux fichiers Drive, consultez Limites applicables aux fichiers et aux dossiers.

Créer des fichiers de métadonnées uniquement

Les fichiers contenant uniquement des métadonnées ne contiennent aucun contenu. Les métadonnées sont des données (telles que name, mimeType et createdTime) qui décrivent le fichier. Les champs tels que name sont indépendants de l'utilisateur et s'affichent de la même manière pour chaque utilisateur, tandis que les champs tels que viewedByMeTime contiennent des valeurs spécifiques à l'utilisateur.

Un exemple de fichier contenant uniquement des métadonnées est un dossier avec le type MIME application/vnd.google-apps.folder. Pour en savoir plus, consultez Créer et remplir des dossiers. Un autre exemple est un raccourci qui pointe vers un autre fichier sur Drive avec le type MIME application/vnd.google-apps.shortcut. Pour en savoir plus, consultez Créer un raccourci vers un fichier Drive.

Gérer les miniatures

Les miniatures aident les utilisateurs à identifier les fichiers Drive. Drive peut générer automatiquement des miniatures pour les types de fichiers courants, ou vous pouvez fournir une image de miniature générée par votre application. Pour en savoir plus, consultez Importer des miniatures.

Copier un fichier existant

Pour copier un fichier et appliquer les mises à jour demandées, utilisez la méthode files.copy. Pour trouver le fileId à copier, utilisez la méthode files.list.

Notez que vous devez utiliser un champ d'application de l'API Drive approprié pour autoriser l'appel. Pour en savoir plus sur les habilitations de Drive, consultez Choisir les habilitations de l'API Google Drive.

Limites et points à prendre en compte

Lorsque vous vous préparez à copier des fichiers, tenez compte des limites et des points suivants :

  • Autorisations :

    • L'objet DownloadRestrictionsMetadata de la ressource files détermine qui peut copier le fichier. Pour en savoir plus, consultez Empêcher les utilisateurs de télécharger, d'imprimer ou de copier votre fichier.
    • La ressource de champ capabilities.canCopy détermine si l'utilisateur peut copier un fichier. Pour en savoir plus, consultez Comprendre les fonctionnalités des fichiers.
    • L'utilisateur qui a créé la copie est propriétaire du fichier copié. Aucun autre paramètre de partage du fichier source n'est répliqué. Si la copie est créée dans un dossier partagé, elle hérite des autorisations de ce dossier.
    • Le propriétaire d'un fichier copié peut changer, et la copie peut ne pas hériter des paramètres de partage du fichier d'origine. Il faudra peut-être réinitialiser ces paramètres.

  • Gestion des fichiers :

    • Certains fichiers, comme les raccourcis tiers, ne peuvent jamais être copiés.
    • Vous ne pouvez copier un fichier que dans un seul dossier parent. Il n'est pas possible de spécifier plusieurs parents. Si le champ parents n'est pas spécifié, le fichier hérite de tous les parents détectables à partir du fichier source.
    • Même si un dossier est un type de fichier, vous ne pouvez pas le copier. À la place, créez un dossier de destination et définissez le champ parents des fichiers existants sur ce dossier. Vous pouvez ensuite supprimer le dossier source d'origine.
    • Sauf si un nouveau nom de fichier est spécifié, la méthode files.copy produit un fichier portant le même nom que le fichier d'origine.
    • Une utilisation excessive de files.copy peut entraîner le dépassement des limites de votre quota d'API Drive. Pour en savoir plus, consultez Limites d'utilisation.

Voici quelques étapes que vous pouvez également suivre :