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입니다. 자세한 내용은 검색어 및 검색 연산자를 참고하세요.