맞춤 파일 속성 추가

맞춤 파일 속성은 Google Drive 파일 (예: 태그), 다른 데이터 스토어의 ID, 정보 워크플로 애플리케이션 간에 공유되는 등등입니다. 예를 들어 1분기에 영업 부서에서 생성한 모든 문서에 대해 속성을 추가할 수 있습니다.

모든 애플리케이션에 표시되는 속성을 추가하려면properties files 리소스 속성을 추가하는 방법 앱으로 제한된 경우 files 리소스의 appProperties 필드를 사용합니다.

속성은 검색 표현식에 대해 자세히 알아보세요.

이는 인벤토리 파일을 저장하는 데 사용할 수 있는 일반적인 속성의 구조입니다. 파일에 있는 Drive 파일의 데이터베이스 ID입니다.

드라이브 API v3

"appProperties": {
  "additionalID": "ID",
}

드라이브 API v2

{
  'key':        'additionalID',
  'value':      'ID',
  'visibility': 'PRIVATE'
}

맞춤 파일 속성 사용

이 섹션에서는 맞춤 파일 속성 관련 작업을 수행하는 방법을 설명합니다. 모든 애플리케이션에 영향을 미칩니다

맞춤 파일 속성 추가 또는 업데이트

모든 애플리케이션에 표시되는 속성을 추가하거나 업데이트하려면 files.update 메서드를 사용하여 filesproperties 필드 리소스도 제공합니다

PATCH https://www.googleapis.com/drive/v3/files/FILE_ID
{
  "properties": {
    "name": "wrench",
    "mass": "1.3kg",
    "count": "3"
  }
}

또한 고급 Google Apps Script의 드라이브 서비스. 자세한 내용은 맞춤 설정 추가 속성을 참조하세요.

맞춤 파일 속성 가져오기 또는 나열

모든 애플리케이션에 표시되는 속성을 보려면 files.get 메서드를 사용하여 파일에 대한 커스텀 파일 속성을 정의합니다.

GET https://www.googleapis.com/drive/v3/files/FILE_ID?fields=properties

응답은 properties 객체로 구성되며 키-값 쌍을 생성할 수 있습니다.

{
  "properties": {
    "name": "wrench",
    "mass": "1.3kg",
    "count": "3"
  }
}

맞춤 파일 속성 삭제

모든 애플리케이션에 표시되는 속성 값을 삭제하려면 files.update 메서드를 사용하여 filesproperties 필드 null로 설정하면 됩니다.

PATCH https://www.googleapis.com/drive/v3/files/FILE_ID
{
  "name": null
}

변경사항을 확인하려면 files.get 메서드를 사용하여 파일의 properties 객체입니다.

{
  "properties": {
    "mass": "1.3kg",
    "count": "3"
  }
}

맞춤 파일 속성의 제한사항

커스텀 속성에는 다음과 같은 제한이 있습니다.

  • 파일당 최대 100개의 맞춤 속성(모든 소스의 총합)
  • 파일당 최대 30개의 공개 속성(모든 소스의 공개 속성 합계)
  • 하나의 애플리케이션에서 파일당 최대 30개의 비공개 속성을 사용할 수 있습니다.
  • 다음에서 속성 문자열당 최대 124바이트 (키와 값 모두 포함) UTF-8 인코딩 예를 들어 키가 10자(영문 기준)인 속성 값은 114자(영문 기준)만 포함할 수 있습니다. 마찬가지로 는 100자(영문 기준) 필요, 최대 24자(영문 기준)까지 사용할 수 있는 키를 누릅니다.

자세한 내용은 files를 참고하세요. 리소스도 제공합니다 Drive API v2의 경우 다음을 참조하세요. properties 리소스

비공개 맞춤 파일 속성에 액세스

다음을 통해 appProperties 필드를 사용하여 사유지만 검색할 수 있습니다. OAuth 2.0으로 얻은 액세스 토큰을 사용하는 인증된 요청 클라이언트 ID를 찾습니다. API 키를 사용하여 비공개 속성을 가져올 수 없습니다.