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
출력 전용입니다. 속성의 ETag입니다.
|
key |
string
이 속성의 키입니다.
|
메서드 |
|
속성을 삭제합니다. |
|
키를 사용하여 속성을 가져옵니다. |
|
파일에 속성을 추가하거나 이미 있는 경우 업데이트합니다. |
|
파일의 속성을 나열합니다. |
|
속성을 업데이트합니다. |
|
속성을 업데이트합니다. |
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-25(UTC)
[null,null,["최종 업데이트: 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. |"]]