REST Resource: properties
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Zasób: usługa
Para klucz-wartość dołączona do pliku, który jest publiczny lub prywatny dla aplikacji.
W przypadku właściwości plików obowiązują te limity:
- Maksymalnie 100 usług na plik.
- Maksymalnie 30 właściwości prywatnych na aplikację
- Maksymalnie 30 publicznych usług
- Maksymalny rozmiar ciągu (klucz + wartość) w kodzie UTF-8 nie może przekraczać 124 bajtów w przypadku jednej właściwości
Niektóre metody zasobów (takie jak properties.update) wymagają propertyKey. Aby pobrać klucz usługi, użyj metody properties.list.
| Zapis JSON |
{
"selfLink": string,
"value": string,
"visibility": string,
"kind": string,
"etag": string,
"key": string
} |
| Pola |
selfLink |
string
Tylko dane wyjściowe. Link do tej usługi.
|
value |
string
Wartość tej właściwości.
|
visibility |
string
Widoczność tej usługi. Dozwolone wartości to PRYWATNY (domyślny) i PUBLICZNY. Właściwości prywatne można pobrać tylko przy użyciu uwierzytelnionego żądania. Żądanie uwierzytelnione używa tokena dostępu uzyskanego za pomocą identyfikatora klienta OAuth 2. Nie możesz używać klucza interfejsu API do pobierania właściwości prywatnych.
|
kind |
string
Tylko dane wyjściowe. Jest ona zawsze drive#property.
|
etag |
string
Tylko dane wyjściowe. ETag nieruchomości.
|
key |
string
Klucz tej usługi.
|
Metody |
|
|
Usuwa usługę. |
|
|
Pobiera usługę według klucza. |
|
|
Dodaje właściwość do pliku lub aktualizuje ją, jeśli już istnieje. |
|
|
Wyświetla właściwości pliku. |
|
|
Zaktualizuje właściwość. |
|
|
Zaktualizuje właściwość. |
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-25 UTC.
[null,null,["Ostatnia aktualizacja: 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. |"]]
