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

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

이 리소스 키 요구사항은 이전 파일의 하위 집합에만 적용됩니다.

권한에 대한 자세한 내용은 파일, 폴더, 드라이브 공유를 참고하세요.

파일에서 리소스 키 읽기

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

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

요청에 리소스 키 설정

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