API Reference

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

이 API 참조는 리소스 유형을 기준으로 구성되어 있습니다. 각 리소스 유형은 하나 이상의 데이터 표현 및 하나 이상의 메소드를 갖습니다.

리소스 유형

  1. 정보
  2. 변경사항
  3. 채널
  4. 의견
  5. 파일
  6. 권한
  7. 답장
  8. 버전
  9. 드라이브

정보

리소스 세부정보에 대한 자세한 내용은 리소스 표현 페이지를 참조하세요.

메서드 HTTP 요청 설명
달리 명시되지 않는 한 https://www.googleapis.com/drive/v3의 상대 URI입니다.
가져오기 GET  /about 사용자, 사용자의 Drive, 시스템 기능에 대한 정보를 가져옵니다.

필수 쿼리 매개변수: fields

변경사항

Changes 리소스에 대해 자세히 알아보려면 리소스 표현 페이지를 참고하세요.

메서드 HTTP 요청 설명
달리 명시되지 않는 한 https://www.googleapis.com/drive/v3의 상대 URI입니다.
getStartPageToken GET  /changes/startPageToken 향후 변경사항을 나열하기 위한 시작 pageToken을 가져옵니다.
list GET  /changes 사용자 또는 공유 드라이브의 변경사항을 나열합니다.

필수 쿼리 매개변수: pageToken

시계 POST  /changes/watch 사용자의 변경사항을 구독합니다. 이 메서드를 사용하려면 pageToken 쿼리 매개변수를 포함해야 합니다.

채널

채널 리소스에 대해 자세히 알아보려면 리소스 표현 페이지를 참조하세요.

메서드 HTTP 요청 설명
달리 명시되지 않는 한 https://www.googleapis.com/drive/v3의 상대 URI입니다.
중지 POST  /channels/stop 이 채널을 통한 리소스 시청 중지

댓글

Comments 리소스에 대해 자세히 알아보려면 리소스 표현 페이지를 참고하세요.

메서드 HTTP 요청 설명
달리 명시되지 않는 한 https://www.googleapis.com/drive/v3의 상대 URI입니다.
만들기 POST  /files/fileId/comments 파일에 댓글을 만듭니다.

필수 쿼리 매개변수: fields

delete DELETE  /files/fileId/comments/commentId 댓글을 삭제합니다.
가져오기 GET  /files/fileId/comments/commentId ID별로 댓글을 가져옵니다.

필수 쿼리 매개변수: fields

list GET  /files/fileId/comments 파일의 댓글을 나열합니다.

필수 쿼리 매개변수: fields

업데이트 PATCH  /files/fileId/comments/commentId 패치 시맨틱스를 사용하여 주석을 업데이트합니다.

필수 쿼리 매개변수: fields

파일

파일 리소스에 대한 자세한 내용은 리소스 표현 페이지를 참고하세요.

메서드 HTTP 요청 설명
달리 명시되지 않는 한 https://www.googleapis.com/drive/v3의 상대 URI입니다.
문구 POST  /files/fileId/copy 파일 사본을 만들고 패치 시맨틱스를 사용하여 요청된 업데이트를 적용합니다. 폴더를 복사할 수 없습니다.
만들기 POST
https://www.googleapis.com/upload/drive/v3/files
및
POST  /files 		파일을 만듭니다.
delete DELETE  /files/fileId 사용자가 소유한 파일을 휴지통으로 이동하지 않고 완전히 삭제합니다. 파일이 공유 드라이브에 속한 경우 사용자가 상위 드라이브의 주최자여야 합니다. 타겟이 폴더인 경우 사용자가 소유한 모든 하위 항목도 삭제됩니다.
빈 휴지통 DELETE  /files/trash 사용자의 휴지통의 모든 파일을 완전히 삭제합니다.
내보내기 GET  /files/fileId/export Google Workspace 문서를 요청된 MIME 유형으로 내보내고 내보낸 바이트 콘텐츠를 반환합니다. 내보낸 콘텐츠는 10MB로 제한됩니다.

필수 쿼리 매개변수: mimeType

