- Requête HTTP
- Paramètres de chemin d'accès
- Paramètres de requête
- Corps de la requête
- Corps de la réponse
- Champs d'application des autorisations
- Essayer
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 changer automatiquement, comme "modifiedDate". 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 |
ID du fichier à mettre à jour. |
Paramètres de requête
| Paramètres | |
|---|---|
addParents |
Liste des ID parent à ajouter, séparés par une virgule. |
convert |
Obsolète: ce paramètre n'a aucune fonction. |
enforceSingleParent |
Obsolète: l'ajout de fichiers à plusieurs dossiers n'est plus possible. Utilisez |
modifiedDateBehavior |
Détermine le comportement de mise à jour de |
newRevision |
Indique si une importation de blob doit créer une nouvelle révision. Si la valeur est "false", les données du blob dans la révision de tête actuelle sont remplacées. Si la valeur est "true" ou n'est pas définie, un nouveau 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'à 200 révisions maximum. Pour en savoir plus sur la conservation des révisions, consultez le Centre d'aide Drive. Notez que ce champ est ignoré si aucune charge utile n'est présente dans la requête. |
ocr |
Indique si la reconnaissance optique des caractères doit être tentée sur les fichiers .jpg, .png, .gif ou .pdf importés. |
ocrLanguage |
Si la valeur "ocr" est définie sur "true", la langue à utiliser est suggérée. Les valeurs valides sont les codes BCP 47. |
pinned |
Indique si la nouvelle révision doit être épinglée. Un fichier peut comporter jusqu'à 200 versions épinglées. Notez que ce champ est ignoré si aucune charge utile n'est présente dans la requête. |
removeParents |
Liste des ID parent à supprimer, séparés par une virgule. |
setModifiedDate |
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 |
supportsAllDrives |
Indique si l'application à l'origine de la requête est compatible avec Mon Drive et les Drive partagés. |
supportsTeamDrives |
Obsolète: utilisez |
timedTextLanguage |
Langue du texte synchronisé. |
timedTextTrackName |
Nom de la piste de texte synchronisé. |
updateViewedDate |
Indique si la date de la vue doit être mise à jour une fois le fichier mis à jour. |
useContentAsIndexableText |
Indique si le contenu doit être utilisé comme texte indexable. |
includePermissionsForView |
Spécifie les autorisations de la vue supplémentaire à inclure dans la réponse. Seule l'option |
includeLabels |
Liste d'ID de libellés séparés par une virgule, à inclure dans la partie |
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/docshttps://www.googleapis.com/auth/drivehttps://www.googleapis.com/auth/drive.appdatahttps://www.googleapis.com/auth/drive.apps.readonlyhttps://www.googleapis.com/auth/drive.filehttps://www.googleapis.com/auth/drive.metadatahttps://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.