Pliki i foldery z Dysku Google możesz udostępniać innym osobom za pomocą interfejsu Dysku lub interfejsu Google Drive API. Gdy udostępniasz plik z Dysku, możesz określić, czy użytkownicy będą mogli go edytować, komentować czy tylko otwierać.
Klucz zasobu pomaga chronić plik przed niezamierzonym dostępem. Klucze zasobów to dodatkowy parametr, który jest przekazywany w celu umożliwienia użytkownikom dostępu do określonych plików udostępnionych za pomocą linku. Użytkownicy, którzy wcześniej nie wyświetlali takiego pliku, muszą podać klucz zasobu, aby uzyskać dostęp. Osoby, które ostatnio wyświetlały plik lub mają do niego bezpośredni dostęp, nie potrzebują klucza zasobu, aby uzyskać do niego dostęp.
Plik na Dysku udostępniony przy użyciu linku może znaleźć tylko użytkownicy, którzy mają do niego dostęp w ramach zasobu type=user
lub type=group
permissions
. Żądania użytkowników, którzy mają dostęp tylko do tych plików udostępnionych za pomocą linku z uprawnieniem type=domain
lub type=anyone
, mogą wymagać klucza zasobu.
Więcej informacji na temat uprawnień znajdziesz w artykule Udostępnianie plików, folderów i dysków. Pełną listę ról i operacji, na które zezwala każda z nich, znajdziesz w artykule Role i uprawnienia.
Odczytaj klucz zasobu z pliku
Interfejs Drive API zwraca klucz zasobu pliku w polu resourceKey
tylko do odczytu zasobu files
.
Jeśli plik to skrót do Dysku, klucz zasobu miejsca docelowego skrótu jest zwracany w polu shortcutDetails.targetResourceKey
tylko do odczytu.
Pola w zasobie files
, które zwracają adresy URL, np. exportLinks
, webContentLink
i webViewLink
, zawierają też resourceKey
. Klienty, które integrują się z interfejsem Dysku, mogą też używać funkcji resourceKeys
w parametrze state
. Więcej informacji znajdziesz w artykule Pobieranie i eksportowanie plików.
Ustaw klucz zasobu dla żądania
Klucze zasobów dla wszystkich plików, do których odwołują się żądania wysyłane do interfejsu Drive API, są ustawione w nagłówku HTTP X-Goog-Drive-Resource-Keys
.
Żądania do interfejsu Drive API mogą określać co najmniej 1 klucz zasobów w nagłówku HTTP X-Goog-Drive-Resource-Keys
.
Składnia
Identyfikator pliku i para kluczy zasobu są ustawiane w nagłówku za pomocą separatora ukośnika (/
). Nagłówek tworzy się, łącząc wszystkie pary identyfikatora pliku i kluczy zasobów za pomocą separatorów przecinków (,
).
Rozważ na przykład prośbę o przeniesienie pliku fileId1
z folderu fileId2
do folderu fileId3
. Załóżmy, że klucze zasobów tych 3 plików to odpowiednio resourceKey1
, resourceKey2
i resourceKey3
. Nagłówek utworzony na podstawie tych wartości z użyciem ukośnika i separatora przecinka:
X-Goog-Drive-Resource-Keys: fileId1/resourceKey1,fileId2/resourceKey2,fileId3/resourceKey3
Powiązane artykuły
- Udostępnianie plików, folderów i dysków
- Pobieranie i eksportowanie plików
- Ochrona zawartości pliku
- Konfigurowanie integracji z interfejsem Dysku