Acessar arquivos do Drive compartilhados por link usando chaves de recursos

Você pode compartilhar arquivos e pastas do Google Drive com outras pessoas usando a interface do Drive ou a API Google Drive. Ao compartilhar do Drive, você controla quem pode editar, comentar ou apenas abrir o arquivo.

Uma chave de recurso ajuda a proteger seu arquivo contra acesso não intencional. As chaves de recurso são um parâmetro adicional transmitido para que os usuários possam acessar determinados arquivos compartilhados usando um link. Os usuários que ainda não acessaram o arquivo precisam fornecer a chave de recurso para ter acesso. Quem acessou o arquivo recentemente ou tem acesso direto não precisa da chave de recurso para acessar o arquivo.

Um arquivo do Drive compartilhado com um link só pode ser descoberto por usuários que podem acessar o arquivo como resultado de um recurso type=user ou type=group permissions. As solicitações de usuários que só têm acesso a esses arquivos compartilhados por link usando uma permissão type=domain ou type=anyone podem exigir uma chave de recurso.

Para mais informações sobre permissões, consulte Compartilhar arquivos, pastas e drives. Para conferir uma lista completa de papéis e as operações permitidas por cada um, consulte Papéis e permissões.

Ler a chave de recurso do arquivo

A API Drive retorna a chave de recurso de um arquivo no campo resourceKey somente leitura do recurso files.

Se o arquivo for um atalho do Drive, a chave de recurso para o destino do atalho será retornada no campo shortcutDetails.targetResourceKey somente leitura.

Os campos no recurso files que retornam URLs, como exportLinks, webContentLink e webViewLink, também incluem o resourceKey. Os clientes que se integram à interface do Drive também podem usar resourceKeys no parâmetro state. Para mais informações, consulte Fazer o download e exportar arquivos.

Definir a chave de recurso na solicitação

As chaves de recurso de todos os arquivos referenciados por solicitações à API Drive são definidas no cabeçalho HTTP X-Goog-Drive-Resource-Keys.

As solicitações para a API Drive podem especificar uma ou mais chaves de recurso com o cabeçalho HTTP X-Goog-Drive-Resource-Keys.

Sintaxe

Um par de ID de arquivo e chave de recurso é definido no cabeçalho usando um separador de barra (/). O cabeçalho é criado combinando todos os pares de chaves de recurso e ID de arquivo usando separadores de vírgula (,).

Por exemplo, considere uma solicitação para mover o arquivo fileId1 da pasta fileId2 para a pasta fileId3. Suponha que as chaves de recursos desses três arquivos sejam resourceKey1, resourceKey2 e resourceKey3, respectivamente. O cabeçalho criado a partir desses valores usando um barra e vírgula como separadores é:

    X-Goog-Drive-Resource-Keys: fileId1/resourceKey1,fileId2/resourceKey2,fileId3/resourceKey3