Drive UI 또는 Google Drive API를 통해 다른 사용자와 Google Drive 파일 및 폴더를 공유할 수 있습니다. 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