생성 ID GET  /files/generateIds 생성 또는 복사 요청에 제공할 수 있는 파일 ID 집합을 생성합니다.
가져오기 GET  /files/fileId ID별로 파일의 메타데이터 또는 콘텐츠를 가져옵니다.
list GET  /files 파일을 나열하거나 검색합니다.
업데이트 PATCH
https://www.googleapis.com/upload/drive/v3/files/fileId
및
PATCH  /files/fileId 		파일의 메타데이터 또는 콘텐츠를 업데이트합니다. 이 메서드를 호출할 때는 수정할 요청의 필드만 채웁니다. 필드를 업데이트하면 수정된 날짜와 같은 일부 필드가 자동으로 변경될 수 있습니다. 이 메서드는 패치 시맨틱스를 지원합니다.
시계 POST  /files/fileId/watch 파일 변경사항을 구독합니다. 공유 드라이브의 파일을 변경할 수 있는 채널을 설정할 수 있지만 공유 드라이브 파일을 변경해도 알림이 생성되지 않습니다.
listLabel GET  /files/fileId/listLabels 파일의 라벨을 나열합니다.
modifyLabel POST  /files/fileId/modifyLabels 파일의 라벨 집합을 수정합니다.

권한

Permissions 리소스에 대한 자세한 내용은 리소스 표현 페이지를 참고하세요.

메서드 HTTP 요청 설명
달리 명시되지 않는 한 https://www.googleapis.com/drive/v3의 상대 URI입니다.
만들기 POST  /files/fileId/permissions 파일 또는 공유 드라이브에 대한 권한을 만듭니다. 권한 생성에 관한 자세한 내용은 파일, 폴더, 드라이브 공유를 참고하세요.
delete DELETE  /files/fileId/permissions/permissionId 권한을 삭제합니다.
가져오기 GET  /files/fileId/permissions/permissionId ID별로 권한을 가져옵니다.
list GET  /files/fileId/permissions 파일 또는 공유 드라이브의 권한 목록을 표시합니다.
업데이트 PATCH  /files/fileId/permissions/permissionId 패치 시맨틱스를 사용하여 권한을 업데이트합니다.

답글

Reply 리소스에 대한 자세한 내용은 리소스 표현 페이지를 참조하세요.

메서드 HTTP 요청 설명
달리 명시되지 않는 한 https://www.googleapis.com/drive/v3의 상대 URI입니다.
만들기 POST  /files/fileId/comments/commentId/replies 댓글에 대한 답글을 작성합니다.

필수 쿼리 매개변수: fields

delete DELETE  /files/fileId/comments/commentId/replies/replyId 답글을 삭제합니다.
가져오기 GET  /files/fileId/comments/commentId/replies/replyId ID로 응답을 가져옵니다.

필수 쿼리 매개변수: fields

list GET  /files/fileId/comments/commentId/replies 댓글의 답장을 나열합니다.

필수 쿼리 매개변수: fields

업데이트 PATCH  /files/fileId/comments/commentId/replies/replyId 패치 시맨틱스로 응답을 업데이트합니다.

필수 쿼리 매개변수: fields

버전 기록

버전 리소스에 대한 자세한 내용은 리소스 표현 페이지를 참고하세요.

메서드 HTTP 요청 설명
달리 명시되지 않는 한 https://www.googleapis.com/drive/v3의 상대 URI입니다.
delete DELETE  /files/fileId/revisions/revisionId 파일 버전을 완전히 삭제합니다. 이미지 또는 동영상과 같이 Google Drive에서 바이너리 콘텐츠가 있는 파일의 버전만 삭제할 수 있습니다. Google Docs 또는 Sheets와 같은 다른 파일 및 마지막으로 남은 파일 버전은 삭제할 수 없습니다.
가져오기 GET  /files/fileId/revisions/revisionId ID의 버전 메타데이터 또는 콘텐츠를 가져옵니다.
list GET  /files/fileId/revisions 파일 버전을 나열합니다.
업데이트 PATCH  /files/fileId/revisions/revisionId 패치 시맨틱스로 버전을 업데이트합니다.

Drive

Drive 리소스에 대한 자세한 내용은 리소스 표현 페이지를 참고하세요.

메서드 HTTP 요청 설명
달리 명시되지 않는 한 https://www.googleapis.com/drive/v3의 상대 URI입니다.
만들기 POST  /drives 공유 드라이브를 만듭니다.

필수 쿼리 매개변수: requestId

delete DELETE  /drives/driveId 사용자가 주최자인 공유 드라이브를 완전히 삭제합니다. 공유 드라이브에는 삭제한 항목이 포함되지 않습니다.
가져오기 GET  /drives/driveId ID별로 공유 드라이브의 메타데이터를 가져옵니다.
숨기기 POST  /drives/driveId/hide 기본 보기에서 공유 드라이브를 숨깁니다.
list GET  /drives 사용자의 공유 드라이브 목록을 표시합니다.
숨기기 해제 POST  /drives/driveId/unhide 공유 드라이브를 기본 뷰로 복원합니다.
업데이트 PATCH  /drives/driveId 공유 드라이브의 메타데이터를 업데이트합니다.