Method: files.insert

Insère un nouveau fichier.

Cette méthode accepte un URI /upload et les éléments 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 */*. Le littéral */* n'est utilisé que pour indiquer que tout type MIME valide peut être importé.

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

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

Les applications doivent spécifier une extension de fichier dans la propriété title lorsqu'elles insèrent des fichiers avec l'API. Par exemple, une opération d'insertion d'un fichier JPEG doit spécifier quelque chose comme "title": "cat.jpg" dans les métadonnées.

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

Requête HTTP

  • URI d'importation pour les demandes d'importation de contenus multimédias :
    POST https://www.googleapis.com/upload/drive/v2/files
  • URI des métadonnées pour les requêtes de métadonnées uniquement :
    POST https://www.googleapis.com/drive/v2/files

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de requête

Paramètres
convert

boolean

Indique si ce fichier doit être converti au format des éditeurs Docs correspondant.
enforceSingleParent
(deprecated)

boolean

Obsolète : la création de fichiers dans plusieurs dossiers n'est plus prise en charge.
ocr

boolean

Indique si la reconnaissance optique des caractères doit être tentée pour les importations au format .jpg, .png, .gif ou .pdf.
ocrLanguage

string

Si la valeur est "true", indique la langue à utiliser. Les valeurs valides sont des codes BCP 47.
pinned

boolean

Indique s'il faut épingler la révision principale du fichier importé. Un fichier peut comporter jusqu'à 200 révisions épinglées.
supportsAllDrives

boolean

Indique si l'application à l'origine de la requête est compatible avec Mon Drive et les Drive partagés.
supportsTeamDrives
(deprecated)

boolean

Obsolète : utilisez plutôt supportsAllDrives.
timedTextLanguage

string

Langue du texte synchronisé.
timedTextTrackName

string

Nom de la piste de texte synchronisé.
uploadType

string

Type de requête d'importation à l'URI /upload. Ce champ est obligatoire si vous importez des données avec un URI /upload. Ce champ n'est pas obligatoire si vous créez un fichier contenant uniquement des métadonnées. De plus, ce champ ne s'affiche pas dans le widget "Essayer cette méthode", car celui-ci n'accepte pas l'importation de données.

Les valeurs acceptées sont les suivantes :

  • media – Importation simple. Importer le contenu multimédia uniquement, sans aucune métadonnée
  • multipart – Importation en plusieurs parties. Importez le contenu multimédia et ses métadonnées en une seule requête.
  • resumable : importation avec reprise. Importez le fichier de manière résumable, à l'aide d'une série d'au moins deux requêtes, la première incluant les métadonnées.
useContentAsIndexableText

boolean

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

enum (Visibility)

Visibilité du nouveau fichier. Les autorisations sont toujours héritées des dossiers parents. Ce paramètre n'est pertinent que lorsque convert=false.
includePermissionsForView

string

Spécifie les autorisations de vues supplémentaires à inclure dans la réponse. Seule l'option published est acceptée.
includeLabels

string

Liste d'ID de libellés séparés par une virgule, à inclure dans la partie labelInfo de la réponse.

Corps de la requête

Le corps de la requête contient une instance de 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/docs
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.apps.readonly
  • https://www.googleapis.com/auth/drive.file

Certains sont soumis à des restrictions et nécessitent une évaluation de sécurité pour que votre application puisse les utiliser. Pour en savoir plus, consultez le guide d'autorisation.