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, który jest 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 niedawno 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 może zostać znaleziony tylko przez użytkowników, którzy mają do niego dostęp dzięki zasobowi type=user lub type=group permissions. Żądania od użytkowników, którzy mają dostęp do tych plików udostępnionych za pomocą linku tylko dzięki uprawnieniu 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 w każdej 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 na Dysku, klucz zasobu elementu docelowego skrótu jest zwracany w polu przeznaczonym tylko do odczytushortcutDetails.targetResourceKey.

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

Ustawianie klucza zasobu w żądaniu

Klucze zasobów wszystkich plików, do których odwołują się żądania 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 w nagłówku HTTP X-Goog-Drive-Resource-Keys.

Składnia

Para identyfikatora pliku i klucza zasobu jest ustawiana w nagłówku za pomocą ukośnika (/) jako separatora. Nagłówek jest tworzony przez połączenie wszystkich par identyfikatora pliku i klucza zasobu za pomocą przecinka (,) jako separatora.

Rozważmy na przykład żą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 z tych wartości za pomocą ukośnika i przecinka jako separatorów wygląda tak:

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