REST Resource: revisions
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Recurso: Revision
Os metadados de uma revisão de um arquivo.
Alguns métodos de recursos (como revisions.update
) exigem um revisionId
. Use o método revisions.list
para recuperar o ID de uma revisão.
Representação 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)
Apenas saída. Links para exportar arquivos dos editores de documentos para formatos específicos. Um objeto com uma lista de pares "key": value . Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" } .
|
id |
string
Apenas saída. O ID da revisão.
|
mimeType |
string
Apenas saída. O tipo MIME da revisão.
|
kind |
string
Apenas saída. Identifica o tipo de recurso. Valor: a string fixa "drive#revision" .
|
published |
boolean
Indica se esta revisão foi publicada. Isso só é aplicável a arquivos dos editores do Google Docs.
|
keepForever |
boolean
Se esta revisão deve ser mantida para sempre, mesmo que não seja mais a revisão principal. Se não for definido, a revisão será excluída automaticamente 30 dias após o upload de um conteúdo mais recente. Isso pode ser definido em até 200 revisões de um arquivo. Esse campo só é aplicável a arquivos com conteúdo binário no Drive.
|
md5Checksum |
string
Apenas saída. A soma de verificação MD5 do conteúdo da revisão. Isso só se aplica a arquivos com conteúdo binário no Drive.
|
modifiedTime |
string
Apenas saída. A última vez que a revisão foi modificada (data e hora RFC 3339).
|
publishAuto |
boolean
Indica se as revisões subsequentes serão republicadas automaticamente. Isso só é aplicável a arquivos dos editores do Google Docs.
|
publishedOutsideDomain |
boolean
Indica se esta revisão foi publicada fora do domínio. Isso só é aplicável a arquivos dos editores do Google Docs.
|
publishedLink |
string
Apenas saída. Um link para a revisão publicada. Esse campo só é preenchido para arquivos dos editores do Google Docs.
|
size |
string (int64 format)
Apenas saída. O tamanho do conteúdo da revisão em bytes. Isso só se aplica a arquivos com conteúdo binário no Drive.
|
originalFilename |
string
Apenas saída. O nome do arquivo original usado para criar esta revisão. Isso só se aplica a arquivos com conteúdo binário no Drive.
|
lastModifyingUser |
object (User )
Apenas saída. O último usuário a modificar esta revisão. Esse campo só é preenchido quando a última modificação foi feita por um usuário conectado.
|
Métodos |
|
Exclui permanentemente uma versão de arquivo. |
|
Recebe os metadados ou o conteúdo de uma revisão por ID. |
|
Lista as revisões de um arquivo. |
|
Atualiza uma revisão com semântica de patch. |
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-07-25 UTC.
[null,null,["Última atualização 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. |"]]