리소스: 속성
애플리케이션에 공개 또는 비공개인 파일에 연결된 키-값 쌍입니다.
파일 속성에는 다음과 같은 제한사항이 적용됩니다.
- 파일당 최대 숙박 시설 100개
- 앱당 최대 30개의 비공개 속성
- 최대 30개의 공개 속성
- 단일 속성의 UTF-8 인코딩에서 (키 + 값) 문자열의 최대 크기 제한은 124바이트입니다.
일부 리소스 메서드 (예: properties.update
)에는 propertyKey
가 필요합니다. properties.list
메서드를 사용하여 속성의 키를 가져옵니다.
JSON 표현 |
---|
{ "selfLink": string, "value": string, "visibility": string, "kind": string, "etag": string, "key": string } |
필드 | |
---|---|
selfLink |
출력 전용입니다. 이 속성으로 다시 연결되는 링크입니다. |
value |
이 속성의 값입니다. |
visibility |
이 속성의 공개 상태입니다. 허용되는 값은 PRIVATE (기본값) 및 PUBLIC입니다. 비공개 속성은 인증된 요청을 사용하여야만 검색할 수 있습니다. 인증된 요청은 OAuth 2 클라이언트 ID로 가져온 액세스 토큰을 사용합니다. API 키를 사용하여 비공개 속성을 검색할 수는 없습니다. |
kind |
출력 전용입니다. 항상 |
etag |
출력 전용입니다. 속성의 ETag입니다. |
key |
이 속성의 키입니다. |
메서드 |
|
---|---|
|
속성을 삭제합니다. |
|
키를 사용하여 속성을 가져옵니다. |
|
파일에 속성을 추가하거나 이미 있는 경우 업데이트합니다. |
|
파일의 속성을 나열합니다. |
|
속성을 업데이트합니다. |
|
속성을 업데이트합니다. |