Method: files.update

Met à jour les métadonnées et/ou le contenu d'un fichier. Lorsque vous appelez cette méthode, renseignez uniquement les champs de la requête que vous souhaitez modifier. Lors de la mise à jour de 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 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.

Requête HTTP

  • URI d'importation, pour les requêtes d'importation de médias:
    PUT https://www.googleapis.com/upload/drive/v2/files/{fileId}
  • URI de métadonnées, pour les requêtes ne contenant que des métadonnées:
    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
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.
fileId

string

ID du fichier à mettre à jour.

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.
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: il n'est plus possible d'ajouter des fichiers à plusieurs dossiers. Utilisez shortcuts à la place.
modifiedDateBehavior

enum (ModifiedDateBehavior)

Détermine le comportement dans lequel modifiedDate est mis à jour. Cette valeur remplace setModifiedDate.
newRevision

boolean

Indique si une importation d'objet 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 objet 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 (jusqu'à 200 révisions) en utilisant un quota de stockage supplémentaire. Pour en savoir plus sur la conservation des révisions, consultez le Centre d'aide Drive.
ocr

boolean

Indique si la reconnaissance optique des caractères est utilisée pour les importations de fichiers .jpg, .png, .gif ou .pdf.
ocrLanguage

string

Si l'argument "ocr" est défini sur "true", indique la langue à utiliser. Les valeurs valides sont les codes BCP 47.
pinned

boolean

Indique s'il faut épingler la nouvelle révision. Un fichier ne peut pas comporter plus de 200 révisions épinglées.
removeParents

string

Liste d'ID parents à supprimer séparés par une virgule.
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éfinissez modifiedDateBehavior=noChange.
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.
timedTextLanguage

string

Langue du texte chronométré.
timedTextTrackName

string

Nom de la piste de texte chronométré.
updateViewedDate

boolean

Indique s'il faut mettre à jour la date de consultation après avoir mis à jour le fichier.
useContentAsIndexableText

boolean

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

string

Spécifie les autorisations de vue supplémentaire à inclure dans la réponse. Seule la fonctionnalité published est prise en charge.
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/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 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.