Ce guide vous explique comment créer et gérer des fichiers dans Google Drive.
Créer un fichier
Pour créer dans Drive un fichier sans métadonnées ni contenu, utilisez la méthode files.create
sans paramètre. Le fichier reçoit le kind
drive.file
, le id
, le name
"Untitled" et le mimeType
application/octet-stream
. uploadType
est marqué comme obligatoire, mais est défini par défaut sur media
. Vous n'avez donc pas besoin de le fournir.
Pour en savoir plus sur les limites applicables aux fichiers Drive, consultez la section Limites applicables aux fichiers et aux dossiers.
Créer des fichiers ne contenant que des métadonnées
Les fichiers contenant uniquement des métadonnées n'ont 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 et apparaissent de la même manière pour chaque utilisateur, tandis que les champs tels que viewedByMeTime
contiennent des valeurs qui lui sont propres.
Un dossier avec le type MIME application/vnd.google-apps.folder
est un exemple de fichier ne contenant que des métadonnées. Pour en savoir plus, consultez la section Créer et renseigner 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 vignettes
Les vignettes aident les utilisateurs à identifier les fichiers Drive. Drive peut générer automatiquement des vignettes pour les types de fichiers courants, ou vous pouvez fournir une vignette générée par votre application. Pour en savoir plus, consultez Importer des vignettes.
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 champs d'application Drive, consultez Choisir les champs d'application des API Google Drive.
Limites et considérations
Lorsque vous vous préparez à copier des fichiers, tenez compte des limites et considérations suivantes:
Autorisations :
- La restriction de fichier
copyRequiresWriterPermission
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. - Le champ
capabilities/canCopy
d'une ressourcefiles
détermine si l'utilisateur peut copier un fichier. Pour en savoir plus, consultez la section Fonctionnalités. - 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.
- La propriété d'un fichier copié peut changer, et la copie peut ne pas hériter des paramètres de partage du fichier d'origine. Vous devrez peut-être réinitialiser ces paramètres.
- La restriction de fichier
Gestion des fichiers:
- Certains fichiers, tels que 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 des parents visibles du fichier source. - Même si un dossier est un type de fichier, vous ne pouvez pas copier un dossier.
À la place, créez un dossier de destination et définissez le champ
parents
des fichiers existants sur le dossier de destination. Vous pouvez ensuite supprimer le dossier source d'origine. - Sauf si un nouveau nom de fichier est spécifié, la méthode
files.copy
génère un fichier portant le même nom que l'original. - Une utilisation excessive de
files.copy
peut entraîner le dépassement des limites de quota de l'API Drive. Pour en savoir plus, consultez Limites d'utilisation.
Articles associés
Voici quelques étapes supplémentaires que vous pouvez suivre:
Pour importer des données de fichier lorsque vous créez ou mettez à jour un fichier, consultez Importer des données de fichier.
Pour créer un fichier dans un dossier spécifique, consultez la section Créer un fichier dans un dossier spécifique.
Pour utiliser les métadonnées de fichiers, consultez Gérer les métadonnées de fichiers.
Pour supprimer un fichier, consultez la section Supprimer des fichiers et des dossiers dans la corbeille ou les supprimer.