이 페이지는 Cloud Translation API를 통해 번역되었습니다.

맞춤 파일 속성 추가

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

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

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

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

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

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

맞춤 파일 속성 사용

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

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

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 메서드를 사용하여 files의 properties 필드 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 키를 사용하여 비공개 속성을 가져올 수 없습니다.