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
}
필드
value

string

이 속성의 값입니다.

visibility

string

이 속성의 공개 상태입니다. 허용되는 값은 PRIVATE (기본값) 및 PUBLIC입니다. 비공개 속성은 인증된 요청을 사용해서만 검색할 수 있습니다. 인증된 요청은 OAuth 2 클라이언트 ID로 얻은 액세스 토큰을 사용합니다. API 키를 사용하여 비공개 속성을 가져올 수 없습니다.

kind

string

출력 전용입니다. 항상 drive#property입니다.

etag

string

출력 전용입니다. 속성의 eETag입니다.

key

string

이 속성의 키입니다.

메서드

delete

속성을 삭제합니다.

get

키를 기준으로 속성을 가져옵니다.

insert

파일에 속성을 추가하거나 파일이 이미 있는 경우 업데이트합니다.

list

파일의 속성을 나열합니다.

patch

속성을 업데이트합니다.

update

속성을 업데이트합니다.