REST Resource: properties
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Recurso: propriedade
Um par de chave-valor anexado a um arquivo público ou privado de um aplicativo.
Os limites a seguir se aplicam às propriedades de arquivo:
- Máximo de 100 propriedades no total por arquivo
- Máximo de 30 propriedades privadas por app
- Máximo de 30 propriedades públicas
- Limite máximo de 124 bytes na string (chave + valor) na codificação UTF-8 para uma única propriedade
Alguns métodos de recurso (como properties.update) exigem um propertyKey. Use o método properties.list para extrair a chave de uma propriedade.
| Representação JSON |
{
"selfLink": string,
"value": string,
"visibility": string,
"kind": string,
"etag": string,
"key": string
} |
| Campos |
selfLink |
string
Apenas saída. O link de volta para essa propriedade.
|
value |
string
O valor dessa propriedade.
|
visibility |
string
A visibilidade dessa propriedade. Os valores permitidos são PRIVADO (padrão) e PÚBLICO. As propriedades privadas só podem ser recuperadas usando uma solicitação autenticada. Uma solicitação autenticada usa um token de acesso recebido com um ID do cliente OAuth 2. Não é possível usar uma chave de API para recuperar propriedades privadas.
|
kind |
string
Apenas saída. Isso é sempre drive#property.
|
etag |
string
Apenas saída. ETag da propriedade.
|
key |
string
A chave dessa propriedade.
|
Métodos |
|
|
Exclui uma propriedade. |
|
|
Recebe uma propriedade pela chave. |
|
|
Adiciona uma propriedade a um arquivo ou atualiza se ele já existir. |
|
|
Lista as propriedades de um arquivo. |
|
|
Atualiza uma propriedade. |
|
|
Atualiza uma propriedade. |
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: properties\n\n- [Resource: Property](#Property)\n - [JSON representation](#Property.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: Property\n------------------\n\nA key-value pair attached to a file that is either public or private to an application.\n\nThe following limits apply to file properties:\n\n- Maximum of 100 properties total per file\n- Maximum of 30 private properties per app\n- Maximum of 30 public properties\n- Maximum of 124 bytes size limit on (key + value) string in UTF-8 encoding for a single property\n\nSome resource methods (such as `properties.update`) require a `propertyKey`. Use the `properties.list` method to retrieve the key for a property.\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------|\n| ``` { \"selfLink\": string, \"value\": string, \"visibility\": string, \"kind\": string, \"etag\": string, \"key\": string } ``` |\n\n| Fields ||\n|--------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `selfLink` | `string` Output only. The link back to this property. |\n| `value` | `string` The value of this property. |\n| `visibility` | `string` The visibility of this property. Allowed values are PRIVATE (default) and PUBLIC. Private properties can only be retrieved using an authenticated request. An authenticated request uses an access token obtained with a OAuth 2 client ID. You cannot use an API key to retrieve private properties. |\n| `kind` | `string` Output only. This is always `drive#property`. |\n| `etag` | `string` Output only. ETag of the property. |\n| `key` | `string` The key of this property. |\n\n| Methods ------- ||\n|------------------------------------------------------------------------|----------------------------------------------------------------|\n| ### [delete](/workspace/drive/api/reference/rest/v2/properties/delete) | Deletes a property. |\n| ### [get](/workspace/drive/api/reference/rest/v2/properties/get) | Gets a property by its key. |\n| ### [insert](/workspace/drive/api/reference/rest/v2/properties/insert) | Adds a property to a file, or updates it if it already exists. |\n| ### [list](/workspace/drive/api/reference/rest/v2/properties/list) | Lists a file's properties. |\n| ### [patch](/workspace/drive/api/reference/rest/v2/properties/patch) | Updates a property. |\n| ### [update](/workspace/drive/api/reference/rest/v2/properties/update) | Updates a property. |"]]
