Method: files.update

Met à jour les métadonnées et/ou le contenu 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 d'entre eux 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 mé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 */* n'est utilisée que pour indiquer que n'importe quel type MIME valide peut être importé.

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

Requête HTTP

  • URI d'importation, pour les demandes 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 de métadonnées uniquement:
    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
fileId

string

ID du fichier.

Paramètres de requête

Paramètres
addParents

string

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

boolean

Obsolète: l'ajout de fichiers à plusieurs dossiers n'est plus possible. Utilisez plutôt des raccourcis.
keepRevisionForever

boolean

Indique si le champ "keepForever" doit être défini dans la nouvelle révision principale. Cette option ne s'applique qu'aux fichiers incluant du contenu binaire dans Google Drive. Seules 200 révisions du fichier peuvent être conservées indéfiniment. Si la limite est atteinte, essayez de supprimer les révisions épinglées.
ocrLanguage

string

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

string

Liste des ID parent à supprimer, séparés par une virgule.
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 supportsAllDrives à la place.
uploadType

string

Type de requête d'importation à l'URI /upload. Si vous importez des données avec un URI /upload, ce champ est obligatoire. Si vous créez un fichier contenant uniquement des métadonnées, ce champ n'est pas obligatoire. De plus, ce champ n'est pas affiché dans le widget "Essayez 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 uniquement le contenu multimédia, 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écapitulative, à l'aide d'une série d'au moins deux requêtes, dont la première inclut les métadonnées.
useContentAsIndexableText

boolean

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

string

Spécifie les autorisations de la vue supplémentaire à inclure dans la réponse. Seule la valeur "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/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 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.