REST Resource: properties
리소스: 속성
애플리케이션에 공개 또는 비공개 파일에 첨부된 키-값 쌍입니다.
파일 속성에는 다음 한도가 적용됩니다.
- 파일당 총 속성 최대 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 |
string
출력 전용입니다. 이 속성으로 다시 연결되는 링크입니다.
|
value |
string
이 속성의 값입니다.
|
visibility |
string
이 속성의 공개 상태입니다. 허용되는 값은 PRIVATE (기본값) 및 PUBLIC입니다. 비공개 속성은 인증된 요청을 사용해서만 검색할 수 있습니다. 인증된 요청은 OAuth 2 클라이언트 ID로 얻은 액세스 토큰을 사용합니다. API 키를 사용하여 비공개 속성을 가져올 수 없습니다.
|
kind |
string
출력 전용입니다. 항상 drive#property 입니다.
|
etag |
string
출력 전용입니다. 속성의 eETag입니다.
|
key |
string
이 속성의 키입니다.
|
메서드 |
|
속성을 삭제합니다. |
|
키를 기준으로 속성을 가져옵니다. |
|
파일에 속성을 추가하거나 파일이 이미 있는 경우 업데이트합니다. |
|
파일의 속성을 나열합니다. |
|
속성을 업데이트합니다. |
|
속성을 업데이트합니다. |
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2024-09-04(UTC)
[null,null,["최종 업데이트: 2024-09-04(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"]]