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 otwierać dany plik.

Klucz zasobu pomaga chronić plik przed nieupoważnionym dostępem. Klucze zasobów to dodatkowy parametr przekazywany, aby użytkownicy mogli uzyskać dostęp do niektórych plików udostępnionych za pomocą 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ć dostęp do pliku.

Plik na Dysku udostępniony za pomocą linku mogą znaleźć tylko użytkownicy, którzy mają do niego dostęp w wyniku zasobu type=user lub type=group permissions. Prośby użytkowników, którzy mają dostęp do tych plików udostępnionych za pomocą linku tylko z uprawnieniami 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, które każda z nich umożliwia, znajdziesz w sekcji 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 jest skrótem na Dysku, klucz zasobu dla elementu 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. Klienci zintegrowani z interfejsem Dysku mogą też używać resourceKeys w parametrze state. Więcej informacji znajdziesz w artykule Pobieranie i eksportowanie plików.

Ustaw klucz zasobu w żądaniu

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

Żądania do interfejsu Drive API mogą określać co najmniej 1 klucz zasobu za pomocą nagłówka HTTP X-Goog-Drive-Resource-Keys.

Składnia

Para identyfikatora pliku i klucza zasobu jest ustawiana w nagłówku za pomocą ukośnika (/). Nagłówek jest tworzony przez połączenie wszystkich par identyfikatorów plików i kluczy zasobów za pomocą separatorów w postaci przecinków (,).

Rozważmy na przykład żądanie przeniesienia pliku fileId1 z folderu fileId2 do folderu fileId3. Załóżmy, że klucze zasobów dla tych 3 plików to odpowiednio resourceKey1, resourceKey2 i resourceKey3. Nagłówek utworzony na podstawie tych wartości z użyciem ukośnika i przecinków jako separatorów to:

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