Ce guide 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ètres. Le fichier reçoit un kind
de drive.file
, un id
, un name
de
"Sans titre" et mimeType
de application/octet-stream
. uploadType
est
marqué comme obligatoire, mais défini par défaut sur media
. Vous n'avez donc pas à fournir
Pour en savoir plus sur les limites applicables aux fichiers dans Drive, consultez l'article Fichiers et les limites de dossiers.
Créer des fichiers de métadonnées uniquement
Les fichiers contenant uniquement des métadonnées n'ont aucun contenu. Les métadonnées sont des données (name
,
mimeType
et createdTime
) qui décrit le fichier. Les champs tels que name
sont
sont indépendantes de l'utilisateur et s'affichent de la même manière, tandis que les champs tels que
viewedByMeTime
contiennent des valeurs spécifiques à l'utilisateur.
Un exemple de fichier ne contenant que des métadonnées est un dossier avec le type MIME
application/vnd.google-apps.folder
Pour en savoir plus, consultez la section Créer et
créer des dossiers. Autre exemple : un raccourci
pointe vers un autre fichier de type MIME dans Drive
application/vnd.google-apps.shortcut
Pour en savoir plus, consultez la section Créer un
un raccourci vers un fichier Drive.
Gérer les miniatures
Les miniatures aident les utilisateurs à identifier les fichiers Drive. En voiture vous pouvez générer automatiquement des vignettes pour les types de fichiers courants ou fournir une miniature générée par votre application. Pour en savoir plus, consultez la section Importer miniatures.
Copier un fichier existant
Pour copier un fichier et appliquer les mises à jour demandées, utilisez le
files.copy
. Pour trouver les fileId
à
utilisez la méthode files.list
.
Notez que vous devez utiliser une API Drive appropriée d'application pour autoriser . Pour en savoir plus sur les habilitations Drive, consultez l'article Choisir 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 copiez le fichier. Pour en savoir plus, consultez la section Empêcher les utilisateurs de le téléchargement, l'impression ou la copie fichier. - Le champ
capabilities/canCopy
d'une La ressourcefiles
détermine si l’utilisateur peut copier un fichier. Pour en savoir plus, consultez Fonctionnalités. - L'utilisateur qui a créé la copie est propriétaire du fichier copié. Aucun autre partage les paramètres du fichier source sont répliqués. Si la copie est créée un dossier partagé, il hérite des autorisations de ce dossier.
- La propriété d'un fichier copié peut changer et la copie peut ne pas hériter les paramètres de partage du fichier d'origine. Ces paramètres devront peut-être être réinitialisés.
- La restriction de fichier
Gestion de fichiers:
- Certains fichiers, comme les fichiers tiers raccourcis, ne peuvent jamais être copié.
- Vous ne pouvez copier un fichier que dans un seul dossier parent. Spécifier plusieurs
parents n'est pas pris en charge. Si le champ
parents
n'est pas spécifié, 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
du les fichiers existants dans le dossier de destination. Vous pouvez ensuite supprimer dossier source d'origine. - À moins qu'un nouveau nom de fichier ne soit spécifié, la méthode
files.copy
génère une fichier portant le même nom que l'original. - Une utilisation excessive de
files.copy
peut entraîner le dépassement Limites de quota de l'API Drive Pour en savoir plus, consultez la section Utilisation limites.
Articles associés
Voici quelques solutions que vous pouvez essayer de suivre:
Pour importer des données d'un fichier lorsque vous créez ou mettez à jour un fichier, voir Importer un fichier données.
Pour créer un fichier dans un dossier spécifique, consultez la section Créer un fichier dans un dossier.
Pour utiliser les métadonnées de fichiers, consultez la section Gérer un fichier métadonnées.
Pour supprimer un fichier, consultez l'article Placer ou supprimer des fichiers dans la corbeille et dossiers.