REST Resource: revisions
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Recurso: Revision
Son los metadatos de una revisión de un archivo.
Algunos métodos de recursos (como revisions.update
) requieren un revisionId
. Usa el método revisions.list
para recuperar el ID de una revisión.
Representación 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 )
}
} |
Campos |
exportLinks |
map (key: string, value: string)
Solo salida. Vínculos para exportar archivos de los editores de Documentos a formatos específicos. Es un objeto que contiene una lista de pares "key": value . Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" } .
|
id |
string
Solo salida. Es el ID de la revisión.
|
mimeType |
string
Solo salida. Es el tipo de MIME de la revisión.
|
kind |
string
Solo salida. Identifica qué tipo de recurso es este. El valor es la cadena fija "drive#revision" .
|
published |
boolean
Indica si esta revisión se publicó. Esto solo se aplica a los archivos de los editores de Documentos.
|
keepForever |
boolean
Indica si se debe conservar esta revisión para siempre, incluso si ya no es la revisión principal. Si no se configura, la revisión se borrará automáticamente 30 días después de que se suba contenido más reciente. Esto se puede establecer en un máximo de 200 revisiones para un archivo. Este campo solo se aplica a los archivos con contenido binario en Drive.
|
md5Checksum |
string
Solo salida. Suma de verificación MD5 del contenido de la revisión. Esto solo se aplica a los archivos con contenido binario en Drive.
|
modifiedTime |
string
Solo salida. Fecha y hora de la última modificación de la revisión (RFC 3339).
|
publishAuto |
boolean
Indica si las revisiones posteriores se volverán a publicar automáticamente. Esto solo se aplica a los archivos de los editores de Documentos.
|
publishedOutsideDomain |
boolean
Indica si esta revisión se publicó fuera del dominio. Esto solo se aplica a los archivos de los editores de Documentos.
|
publishedLink |
string
Solo salida. Vínculo a la revisión publicada. Este campo solo se completa para los archivos de los editores de Documentos.
|
size |
string (int64 format)
Solo salida. Es el tamaño del contenido de la revisión en bytes. Esto solo se aplica a los archivos con contenido binario en Drive.
|
originalFilename |
string
Solo salida. Es el nombre de archivo original que se usó para crear esta revisión. Esto solo se aplica a los archivos con contenido binario en Drive.
|
lastModifyingUser |
object (User )
Solo salida. Es el último usuario que modificó esta revisión. Este campo solo se completa cuando la última modificación la realizó un usuario que accedió a su cuenta.
|
Métodos |
|
Borra de forma permanente una versión de archivo. |
|
Obtiene el contenido o los metadatos de una revisión por ID. |
|
Enumera las revisiones de un archivo. |
|
Actualiza una revisión con semántica de parche. |
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-07-25 (UTC)
[null,null,["Última actualización: 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. |"]]