Drive API v2 가이드

Google Drive API 버전 2를 사용하는 경우 Google Drive API 가이드 v3의 콘텐츠는 대부분 v2에도 적용됩니다. 이 섹션에는 v2와 관련되어 있으며 v3 가이드의 특정 페이지에 나와 있는 정보와는 다른 모든 정보가 포함되어 있습니다. 전체 컨텍스트를 확인할 수 있도록 각 하위 섹션에는 해당 가이드 페이지 링크가 포함되어 있습니다.

전체 차이점 목록을 보려면 Drive API v2 및 v3 비교 참조를 확인하세요.

파일 버전 다운로드 및 게시

파일 버전 다운로드 및 게시 페이지에서 다음 정보가 v2에 관한 것이며, v3에 표시된 이러한 섹션을 대체합니다.

개별 버전 나열 및 다운로드

파일 버전 목록을 가져온 후에는 승인된 GET 요청을 []downloadUrl](/drive/api/reference/rest/v2/revisions) 속성으로 전송하여 모든 버전의 콘텐츠를 다운로드할 수 있습니다. 버전을 요청하면 Google Drive에서 이 단기 URL을 생성합니다. 나중에 사용하기 위해 여기에 의존하지 마세요.

exportLinks 속성을 확인하여 지원되는 형식 중 하나로 버전을 내보낼 수도 있습니다.

맞춤 파일 속성

맞춤 파일 속성 추가 페이지의 정보 외에도 v2와 관련된 정보는 다음과 같습니다.

속성은 properties 리소스를 사용하여 액세스합니다.

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

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

한도에 대한 자세한 내용은 참조 문서의 properties를 확인하세요.

공유 드라이브 지원 사용 설정

공유 드라이브 지원 구현 페이지의 정보 외에도 v2의 추가 필드 trashedDate를 바꿉니다.

공유 드라이브 지원 구현에서, 다음 메서드에는 공유 드라이브 콘텐츠로 작업할 때 supportsAllDrives=true가 필요합니다.

  • files.get
  • files.list
  • files.insert
  • files.update
  • files.patch
  • files.copy
  • files.trash
  • files.untrash
  • files.delete
  • files.touch
  • children.insert
  • parents.insert
  • changes.list
  • changes.getStartPageToken
  • changes.get
  • permissions.list
  • permissions.get
  • permissions.insert
  • permissions.update
  • permissions.patch
  • permissions.delete

changes.get 및 changes.list 메서드에는 공유 드라이브와 관련된 몇 가지 매개변수가 있습니다. 매개변수 목록은 공유 드라이브의 변경사항 추적 섹션을 참고하세요.

파일 업로드

파일 데이터 업로드 페이지에서 이 정보는 v2에만 적용됩니다.

Google Docs 유형으로 가져오기

Google Drive에서 파일을 만들 때 일부 유형의 파일을 Google Docs, Google Sheets 또는 Google Slides 문서로 변환할 수 있습니다. files.insert convert 쿼리 매개변수를 포함하고 파일의 (workspace_name) mimeType 속성을 설정합니다. 자세한 내용은 파일 데이터 업로드를 참고하세요.

파일, 폴더, 드라이브 공유하기

파일, 폴더, 드라이브 공유 페이지에서 v3의 유일한 필드인 role는 사용자, 그룹 또는 도메인에 유효한 역할을 지정합니다. v2에서는 사용자, 그룹 또는 도메인이 특정 항목에 대해 갖는 유효한 역할을 반영하는 권한의 role 및 additionalRoles 필드가 모두 필요합니다.

v2의 검색어 차이

v2의 title 필드는 v3에서 name입니다. 예시는 파일 및 폴더 검색을 참고하세요.

v2의 createdDate 필드는 v3에서 createdTime입니다. 예를 보려면 공유 드라이브 검색을 참조하세요.

v2의 modifiedDate 필드는 v3에서 modifiedTime입니다. v2 lastViewedByMeDate 필드는 v3에서 viewedByMeTime입니다. 자세한 내용은 검색어 및 연산자를 참고하세요.