Method: files.create

Crée un fichier.

Cette méthode accepte un URI /upload et accepte les contenus multimédias importés présentant les caractéristiques suivantes:

  • Taille maximale du fichier:5 120 Go
  • Types MIME de médias acceptés:*/*

Remarque: Spécifiez un type MIME valide plutôt que la valeur littérale */*. La valeur littérale */* sert uniquement à indiquer que tout type MIME valide peut être importé.

Pour en savoir plus sur l'importation de fichiers, consultez Importer des données de fichier.

Les applications qui créent des raccourcis avec files.create doivent spécifier le type MIME application/vnd.google-apps.shortcut.

Lorsqu'elles insèrent des fichiers avec l'API, les applications doivent spécifier une extension de fichier dans la propriété name. Par exemple, une opération d'insertion d'un fichier JPEG doit spécifier un élément du type "name": "cat.jpg" dans les métadonnées.

Les requêtes GET suivantes incluent la propriété fileExtension en lecture seule contenant l'extension initialement spécifiée dans la propriété title. Lorsqu'un utilisateur de Google Drive demande à télécharger un fichier ou que le fichier est téléchargé via le client de synchronisation, Drive crée un nom de fichier complet (avec une extension) en fonction du titre. Si l'extension est manquante, Drive tente de déterminer l'extension en fonction du type MIME du fichier.

Requête HTTP

  • URI d'importation, pour les requêtes d'importation de médias:
    POST https://www.googleapis.com/upload/drive/v3/files
  • URI de métadonnées, pour les requêtes ne contenant que des métadonnées:
    POST https://www.googleapis.com/drive/v3/files

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de requête

Paramètres
uploadType

string

Type de requête d'importation vers l'URI /upload. Si vous importez des données avec un URI /upload, ce champ est obligatoire. Si vous créez un fichier ne contenant que des métadonnées, ce champ n'est pas obligatoire. De plus, ce champ ne s'affiche pas dans le widget "Essayer cette méthode", car il n'est pas compatible avec les importations de données.

Les valeurs acceptées sont les suivantes :

  • media - Importation simple. Importez uniquement le contenu multimédia, sans métadonnées.
  • multipart : importation en plusieurs parties. Importez le contenu multimédia et ses métadonnées dans une seule requête.
  • resumable : importation avec reprise. Importez le fichier avec reprise, à l'aide d'une série d'au moins deux requêtes dont la première inclut les métadonnées.
enforceSingleParent

boolean

Obsolète. Il n'est plus possible de créer des fichiers dans plusieurs dossiers.

ignoreDefaultVisibility

boolean

Indique s'il faut ignorer les paramètres de visibilité par défaut du domaine pour le fichier créé. Les administrateurs de domaine peuvent choisir de rendre par défaut tous les fichiers importés visibles pour le domaine. Ce paramètre permet de contourner ce comportement pour la requête. Les autorisations sont toujours héritées des dossiers parents.

keepRevisionForever

boolean

Permet de spécifier si le champ "keepForever" doit être défini dans la nouvelle révision principale. Cela ne s'applique qu'aux fichiers au contenu binaire dans Google Drive. Seules 200 révisions peuvent être conservées indéfiniment. Si la limite est atteinte, essayez de supprimer les révisions épinglées.

ocrLanguage

string

Indice de langue pour le traitement OCR lors de l'importation de l'image (code ISO 639-1).

supportsAllDrives

boolean

Indique si l'application à l'origine de la demande est compatible avec Mon Drive et les Drive partagés.

supportsTeamDrives
(deprecated)

boolean

Obsolète: utilisez plutôt supportsAllDrives.

useContentAsIndexableText

boolean

Indique si le contenu importé doit être utilisé comme texte indexable.

includePermissionsForView

string

Spécifie les autorisations de vue supplémentaire à inclure dans la réponse. Seul l'état "Publié" est accepté.

includeLabels

string

Liste des ID des étiquettes à inclure dans la partie labelInfo de la réponse, séparés par une virgule.

Corps de la requête

Le corps de la requête contient une instance File.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de File.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.file

Certains champs d'application sont limités et nécessitent une évaluation de sécurité pour que votre application puisse les utiliser. Pour en savoir plus, consultez le guide relatif aux autorisations.