Drive UI 또는 Google Drive API를 통해 Google Drive 파일 및 폴더를 다른 사용자와 공유할 수 있습니다. 드라이브에서 파일을 공유할 때 다른 사용자가 파일을 수정하거나, 파일에 댓글을 달거나, 열 수만 있도록 설정할 수 있습니다.
리소스 키를 사용하면 의도하지 않은 액세스로부터 파일을 보호할 수 있습니다. 리소스 키는 사용자가 링크를 사용하여 공유된 특정 파일에 액세스할 수 있도록 전달되는 추가 매개변수입니다. 파일을 본 적이 없는 사용자가 액세스 권한을 얻으려면 리소스 키를 제공해야 합니다. 최근에 파일을 보았거나 직접 액세스 권한이 있는 사용자는 파일에 액세스하는 데 리소스 키가 필요하지 않습니다.
링크로 공유된 Drive 파일은 type=user 또는 type=group
permissions 리소스의 결과로 파일에 액세스할 수 있는 사용자만 검색할 수 있습니다. type=domain 또는 type=anyone 권한만 사용하여 이러한 링크 공유 파일에 액세스할 수 있는 사용자의 요청에는 리소스 키가 필요할 수 있습니다.
권한에 대한 자세한 내용은 파일, 폴더, 드라이브 공유하기를 참고하세요. 역할의 전체 목록과 각각에서 허용되는 작업은 역할 및 권한을 참조하세요.
파일에서 리소스 키 읽기
Drive API는 files 리소스의 읽기 전용 resourceKey 필드에서 파일의 리소스 키를 반환합니다.
파일이 Drive 바로가기인 경우 바로가기 대상의 리소스 키가 읽기 전용 shortcutDetails.targetResourceKey 필드에 반환됩니다.
URL(예: exportLinks, webContentLink, webViewLink)을 반환하는 files 리소스의 필드에도 resourceKey이 포함됩니다. Drive UI와 통합되는 클라이언트는 state 매개변수 내에서 resourceKeys를 사용할 수도 있습니다. 자세한 내용은 파일 다운로드 및 내보내기를 참고하세요.
요청에 리소스 키 설정
Drive API에 대한 요청에서 참조하는 모든 파일의 리소스 키는
X-Goog-Drive-Resource-Keys HTTP 헤더에 설정됩니다.
Drive API에 대한 요청에서 X-Goog-Drive-Resource-Keys HTTP 헤더를 사용하여 하나 이상의 리소스 키를 지정할 수 있습니다.
문법
파일 ID와 리소스 키 쌍은 헤더에 슬래시(/) 구분 기호를 사용하여 설정됩니다. 헤더는 쉼표 (,) 구분 기호를 사용하여 모든 파일 ID와 리소스 키 쌍을 결합하여 빌드됩니다.
예를 들어 fileId1 파일을 fileId2 폴더에서 fileId3 폴더로 이동하도록 요청을 가정해 보겠습니다. 이 세 파일의 리소스 키가 각각 resourceKey1, resourceKey2, resourceKey3라고 가정합니다. 이러한 값에서 슬래시와 쉼표 구분자를 사용하여 작성된 헤더는 다음과 같습니다.
X-Goog-Drive-Resource-Keys: fileId1/resourceKey1,fileId2/resourceKey2,fileId3/resourceKey3