Доступ к файлам на Диске с общим доступом по ссылке с помощью ключей ресурсов

Вы можете делиться файлами и папками Google Drive с другими пользователями, используя пользовательский интерфейс Drive или API Google Drive . При предоставлении доступа из Drive вы можете контролировать, смогут ли пользователи редактировать файл, оставлять комментарии или только открывать его.

Ключ ресурса помогает защитить ваш файл от несанкционированного доступа. Ключи ресурсов — это дополнительный параметр, передаваемый пользователям для доступа к определенным файлам, предоставленным по ссылке. Пользователи, которые ранее не просматривали файл, должны предоставить ключ ресурса для получения доступа. Тем, кто недавно просматривал файл или имеет к нему прямой доступ, ключ ресурса для доступа не требуется.

Файл Google Диска, предоставленный по ссылке, может быть обнаружен только пользователями, имеющими доступ к файлу на основании permissions type=user или type=group . Запросы от пользователей, имеющих доступ к этим файлам по ссылке только на основании прав доступа type=domain или type=anyone могут потребовать ключ ресурса.

Дополнительную информацию о правах доступа см. в разделе «Общий доступ к файлам, папкам и дискам» . Полный список ролей и разрешенных для каждой из них операций см. в разделе «Роли и права доступа» .

Прочитайте ключ ресурса из файла.

API Google Диска возвращает ключ ресурса файла, находящийся в поле resourceKey доступном только для чтения, в ресурсе files .

Если файл является ярлыком Google Диска , ключ ресурса для целевого объекта ярлыка возвращается в поле shortcutDetails.targetResourceKey , доступном только для чтения.

Поля в ресурсе files , возвращающие URL-адреса, такие как exportLinks , webContentLink и webViewLink , также содержат resourceKey . Клиенты, интегрированные с пользовательским интерфейсом Google Диска, также могут использовать resourceKeys в параметре state . Для получения дополнительной информации см. раздел «Загрузка и экспорт файлов» .

Укажите ключ ресурса в запросе.

Ключи ресурсов для любых файлов, на которые ссылаются запросы к API Google Drive, устанавливаются в HTTP-заголовке X-Goog-Drive-Resource-Keys .

В запросах к API Google Drive можно указывать один или несколько ключей ресурсов с помощью HTTP-заголовка X-Goog-Drive-Resource-Keys .

Синтаксис

В заголовке указывается пара идентификатор файла и ключ ресурса с использованием разделителя в виде косой черты ( / ). Заголовок формируется путем объединения всех пар идентификатора файла и ключа ресурса с использованием разделителей в виде запятой ( , ).

Например, рассмотрим запрос на перемещение файла fileId1 из папки fileId2 в папку fileId3 . Предположим, что ключами ресурсов для этих трех файлов являются resourceKey1 , resourceKey2 и resourceKey3 соответственно. Заголовок, построенный из этих значений с использованием косой черты и запятых в качестве разделителей, выглядит следующим образом:

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