Uzyskiwanie dostępu do plików na Dysku udostępnionych przez link za pomocą kluczy zasobów

Pliki i foldery na Dysku Google możesz udostępniać innym osobom za pomocą interfejsu Dysku lub interfejsu Google Drive API. Gdy udostępniasz pliki z Dysku, możesz zdecydować, czy użytkownicy będą mogli edytować, komentować czy tylko wyświetlać dany plik.

Klucz zasobu pomaga chronić plik przed nieupoważnionym dostępem. Klucze zasobów to dodatkowy parametr, który jest przekazywany, aby umożliwić użytkownikom dostęp 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.

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. Prośby od użytkowników, którzy mają dostęp tylko do plików udostępnionych za pomocą linku przy użyciu uprawnień 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.

Odczytywanie klucza zasobu z pliku

Interfejs Drive API zwraca klucz zasobu pliku w polu tylko do odczytu resourceKey zasobu files.

Jeśli plik jest skrótem z Dysku, w polu tylko do odczytu shortcutDetails.targetResourceKey zwracany jest klucz zasobu docelowego skrótu.

Pola w zasobie files, które zwracają adresy URL, np. exportLinks, webContentLink i webViewLink, zawierają też resourceKey. Klienci, którzy integrują się z interfejsem Dysku, mogą też używać parametru resourceKeys w parametrze state. Więcej informacji znajdziesz w artykule Pobieranie i eksportowanie plików.

Ustaw klucz zasobu dla żądania

Klucze zasobów wszystkich plików, do których odwołują się żądania interfejsu Drive API, są ustawiane w nagłówku HTTP X-Goog-Drive-Resource-Keys.

Żądania wysyłane do interfejsu Drive API mogą zawierać co najmniej 1 klucz zasobu w nagłówku HTTP X-Goog-Drive-Resource-Keys.

Składnia

W nagłówku parę identyfikatora pliku i klucza zasobu ustawia się 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 z tych wartości za pomocą ukośników i przecinków:

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