REST Resource: properties
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Ресурс: Недвижимость
Пара ключ-значение, прикрепленная к файлу, который является общедоступным или личным для приложения.
К свойствам файла применяются следующие ограничения:
- Максимум 100 свойств в одном файле.
- Максимум 30 частных свойств на одно приложение.
- Максимум 30 общедоступных объектов
- Максимальный размер строки (ключ + значение) в 124 байтах в кодировке UTF-8 для одного свойства.
Некоторым методам ресурсов (например, properties.update
) требуется propertyKey
. Используйте метод properties.list
для получения ключа свойства.
JSON-представление |
---|
{
"selfLink": string,
"value": string,
"visibility": string,
"kind": string,
"etag": string,
"key": string
} |
Поля |
---|
selfLink | string Только вывод. Обратная ссылка на этот ресурс. |
value | string Стоимость этого имущества. |
visibility | string Видимость этого свойства. Допустимые значения: ЧАСТНЫЙ (по умолчанию) и ПУБЛИЧНЫЙ. Частные свойства можно получить только с помощью аутентифицированного запроса. Аутентифицированный запрос использует токен доступа, полученный с помощью идентификатора клиента OAuth 2. Вы не можете использовать ключ API для получения частных свойств. |
kind | string Только вывод. Это всегда drive#property . |
etag | string Только вывод. ETag объекта недвижимости. |
key | string Ключ этого свойства. |
Методы |
---|
| Удаляет свойство. |
| Получает свойство по его ключу. |
| Добавляет свойство в файл или обновляет его, если оно уже существует. |
| Перечисляет свойства файла. |
| Обновляет свойство. |
| Обновляет свойство. |
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-07-25 UTC.
[null,null,["Последнее обновление: 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. |"]]