Pour créer 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
. Le champ 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.
Importer des vignettes
Drive génère automatiquement des vignettes pour de nombreux types de fichiers courants, tels que Google Docs, Sheets et Slides. Les vignettes aident l'utilisateur à mieux identifier les fichiers Drive.
Pour les types de fichiers pour lesquels Drive ne peut pas générer de vignette standard, vous pouvez fournir une vignette générée par votre application. Lors de la création ou de la mise à jour du fichier, importez une vignette en définissant le champ contentHints.thumbnail
sur la ressource files
.
Notamment :
- Définissez le champ
contentHints.thumbnail.image
sur l'image encodée en base64 sécurisée pour l'URL et le nom de fichier (consultez la section 5 du document RFC 4648). - Définissez le champ
contentHints.thumbnail.mimeType
sur le type MIME approprié pour la vignette.
Si Drive peut générer une vignette à partir du fichier, il utilise celle générée automatiquement et ignore toutes les vignettes que vous avez peut-être importées. S'il ne peut pas générer de vignette, il utilise celle que vous fournissez.
Les miniatures doivent respecter les règles suivantes:
- Elles peuvent être importées aux formats PNG, GIF ou JPG.
- La largeur recommandée est de 1 600 pixels.
- La largeur minimale est de 220 pixels.
- La taille maximale des fichiers est de 2 Mo.
- Elles doivent être mises à jour par votre application à chaque enregistrement.
Pour en savoir plus, consultez la ressource files
.
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.