Acessar arquivos compartilhados por links usando chaves de recursos

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

Esse requisito de chave de recurso só se aplica a um subconjunto de arquivos antigos.

Para mais informações sobre permissões, consulte Compartilhar arquivos, pastas e unidades.

Ler a chave de recurso do arquivo

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

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

Definir a chave de recurso na solicitação

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

Sintaxe

Um par de IDs de arquivo e chave de recurso são definidos no cabeçalho usando uma barra (/). O cabeçalho é criado combinando todos esses pares de IDs de arquivo e chaves de recursos, usando vírgulas (,).

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

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