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를 확인하세요.

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

공유 드라이브 지원 구현 페이지의 정보 외에도 이 추가 필드인 trashedDate(v2의 경우)을 대체합니다.

공유 드라이브 지원 구현에서 다음 메서드에는 공유 드라이브 콘텐츠로 작업할 때 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의 검색어 차이

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

v3에서 v2 createdDate 필드는 createdTime입니다. 예는 공유 드라이브 검색을 참고하세요.

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