Вы можете делиться файлами и папками 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
Связанные темы
- Делитесь файлами, папками и дисками
- Загрузка и экспорт файлов
- Защита содержимого файла
- Настройка интеграции пользовательского интерфейса Диска