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 ni métadonnées ni contenu, utilisez la méthode create sur la ressource files sans aucun paramètre.

Lorsque vous créez le fichier, la méthode renvoie une ressource files. Le fichier reçoit un kind de drive.file, un id, un name "Sans titre" et un mimeType de application/octet-stream. uploadType est marqué comme obligatoire, mais la valeur par défaut est media. Vous n'avez donc pas besoin de le fournir.

Pour en savoir plus sur les limites de fichiers dans Drive, consultez Limites de fichiers et de dossiers.

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.

Générer des ID à utiliser avec vos fichiers

La méthode generateIds sur la ressource files vous permet de pré-générer des ID de fichier uniques qui peuvent être utilisés lors de la création ou de la copie de fichiers et de dossiers dans Drive. Cela peut être utile lorsque vous devez contrôler les ID de fichier depuis votre application, plutôt que de laisser Drive les attribuer automatiquement.

Vous pouvez définir le nombre d'ID générés à l'aide du paramètre de requête count. Si count n'est pas défini, 10 éléments sont renvoyés par défaut. Le nombre maximal d'ID que vous pouvez demander est limité à 1 000.

Vous pouvez également désigner le space dans lequel les ID peuvent être utilisés et le type des éléments pour lesquels les ID peuvent être utilisés.

Une fois l'ID généré, il peut être transmis à la méthode create ou copy via le champ id. Cela garantit que le fichier créé ou copié utilise l'ID prédéterminé.

Si le fichier est créé ou copié, les nouvelles tentatives renvoient un code d'état HTTP 409 Conflict et aucun fichier en double n'est créé.

Notez que les ID pré-générés ne sont pas acceptés pour la création de fichiers Google Workspace, à l'exception des types MIME application/vnd.google-apps.drive-sdk et application/vnd.google-apps.folder. De même, les importations faisant référence à une conversion au format de fichier Google Workspace ne sont pas acceptées.

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 copy sur la ressource files. Pour trouver le fileId à copier, utilisez la méthode list.

Vous pouvez appliquer des mises à jour à l'aide de la sémantique des correctifs, ce qui signifie que vous pouvez apporter des modifications partielles à une ressource. Vous devez définir explicitement les champs que vous souhaitez modifier dans votre requête. Tous les champs non inclus dans la requête conservent leurs valeurs existantes. Pour en savoir plus, consultez Utiliser des ressources partielles.

Vous pouvez prédéfinir l'ID du fichier copié à l'aide de la méthode generateIds. Pour en savoir plus, consultez Générer des ID à utiliser avec vos fichiers.

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 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 :

  • 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 copy produit un fichier portant le même nom que le fichier d'origine.
    • Une utilisation excessive de copy peut entraîner le dépassement des limites de quota de l'API Drive. Pour en savoir plus, consultez Limites d'utilisation.

Voici quelques étapes que vous pouvez également suivre :