Créer des fichiers

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.

Voici quelques étapes supplémentaires que vous pouvez suivre: