리소스 키를 사용하여 링크 공유 Drive 파일에 액세스

Drive UI를 사용하거나 Google Drive API를 통해 다른 사용자와 Google Drive 파일 및 폴더를 공유할 수 있습니다. 드라이브에서 공유할 때 다른 사용자가 파일을 수정하거나, 파일에 댓글을 달거나, 파일을 열 수만 있도록 설정할 수 있습니다.

리소스 키는 의도하지 않은 액세스로부터 파일을 보호하는 데 도움이 됩니다. 리소스 키는 사용자가 링크를 사용하여 공유된 특정 파일에 액세스할 수 있도록 전달되는 추가 매개변수입니다. 이전에 파일을 본 적이 없는 사용자는 액세스 권한을 얻기 위해 리소스 키를 제공해야 합니다. 최근에 파일을 보았거나 직접 액세스할 수 있는 사용자는 파일에 액세스하기 위해 리소스 키가 필요하지 않습니다.

링크로 공유된 Drive 파일은 type=user 또는 type=group permissions 리소스의 결과로 파일에 액세스할 수 있는 사용자만 검색할 수 있습니다. type=domain 또는 type=anyone 권한을 사용하여 이러한 링크 공유 파일에만 액세스할 수 있는 사용자의 요청에는 리소스 키가 필요할 수 있습니다.

권한에 대한 자세한 내용은 파일, 폴더, 드라이브 공유하기를 참고하세요. 역할 및 각 역할에 허용된 작업의 전체 목록은 역할 및 권한을 참고하세요.

파일에서 리소스 키를 읽습니다.

Drive API는 files 리소스의 읽기 전용 resourceKey 필드에 파일의 리소스 키를 반환합니다.

파일이 Drive 바로가기인 경우 바로가기 타겟의 리소스 키가 읽기 전용 shortcutDetails.targetResourceKey 필드에 반환됩니다.

exportLinks, webContentLink, webViewLink과 같이 URL을 반환하는 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