REST Resource: properties
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Recurso: Propiedad
Es un par clave-valor adjunto a un archivo que es público o privado para una aplicación.
Se aplican los siguientes límites a las propiedades de los archivos:
- Máximo de 100 propiedades en total por archivo
- Un máximo de 30 propiedades privadas por app
- Máximo de 30 propiedades públicas
- Límite máximo de 124 bytes en la cadena (clave + valor) con codificación UTF-8 para una sola propiedad
Algunos métodos de recursos (como properties.update
) requieren un propertyKey
. Usa el método properties.list
para recuperar la clave de una propiedad.
Representación JSON |
{
"selfLink": string,
"value": string,
"visibility": string,
"kind": string,
"etag": string,
"key": string
} |
Campos |
selfLink |
string
Solo salida. Es el vínculo de regreso a esta propiedad.
|
value |
string
Es el valor de esta propiedad.
|
visibility |
string
La visibilidad de esta propiedad. Los valores permitidos son PRIVATE (predeterminado) y PUBLIC. Las propiedades privadas solo se pueden recuperar con una solicitud autenticada. Una solicitud autenticada usa un token de acceso obtenido con un ID de cliente de OAuth 2. No puedes usar una clave de API para recuperar propiedades privadas.
|
kind |
string
Solo salida. Siempre es drive#property .
|
etag |
string
Solo salida. ETag de la propiedad.
|
key |
string
La clave de esta propiedad.
|
Métodos |
|
Borra una propiedad. |
|
Obtiene una propiedad por su clave. |
|
Agrega una propiedad a un archivo o la actualiza si ya existe. |
|
Muestra una lista de las propiedades de un archivo. |
|
Actualiza una propiedad. |
|
Actualiza una propiedad. |
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: 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. |"]]