Method: files.update

Met à jour les métadonnées, le contenu ou les deux d'un fichier.

Lorsque vous appelez cette méthode, ne renseignez que les champs de la requête que vous souhaitez modifier. Lorsque vous mettez à jour des champs, certains peuvent être modifiés automatiquement, comme modifiedDate. Cette méthode est compatible avec la sémantique "patch".

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 : */*

    (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, consultez Types MIME compatibles avec Google Workspace et Google Drive.)

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

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
fileId

string

ID du fichier à mettre à jour.

Paramètres de requête

Paramètres
addParents

string

Liste d'ID parents à ajouter, séparés par une virgule.
convert
(deprecated)

boolean

Obsolète : ce paramètre n'a aucune fonction.
enforceSingleParent
(deprecated)

boolean

Obsolète : l'ajout de fichiers à plusieurs dossiers n'est plus possible. Utilisez shortcuts à la place.
modifiedDateBehavior

enum (ModifiedDateBehavior)

Détermine le comportement de mise à jour de modifiedDate. Cela remplace setModifiedDate.
newRevision

boolean

Indique si l'importation d'un blob doit créer une révision. Si la valeur est "false", les données blob de la révision principale actuelle sont remplacées. Si la valeur est "true" ou n'est pas définie, un blob est créé en tant que révision principale, et les révisions précédentes non épinglées sont conservées pendant une courte période. Les révisions épinglées sont stockées indéfiniment, en utilisant un quota de stockage supplémentaire, jusqu'à un maximum de 200 révisions. Pour savoir comment les révisions sont conservées, consultez le Centre d'aide Drive.
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 si la nouvelle révision doit être épinglée. Un fichier peut comporter jusqu'à 200 révisions épinglées.
removeParents

string

Liste d'ID parents à supprimer, séparés par des virgules.
setModifiedDate

boolean

Indique si la date de modification doit être définie à l'aide de la valeur fournie dans le corps de la requête. Définir ce champ sur true équivaut à modifiedDateBehavior=fromBodyOrNow, et false équivaut à modifiedDateBehavior=now. Pour empêcher toute modification de la date de modification définie sur modifiedDateBehavior=noChange.
supportsAllDrives

boolean

Indique si l'application qui effectue la demande 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é.
updateViewedDate

boolean

Indique s'il faut mettre à jour la date de la vue après la mise à jour du fichier.
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 de métadonnées uniquement. De plus, ce champ n'est pas affiché dans le widget "Essayer cette méthode", car il n'est pas compatible avec l'importation de données.

Les valeurs acceptées sont les suivantes :

  • media – Importation simple. Importer le contenu multimédia uniquement, sans métadonnées
  • 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.
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
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.scripts

Certains niveaux d'accès 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.