Interfejs Google Drive API obsługuje kilka rodzajów działań związanych z pobieraniem i eksportowaniem: podane w tej tabeli:
Pobieranie |
|
|||
Eksporty |
|
Zanim pobierzesz lub wyeksportujesz zawartość pliku, sprawdź, czy użytkownicy mogą pobrać
za pomocą pola capabilities.canDownload
na stronie
files
.
W dalszej części tego przewodnika znajdziesz szczegółowe instrukcje wykonywania tych czynności pobierania i eksportowania danych.
Pobierz zawartość pliku blob
Aby pobrać plik blob zapisany na Dysku, użyj metody files.get
z identyfikatorem pobieranego pliku
i parametru adresu URL alt=media
. Parametr adresu URL alt=media
informuje
żądania pobrania treści jako odpowiedzi alternatywnej.
.
Parametr adresu URL alt=media
to system
we wszystkich interfejsach API typu REST Google. Jeśli używasz biblioteki klienta do
Drive API, nie musisz ustawiać tego parametru bezpośrednio.
Poniższy przykładowy kod pokazuje, jak za pomocą metody files.get
pobrać
za pomocą bibliotek klienta interfejsu Drive API.
Java
Python
Node.js
PHP
.NET
Ten przykładowy kod korzysta z metody biblioteki, która dodaje parametr adresu URL alt=media
do bazowego żądania HTTP.
Pobieranie plików rozpoczęte z Twojej aplikacji musi być autoryzowane za pomocą zakresu, który zezwala
uprawnienia do odczytu treści pliku. Na przykład aplikacja, która używa
Zakres drive.readonly.metadata
nie ma uprawnień do pobrania zawartości pliku.
Ten przykładowy kod korzysta z ograniczonego zakresu plików „drive”, który umożliwia użytkownikom
wyświetlać wszystkie pliki na Dysku i nimi zarządzać. Aby dowiedzieć się więcej o:
Zakresy Dysku – zapoznaj się z artykułem Choose Google Drive API (Wybierz interfejs Google Drive API)
.
Użytkownicy z uprawnieniami do edycji mogą ograniczyć pobieranie przez użytkowników z uprawnieniami tylko do odczytu przez
Ustawianie copyRequiresWriterPermission
do false
.
Pliki zidentyfikowane jako
nieodpowiednie
(takich jak szkodliwe oprogramowanie) może pobrać tylko właściciel pliku.
Należy też uwzględnić parametr zapytania acknowledgeAbuse=true
typu get
aby wskazać, że użytkownik wyraził zgodę na ryzyko pobierania
niechciane oprogramowanie i inne pliki naruszające zasady. Aplikacja powinna interaktywnie
ostrzegać użytkownika przed użyciem tego parametru zapytania.
Pobieranie częściowe
Częściowe pobieranie obejmuje pobranie tylko określonego fragmentu pliku. Ty
możesz określić fragment pliku do pobrania, używając w formacie bajtowym
zakres
z nagłówkiem Range
. Na przykład:
Range: bytes=500-999
Pobierz zawartość pliku blob we wcześniejszej wersji
Aby pobrać zawartość plików blob we wcześniejszej wersji, użyj
revisions.get
o identyfikatorze
wybrać plik do pobrania, identyfikator wersji oraz parametr alt=media
adresu URL.
Parametr adresu URL alt=media
informuje serwer, że pobieranie treści jest
jako alternatywny format odpowiedzi. Podobnie jak w przypadku files.get
, atrybut
Metoda revisions.get
akceptuje również opcjonalny parametr zapytania
acknowledgeAbuse
i nagłówek Range
. Więcej informacji na temat pobierania
Więcej informacji można znaleźć w sekcji Pobieranie i publikowanie pliku
wersji.
Pobierz zawartość pliku blob w przeglądarce
Aby pobrać zawartość plików blob przechowywanych na Dysku w
w przeglądarce, zamiast przez interfejs API użyj
webContentLink
parametru
files
zasób. Jeśli użytkownik pobrał aplikację
dostęp do pliku, link do pobrania pliku i jego zawartości
. Można przekierować użytkownika do tego adresu URL lub zaoferować go jako klikalny
.
Eksportowanie treści dokumentów Google Workspace
Aby wyeksportować zawartość bajtów dokumentu z Google Workspace, użyj metody files.export
z identyfikatorem pliku do wyeksportowania
i poprawny typ MIME. Wyeksportowano
jego rozmiar jest ograniczony do 10 MB.
Poniższy przykładowy kod pokazuje, jak za pomocą metody files.export
wyeksportować
dokument Google Workspace w formacie PDF za pomocą klienta Drive API,
biblioteki:
Java
Python
Node.js
PHP
.NET
Ten przykładowy kod korzysta z ograniczonego zakresu drive
, który umożliwia użytkownikom wyświetlanie
zarządzać wszystkimi plikami na Dysku. Aby dowiedzieć się więcej o:
Zakresy Dysku – zapoznaj się z artykułem Choose Google Drive API (Wybierz interfejs Google Drive API)
.
W przykładowym kodzie deklarowano także typ eksportu MIME jako application/pdf
. Dla
pełna lista wszystkich eksportowanych typów MIME obsługiwanych w poszczególnych wersjach Google Workspace.
więcej informacji znajdziesz w artykule Eksportowanie typów MIME w Google Workspace
dokumenty.
Eksportowanie treści dokumentów Google Workspace w przeglądarce
Aby wyeksportować treść dokumentu Google Workspace w przeglądarce, skorzystaj z
exportLinks
parametru
files
zasób. W zależności od dokumentu
dla każdego formatu MIME zwracany jest link do pobrania pliku, a jego zawartość jest zwracana
typ dostępny. Można przekierować użytkownika do adresu URL lub zaoferować go jako
klikalny link.
Eksportowanie treści dokumentów Google Workspace we wcześniejszej wersji w przeglądarce
Aby wyeksportować treść dokumentu Google Workspace we wcześniejszej wersji w
przeglądarki, użyj metody revisions.get
identyfikator pliku do pobrania i identyfikator wersji. Jeśli użytkownik ma
dostęp do pliku, link do pobrania pliku i jego zawartości
. Można przekierować użytkownika do tego adresu URL lub zaoferować go jako klikalny
.