Method: files.patch

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 voulez modifier. Lorsque vous mettez à jour des champs, certains d'entre eux peuvent changer automatiquement (par exemple, modifiéDate). Cette méthode est compatible avec la sémantique "patch".

Requête HTTP :

PATCH 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

Identifiant 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: il n'est plus possible d'ajouter des fichiers à plusieurs dossiers. 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 définie sur "false", les données blob de la révision principale actuelle sont remplacées. Si la valeur est définie sur "true" ou si elle n'est pas configurée, un nouveau blob est créé en tant que révision principale, et les anciennes révisions 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, dans la limite de 200 révisions. Pour en savoir plus sur la conservation des révisions, consultez le Centre d'aide Drive. Notez que ce champ est ignoré si la requête ne contient pas de charge utile.
ocr

boolean

Indique si la tentative de reconnaissance optique des caractères est activée sur les importations au format .jpg, .png, .gif ou .pdf.
ocrLanguage

string

Si la valeur "ocr" est "true", des indications sur le langage à utiliser sont appliquées. Les valeurs valides sont les codes BCP 47.
pinned

boolean

Permet d'épingler ou non la nouvelle révision. Un fichier peut contenir jusqu'à 200 révisions épinglées. Notez que ce champ est ignoré si la requête ne contient pas de charge utile.
removeParents

string

Liste des ID parents à supprimer, séparés par une virgule.
setModifiedDate

boolean

Permet de définir la date de modification en fonction de la valeur fournie dans le corps de la requête. Définir ce champ sur true équivaut à modifiedDateBehavior=fromBodyOrNow et false à modifiedDateBehavior=now. Pour éviter 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 avec code temporel.
timedTextTrackName

string

Nom de la piste textuelle temporisée.
updateViewedDate

boolean

Indique si la date d'affichage doit être modifiée après la mise à jour du fichier.
useContentAsIndexableText

boolean

Indique si le contenu doit être indexé.
includePermissionsForView

string

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