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

Możesz udostępniać pliki i foldery z Dysku Google innym osobom za pomocą interfejsu Dysku Google lub interfejsu Google Drive API. Gdy udostępniasz pliki z Dysku, możesz określić, czy użytkownicy będą mogli edytować, komentować czy tylko otwierać plik.

Klucz zasobu pomaga chronić plik przed nieuprawnionym dostępem. Klucze zasobów to dodatkowy parametr, który jest przekazywany, aby użytkownicy mieli dostęp do określonych plików, które zostały udostępnione przy użyciu linku. Użytkownicy, którzy wcześniej nie wyświetlali 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 z Dysku udostępniony za pomocą linku jest widoczny tylko dla użytkowników, którzy mają do niego dostęp dzięki zasóbowi type=user lub type=group permissions. Prośby od użytkowników, którzy mają dostęp do tych plików udostępnionych za pomocą linku tylko za pomocą uprawnień type=domain lub type=anyone, mogą wymagać klucza zasobu.

Więcej informacji o uprawnieniach znajdziesz w artykule Udostępnianie plików, folderów i dysków. Pełną listę ról i operacji dozwolonych przez każdą z nich znajdziesz w sekcji Role i uprawnienia.

Odczyt klucza zasobu z pliku

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

Jeśli plik jest skrótem 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ż parametr resourceKey. Klienty, które integrują się z interfejsem Dysku, mogą też używać elementu resourceKeys w parametrze state. Więcej informacji znajdziesz w artykule o pobieraniu i eksportowaniu plików.

Ustawienie klucza zasobu dla żądania

Klucze zasobów 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 wysyłane do interfejsu Drive API mogą określać co najmniej 1 klucz zasobów z nagłówkiem 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 klucza zasobu przy użyciu separatorów przecinków (,).

Na przykład rozważ żądanie przeniesienia 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 przy użyciu ukośnika prawego i separatora przecinków wygląda tak:

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