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 voulez 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 accepte les fichiers 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 au lieu de la valeur littérale */*. Le littéral */* 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.

Requête HTTP :

  • URI d'importation, pour les requêtes d'importation de contenus multimédias:
    PATCH https://www.googleapis.com/upload/drive/v3/files/{fileId}
  • URI de métadonnées, pour les requêtes ne contenant que des métadonnées:
    PATCH https://www.googleapis.com/drive/v3/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 ne prend pas en charge l'importation de données.

Les valeurs acceptées sont les suivantes :
fileId

string

Identifiant du fichier.

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 ne prend pas en charge l'importation de données.

Les valeurs acceptées sont les suivantes :
addParents

string

Liste des ID parents à ajouter, séparés par une virgule.
enforceSingleParent
(deprecated)

boolean

Obsolète: il n'est plus possible d'ajouter des fichiers à plusieurs dossiers. Utilisez plutôt des raccourcis.
keepRevisionForever

boolean

Permet de définir s'il faut définir le champ "keepForever" dans la nouvelle révision de la tête. Cela ne s'applique qu'aux fichiers comportant du contenu binaire dans Google Drive. Seules 200 révisions peuvent être conservées. Si la limite est atteinte, essayez de supprimer les révisions épinglées.
ocrLanguage

string

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

string

Liste des ID parents à supprimer, séparés par une virgule.
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 indexé.
includePermissionsForView

string

Spécifie les autorisations supplémentaires de la vue à inclure dans la réponse. Seul "publié" est accepté.
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/drive
  • https://www.googleapis.com/auth/drive.appdata
  • 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.