REST Resource: revisions
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Ressource : Revision
Métadonnées d'une révision d'un fichier.
Certaines méthodes de ressources (comme revisions.update
) nécessitent un revisionId
. Utilisez la méthode revisions.list
pour récupérer l'ID d'une révision.
Représentation JSON |
{
"exportLinks": {
string: string,
...
},
"id": string,
"mimeType": string,
"kind": string,
"published": boolean,
"keepForever": boolean,
"md5Checksum": string,
"modifiedTime": string,
"publishAuto": boolean,
"publishedOutsideDomain": boolean,
"publishedLink": string,
"size": string,
"originalFilename": string,
"lastModifyingUser": {
object (User )
}
} |
Champs |
exportLinks |
map (key: string, value: string)
Uniquement en sortie. Liens permettant d'exporter des fichiers des éditeurs Docs dans des formats spécifiques. Objet contenant une liste de paires "key": value . Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" } .
|
id |
string
Uniquement en sortie. ID de la révision.
|
mimeType |
string
Uniquement en sortie. Type MIME de la révision.
|
kind |
string
Uniquement en sortie. Identifie le type de ressource. Valeur : chaîne fixe "drive#revision" .
|
published |
boolean
Indique si cette révision est publiée. Cela ne s'applique qu'aux fichiers des éditeurs Docs.
|
keepForever |
boolean
Indique si cette révision doit être conservée indéfiniment, même si elle n'est plus la révision principale. Si elle n'est pas définie, la révision sera automatiquement supprimée 30 jours après l'importation d'un contenu plus récent. Vous pouvez définir jusqu'à 200 révisions pour un fichier. Ce champ ne s'applique qu'aux fichiers incluant du contenu binaire dans Drive.
|
md5Checksum |
string
Uniquement en sortie. Somme de contrôle MD5 du contenu de la révision. Cela ne s'applique qu'aux fichiers incluant du contenu binaire dans Drive.
|
modifiedTime |
string
Uniquement en sortie. Date et heure de la dernière modification de la révision (RFC 3339).
|
publishAuto |
boolean
Indique si les révisions ultérieures seront republiées automatiquement. Cela ne s'applique qu'aux fichiers des éditeurs Docs.
|
publishedOutsideDomain |
boolean
Indique si cette révision est publiée en dehors du domaine. Cela ne s'applique qu'aux fichiers des éditeurs Docs.
|
publishedLink |
string
Uniquement en sortie. Lien vers la révision publiée. Cette valeur n'est renseignée que pour les fichiers des éditeurs Docs.
|
size |
string (int64 format)
Uniquement en sortie. Taille du contenu de la révision en octets. Cela ne s'applique qu'aux fichiers incluant du contenu binaire dans Drive.
|
originalFilename |
string
Uniquement en sortie. Nom de fichier d'origine utilisé pour créer cette révision. Cela ne s'applique qu'aux fichiers incluant du contenu binaire dans Drive.
|
lastModifyingUser |
object (User )
Uniquement en sortie. Dernier utilisateur à avoir modifié cette révision. Ce champ n'est renseigné que si la dernière modification a été effectuée par un utilisateur connecté.
|
Méthodes |
|
Supprime définitivement une version de fichier. |
|
Obtient les métadonnées ou le contenu d'une révision par ID. |
|
Liste les révisions d'un fichier. |
|
Met à jour une révision avec la sémantique des correctifs. |
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/25 (UTC).
[null,null,["Dernière mise à jour le 2025/07/25 (UTC)."],[],[],null,["# REST Resource: revisions\n\n- [Resource: Revision](#Revision)\n - [JSON representation](#Revision.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: Revision\n------------------\n\nThe metadata for a revision to a file.\n\nSome resource methods (such as `revisions.update`) require a `revisionId`. Use the `revisions.list` method to retrieve the ID for a revision.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"exportLinks\": { string: string, ... }, \"id\": string, \"mimeType\": string, \"kind\": string, \"published\": boolean, \"keepForever\": boolean, \"md5Checksum\": string, \"modifiedTime\": string, \"publishAuto\": boolean, \"publishedOutsideDomain\": boolean, \"publishedLink\": string, \"size\": string, \"originalFilename\": string, \"lastModifyingUser\": { object (/workspace/drive/api/reference/rest/v3/User) } } ``` |\n\n| Fields ||\n|--------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `exportLinks` | `map (key: string, value: string)` Output only. Links for exporting Docs Editors files to specific formats. An object containing a list of `\"key\": value` pairs. Example: `{ \"name\": \"wrench\", \"mass\": \"1.3kg\", \"count\": \"3\" }`. |\n| `id` | `string` Output only. The ID of the revision. |\n| `mimeType` | `string` Output only. The MIME type of the revision. |\n| `kind` | `string` Output only. Identifies what kind of resource this is. Value: the fixed string `\"drive#revision\"`. |\n| `published` | `boolean` Whether this revision is published. This is only applicable to Docs Editors files. |\n| `keepForever` | `boolean` Whether to keep this revision forever, even if it is no longer the head revision. If not set, the revision will be automatically purged 30 days after newer content is uploaded. This can be set on a maximum of 200 revisions for a file. This field is only applicable to files with binary content in Drive. |\n| `md5Checksum` | `string` Output only. The MD5 checksum of the revision's content. This is only applicable to files with binary content in Drive. |\n| `modifiedTime` | `string` Output only. The last time the revision was modified (RFC 3339 date-time). |\n| `publishAuto` | `boolean` Whether subsequent revisions will be automatically republished. This is only applicable to Docs Editors files. |\n| `publishedOutsideDomain` | `boolean` Whether this revision is published outside the domain. This is only applicable to Docs Editors files. |\n| `publishedLink` | `string` Output only. A link to the published revision. This is only populated for Docs Editors files. |\n| `size` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Output only. The size of the revision's content in bytes. This is only applicable to files with binary content in Drive. |\n| `originalFilename` | `string` Output only. The original filename used to create this revision. This is only applicable to files with binary content in Drive. |\n| `lastModifyingUser` | `object (`[User](/workspace/drive/api/reference/rest/v3/User)`)` Output only. The last user to modify this revision. This field is only populated when the last modification was performed by a signed-in user. |\n\n| Methods ------- ||\n|-----------------------------------------------------------------------|----------------------------------------------|\n| ### [delete](/workspace/drive/api/reference/rest/v3/revisions/delete) | Permanently deletes a file version. |\n| ### [get](/workspace/drive/api/reference/rest/v3/revisions/get) | Gets a revision's metadata or content by ID. |\n| ### [list](/workspace/drive/api/reference/rest/v3/revisions/list) | Lists a file's revisions. |\n| ### [update](/workspace/drive/api/reference/rest/v3/revisions/update) | Updates a revision with patch semantics. |"]]