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

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