맞춤 파일 속성은 태그, 다른 데이터 저장소의 ID, 워크플로 애플리케이션 간에 공유되는 정보 등 파일의 커스텀 메타데이터를 저장하는 데 사용되는 키-값 쌍입니다.
모든 앱에 표시되는 속성을 추가하려면 files 리소스의 properties 필드를 사용합니다. 앱에 제한된 속성을 추가하려면 files 리소스의 appProperties 필드를 사용합니다.
속성은 검색 표현식에서도 사용할 수 있습니다.
이는 파일 자체에 Drive 파일의 데이터베이스 ID를 저장하는 데 사용할 수 있는 일반적인 속성의 구조입니다.
Drive API v3
"appProperties": {
"additionalID": "8e8aceg2af2ge72e78",
}
Drive API v2
{
'key': 'additionalID',
'value': '8e8aceg2af2ge72e78',
'visibility': 'PRIVATE'
}
맞춤 속성에는 다음과 같은 한도가 있습니다.
- 파일당 최대 100개의 맞춤 속성이 있으며 모든 소스에서 합산됨
- 파일당 최대 30개의 공개 속성이며 모든 소스에서 합산되었습니다.
- 한 애플리케이션에서 파일당 비공개 속성은 최대 30개입니다.
- UTF-8 인코딩의 속성 (키 및 값 모두 포함) 문자열당 최대 124바이트 크기 예를 들어 키가 10자인 속성은 값에 114자만 포함할 수 있습니다. 값에 100자(영문 기준)가 필요한 속성은 키에 최대 24자를 사용할 수 있습니다.
- 파일 속성을 작성하면 다른 쓰기 작업과 성능에 영향을 미칩니다.
자세한 내용은 files 리소스를 참고하세요.
맞춤 파일 속성 액세스
이러한 속성은 인증된 요청을 사용해서만 가져올 수 있습니다. 인증된 요청은 OAuth 2 클라이언트 ID로 얻은 액세스 토큰을 사용합니다. API 키를 사용하여 비공개 속성을 가져올 수 없습니다.