Acessar arquivos do Drive compartilhados por link usando chaves de recursos

Você pode compartilhar arquivos e pastas do Google Drive com outras pessoas usando o pela interface do Drive ou pelo API Google Drive. Quando você compartilha de 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. Chaves de recurso são um parâmetro adicional transmitido para que os usuários possam acessar determinados arquivos que foram compartilhadas usando um link. Usuários que nunca visualizaram o arquivo precisa fornecer a chave de recurso para ter acesso. Aqueles que visualizaram recentemente o ou tiver acesso direto, não precisam 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 uma ação type=user ou type=group. permissions. Solicitações de usuários que só têm acesso a esses arquivos de link compartilhado usando um type=domain ou A permissão type=anyone pode exigir uma chave de recurso.

Para mais informações sobre permissões, consulte Compartilhar arquivos, pastas e drives. Para uma lista completa de papéis e das operações permitidos por cada um, consulte Funções e do Cloud Storage.

Ler a chave de recurso do arquivo

A API Drive retorna a chave de recurso de um arquivo no espaço Campo resourceKey do recurso files.

Se o arquivo for um atalho do Drive, o a chave de recurso para o destino do atalho for retornada no bloco shortcutDetails.targetResourceKey.

Campos do 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 state; . Para mais informações, consulte Fazer o download e exportar .tf.

Definir a chave de recurso na solicitação

Chaves de recurso de todos os arquivos referenciados por solicitações para a 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 ID de arquivo e um par de chaves de recurso são definidos no cabeçalho usando uma barra (/). O cabeçalho é criado combinando todos os IDs do arquivo e recursos pares de chaves usando separadores de vírgula (,).

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

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