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 pliku 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.getfiles.listfiles.insertfiles.updatefiles.patchfiles.copyfiles.trashfiles.untrashfiles.deletefiles.touchchildren.insertparents.insertchanges.listchanges.getStartPageTokenchanges.getpermissions.listpermissions.getpermissions.insertpermissions.updatepermissions.patchpermissions.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ę na te informacje, które 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.0 musisz mieć pola role i additionalRoles uprawnień, aby odzwierciedlały one 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 Wyszukiwane hasła i operatory.