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 przekazywany użytkownikom, aby mogli uzyskać dostęp do określonych plików udostępnionych za pomocą linku. Użytkownicy, którzy wcześniej nie wyświetlali pliku, muszą podać klucz zasobu, aby uzyskać do niego 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 za pomocą linku może być znaleziony tylko przez użytkowników, którzy mają dostęp do pliku na podstawie 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 o uprawnieniach znajdziesz w artykule Udostępnianie plików, folderów i dysków. Pełną listę ról i dozwolonych przez nie operacji znajdziesz w sekcji 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, takie jak exportLinks, webContentLink i webViewLink, zawierają też pole 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 w żądaniu.

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 ustawiana jest para identyfikator pliku i klucz zasobu za pomocą separatora ukośnika (/). Nagłówek jest tworzony przez połączenie wszystkich par identyfikatorów plików i kluczy zasobów za pomocą przecinków (,).

Rozważmy 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