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

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

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

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

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

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

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

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

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

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

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

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

Синтаксис

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

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

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