Interfejs Google Drive API obsługuje kilka typów czynności pobierania i eksportowania wymienionych w tej tabeli:
Pobieranie |
|
|||
Eksporty |
|
Zanim pobierzesz lub wyeksportujesz zawartość pliku, sprawdź, czy użytkownicy mogą go pobrać, korzystając z pola capabilities.canDownload
w zasobie files
.
W pozostałej części tego przewodnika znajdziesz szczegółowe instrukcje wykonywania tego typu działań związanych z pobieraniem i eksportowaniem.
Pobierz zawartość pliku bloba
Aby pobrać plik blob zapisany na Dysku, użyj metody files.get
z identyfikatorem pliku do pobrania i parametrem URL alt=media
. Parametr adresu URL alt=media
informuje serwer, że w ramach alternatywnego formatu odpowiedzi zażądano pobrania treści.
Parametr adresu URL alt=media
jest parametrem systemowym dostępnym we wszystkich interfejsach API Google typu REST. Jeśli na potrzeby interfejsu Drive API używasz biblioteki klienta, nie musisz konfigurować tego parametru.
Poniższy przykładowy kod pokazuje, jak użyć metody files.get
do pobrania pliku z bibliotekami klienta interfejsu Drive API.
Java
Python
Node.js
PHP
.NET
W tym przykładowym kodzie używana jest metoda biblioteki, która dodaje do bazowego żądania HTTP parametr adresu URL alt=media
.
Pobieranie plików rozpoczęte z poziomu aplikacji musi być autoryzowane za pomocą zakresu umożliwiającego odczyt zawartości pliku. Na przykład aplikacja korzystająca z zakresu drive.readonly.metadata
nie jest autoryzowana do pobierania zawartości pliku.
W tym przykładowym kodzie używany jest ograniczony zakres plików „drive”, który umożliwia użytkownikom wyświetlanie wszystkich Twoich plików na Dysku i zarządzanie nimi. Więcej informacji o zakresach interfejsu Dysku znajdziesz w artykule Wybieranie zakresów interfejsu API Dysku Google.
Użytkownicy z uprawnieniami do edycji mogą ograniczyć pobieranie przez użytkowników z dostępem tylko do odczytu, ustawiając w polu copyRequiresWriterPermission
wartość false
.
Pliki zidentyfikowane jako nieodpowiednie (np. szkodliwe oprogramowanie) mogą pobrać tylko ich właściciele.
Dodatkowo trzeba uwzględnić parametr zapytania acknowledgeAbuse=true
get
, aby wskazać, że użytkownik zaakceptował ryzyko pobrania potencjalnie niechcianego oprogramowania lub innych plików naruszających zasady. Aplikacja powinna interaktywnie ostrzegać użytkownika przed użyciem tego parametru zapytania.
Pobieranie częściowe
Częściowe pobieranie obejmuje tylko określoną część pliku. Możesz określić część pliku, którą chcesz pobrać, używając zakresu bajtów z nagłówkiem Range
. Na przykład:
Range: bytes=500-999
Pobieranie treści pliku bloba we wcześniejszej wersji
Aby pobrać zawartość plików blob w starszej wersji, użyj metody revisions.get
z identyfikatorem pliku do pobrania, identyfikatorem wersji i parametrem adresu URL alt=media
.
Parametr adresu URL alt=media
informuje serwer, że w ramach alternatywnego formatu odpowiedzi zażądano pobrania treści. Podobnie jak files.get
metoda revisions.get
akceptuje też opcjonalny parametr zapytania acknowledgeAbuse
i nagłówek Range
. Więcej informacji o pobieraniu wersji znajdziesz w artykule Pobieranie i publikowanie wersji plików.
Pobieranie zawartości pliku bloba w przeglądarce
Aby pobrać zawartość plików blob przechowywanych na Dysku w przeglądarce, zamiast przez interfejs API, użyj pola webContentLink
zasobu files
. Jeśli użytkownik ma uprawnienia do pobierania pliku, zwracany jest link umożliwiający pobranie pliku wraz z jego zawartością. Możesz przekierować użytkownika na ten adres URL lub zaoferować go jako link, który można kliknąć.
Eksportowanie treści dokumentów z Google Workspace
Aby wyeksportować zawartość bajtową dokumentu z Google Workspace, użyj metody files.export
z identyfikatorem wyeksportowanego pliku i prawidłowym typem MIME. Wyeksportowana treść może mieć maksymalnie 10 MB.
Poniższy przykładowy kod pokazuje, jak użyć metody files.export
do wyeksportowania dokumentu Google Workspace w formacie PDF przy użyciu bibliotek klienckich interfejsu Drive API:
Java
Python
Node.js
PHP
.NET
W tym przykładowym kodzie używany jest ograniczony zakres drive
, który umożliwia użytkownikom wyświetlanie wszystkich Twoich plików na Dysku i zarządzanie nimi. Więcej informacji o zakresach interfejsu Dysku znajdziesz w artykule Wybieranie zakresów interfejsu API Dysku Google.
Przykładowy kod deklaruje też ustawiony typ MIME eksportu jako application/pdf
. Pełną listę wszystkich eksportowanych typów MIME obsługiwanych w przypadku poszczególnych dokumentów Google Workspace znajdziesz w artykule Eksportowanie typów MIME dokumentów Google Workspace.
Eksportowanie treści dokumentów z Google Workspace w przeglądarce
Aby wyeksportować zawartość dokumentu Google Workspace w przeglądarce, użyj pola exportLinks
zasobu files
. W zależności od typu dokumentu dla każdego dostępnego typu MIME zwracany jest link do pobrania pliku i jego zawartość. Możesz przekierować użytkownika na adres URL lub zaoferować go jako link, który można kliknąć.
Eksportowanie treści dokumentów z Google Workspace we wcześniejszej wersji w przeglądarce
Aby wyeksportować w przeglądarce zawartość dokumentu Google Workspace we wcześniejszej wersji, użyj metody revisions.get
z identyfikatorem pliku do pobrania i identyfikatorem wersji. Jeśli użytkownik ma uprawnienia do pobierania pliku, zwracany jest link umożliwiający pobranie pliku wraz z jego zawartością. Możesz przekierować użytkownika na ten adres URL lub zaoferować go jako link, który można kliknąć.