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