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-01-09 UTC.
[null,null,["Последнее обновление: 2025-01-09 UTC."],[[["File properties are key-value pairs that can be attached to a file, with limits on the total number and size."],["Properties can have either public or private visibility, impacting how they are accessed."],["The `properties` resource provides methods for managing file properties, such as adding, updating, deleting, and listing them."],["Each property is represented by a JSON object with fields like `selfLink`, `value`, `visibility`, `kind`, `etag`, and `key`."],["To retrieve the key for a property, which is needed for some operations, use the `properties.list` method."]]],["File properties are key-value pairs, either public or private, with limits: 100 total, 30 private per app, 30 public, and 124 bytes per property. Properties can be manipulated using methods such as `delete`, `get`, `insert`, `list`, `patch`, and `update`. The `visibility` field determines if the property is private or public. Private properties require OAuth 2 authentication, they can't use an API key. `properties.list` retrieves property keys, necessary for `properties.update`.\n"]]