Jeśli używasz interfejsu Google Drive API w wersji 2, większość treści w wersji 3 przewodnika po interfejsie Google Drive API dotyczy również wersji 2. Ta sekcja zawiera wszystkie informacje dotyczące wersji 2, które różnią się od tych podanych na odpowiednich stronach przewodnika po wersji 3. Aby uzyskać pełny kontekst, każda sekcja zawiera link do odpowiedniej strony przewodnika.
Pełną listę różnic znajdziesz w dokumentacji poświęconej porównaniu interfejsu Drive API w wersji 2 i 3.
Pobieranie i publikowanie wersji plików
Na stronie Pobieranie i publikowanie wersji plików informacje podane poniżej dotyczą wersji 2 i zastępują te sekcje, które są widoczne w wersji 3:
Wyświetlanie i pobieranie poszczególnych wersji
Po otrzymaniu listy wersji pliku możesz pobrać zawartość dowolnej wersji, wysyłając autoryzowany GET
do jego właściwości []downloadUrl
](/drive/api/reference/rest/v2/revisions).
Dysk Google generuje ten krótkotrwały adres URL, gdy poprosisz o wersję.
Nie należy polegać na tym, że dane będą dostępne później.
Możesz też wyeksportować wersję w jednym z obsługiwanych formatów, zaznaczając właściwość exportLinks
.
Właściwości niestandardowe pliku
Oprócz informacji na stronie Dodawanie niestandardowych właściwości pliku te informacje są specyficzne dla wersji 2:
Do właściwości można uzyskać dostęp za pomocą zasobu properties
.
Oto struktura typowej właściwości, która może być używana do przechowywania identyfikatora bazy danych pliku Dysku w pliku.
{
'key': 'additionalID',
'value': 'ID',
'visibility': 'PRIVATE'
}
Więcej informacji o limitach znajdziesz w dokumentacji referencyjnej (properties
).
Włączanie obsługi dysków współdzielonych
Oprócz informacji na stronie Wdrażanie obsługi udostępnionego dysku w wersji 2 zastąp to dodatkowe pole trashedDate
.
W wdrożeniu obsługi dysków współdzielonych te metody wymagają supportsAllDrives=true
podczas pracy z treściami na dyskach współdzielonych:
files.get
files.list
files.insert
files.update
files.patch
files.copy
files.trash
files.untrash
files.delete
files.touch
children.insert
parents.insert
changes.list
changes.getStartPageToken
changes.get
permissions.list
permissions.get
permissions.insert
permissions.update
permissions.patch
permissions.delete
Metody changes.get
i changes.list
mają kilka parametrów specyficznych dla dysków współdzielonych. Listę parametrów znajdziesz w sekcji Śledzenie zmian na dysku współdzielonym.
Prześlij pliki
Na stronie Prześlij dane pliku zwróć uwagę, że te informacje dotyczą wersji 2:
Importowanie do Dokumentów Google
Podczas tworzenia pliku na Dysku Google możesz przekonwertować niektóre typy plików na dokumenty Dokumentów, Arkuszy lub Prezentacji Google. Uwzględnij parametry zapytania files.insert
convert
i ustaw właściwość pliku (workspace_name) mimeType
. Więcej informacji znajdziesz w artykule Przesyłanie danych w pliku.
Udostępnianie plików, folderów i dysków
Uwaga na stronie Udostępnianie plików, folderów i dysków w wersji 3 tylko jedno pole (role
) określa skuteczne role użytkownika, grupy lub domeny. W wersji 2 pola role
i additionalRoles
uprawnienia muszą odzwierciedlać skuteczne role użytkownika, grupy lub domeny w przypadku danego elementu.
Różnice w zapytaniach wyszukiwania w wersji 2
W wersji 3 pole title
w wersji 2 to name
. Przykłady znajdziesz w sekcji Wyszukiwanie plików i folderów.
W wersji 3 pole createdDate
w wersji 2 to createdTime
. Przykłady znajdziesz w artykule Wyszukiwanie dysków współdzielonych.
W wersji 3 pole modifiedDate
w wersji 2 to modifiedTime
. W wersji 3 pole lastViewedByMeDate
w wersji 2 to pole viewedByMeTime
. Więcej informacji znajdziesz w artykule Terminy i operatory wyszukiwania.