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ą: Interfejs Dysku lub Google Drive API. Gdy udostępniasz treści z: na Dysku, możesz określić, czy użytkownicy mogą edytować, komentować otworzyć tylko plik.

Klucz zasobu pomaga chronić plik przed niezamierzonym dostępem. Klucze zasobów to dodatkowy parametr 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 musi podać klucz zasobu, aby uzyskać dostęp. Osoby, które ostatnio oglądały lub mają bezpośredni dostęp, nie potrzebują klucza zasobu, aby uzyskać dostęp do pliku.

Plik z Dysku udostępniony przy użyciu linku może znaleźć tylko użytkownicy, którzy mają dostęp do pliku dzięki funkcji type=user lub type=group permissions. Prośby od użytkowników które mają dostęp do tych plików udostępnionych przez link tylko za pomocą elementu type=domain lub Uprawnienie type=anyone może 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 dozwolonych przez poszczególne kategorie. Patrz sekcja Role i .

Odczytaj klucz zasobu z pliku

Drive API zwraca klucz zasobu w pliku w trybie tylko do odczytu Pole resourceKey zasobu files.

Jeśli plik jest skrótem do Dysku, klawisz zasobu do miejsca docelowego skrótu jest zwracany na shortcutDetails.targetResourceKey.

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

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 wysyłane do interfejsu Drive API mogą określać jeden lub więcej kluczy zasobów za pomocą funkcji nagłówek HTTP X-Goog-Drive-Resource-Keys.

Składnia

Identyfikator pliku i para kluczy zasobu są ustawiane w nagłówku za pomocą ukośnika (/). Nagłówek powstaje przez połączenie wszystkich identyfikatorów pliku i zasobów pary kluczy z separatorami przecinków (,).

Możesz na przykład wysłać prośbę o przeniesienie pliku fileId1 z folderu fileId2 do folder fileId3. Załóżmy, że klucze zasobów tych 3 plików są resourceKey1, resourceKey2 i resourceKey3. W nagłówku utworzone na podstawie tych wartości za pomocą ukośnika i separatora przecinka wygląda tak:

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