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 |
Tylko dane wyjściowe. Link do tej usługi. |
value |
Wartość tej właściwości. |
visibility |
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 |
Tylko dane wyjściowe. Jest ona zawsze |
etag |
Tylko dane wyjściowe. ETag nieruchomości. |
key |
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ść. |