Jeśli używasz interfejsu Google Drive API w wersji 2, większość treści w przewodniku po interfejsie Google Drive API w wersji 3 dotyczy też wersji 2. Ta sekcja zawiera wszystkie informacje dotyczące wersji 2, które różnią się od tych podanych na poszczególnych stronach przewodnika po wersji 3. Aby uzyskać pełny kontekst, w każdej podsekcji znajduje się link do odpowiedniej strony przewodnika.
Pełną listę różnic znajdziesz w tym artykule.
Pobieranie i publikowanie wersji plików
Na stronie Pobieranie i publikowanie wersji plików poniższe informacje dotyczą wersji 2 i zastępują te sekcje wyświetlane w przypadku wersji 3:
Wyświetlanie i pobieranie poszczególnych wersji
Po uzyskaniu listy wersji pliku możesz pobrać zawartość dowolnej wersji, wysyłając autoryzowane żądanie GET do właściwości downloadUrl](/workspace/drive/api/reference/rest/v2/revisions).
Dysk Google generuje ten krótkotrwały adres URL, gdy poprosisz o wersję.
Nie polegaj na nim w późniejszym czasie.
Możesz też wyeksportować wersję w jednym z obsługiwanych formatów, zaznaczając właściwość
exportLinks.
Niestandardowe właściwości pliku
Oprócz informacji na stronie Dodawanie niestandardowych właściwości pliku te informacje dotyczą wersji 2:
Dostęp do właściwości uzyskuje się za pomocą zasobu properties.
To struktura typowej właściwości, która może służyć do przechowywania identyfikatora bazy danych pliku na Dysku.
{
'key': 'additionalID',
'value': 'ID',
'visibility': 'PRIVATE'
}
Więcej informacji o limitach znajdziesz w opisie properties w dokumentacji referencyjnej.
Włączanie obsługi dysków współdzielonych
Oprócz informacji na stronie Implementowanie obsługi dysków współdzielonych zastąp to dodatkowe pole
trashedDate w wersji 2.
W sekcji Implement shared drive support (Wdrażanie 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:
Typy importowania do Dokumentów Google
Gdy utworzysz plik na Dysku Google, możesz przekonwertować niektóre typy plików na dokumenty w Dokumentach, Arkuszach lub Prezentacjach Google. Podaj files.insert convert parametry zapytania i ustaw właściwość (workspace_name) mimeType pliku. Więcej informacji znajdziesz w artykule Przesyłanie danych z pliku.
Udostępnianie plików, folderów i dysków
Na stronie Udostępnianie plików, folderów i dysków w wersji 3 tylko jedno pole, role, określa obowiązujące role użytkownika, grupy lub domeny. W wersji 2 pola role i additionalRoles uprawnień muszą odzwierciedlać rzeczywiste role, jakie użytkownik, grupa lub domena mają w przypadku danego elementu.
Różnice w zapytaniach w wersji 2
Pole title w wersji 2 to name w wersji 3. Przykłady znajdziesz w artykule Wyszukiwanie plików i folderów.
Pole createdDate w wersji 2 to createdTime w wersji 3. Przykłady znajdziesz w artykule Wyszukiwanie dysków współdzielonych.
Pole modifiedDate w wersji 2 to modifiedTime w wersji 3. Pole lastViewedByMeDate w wersji 2 jest w wersji 3 polem viewedByMeTime. Więcej informacji znajdziesz w artykule Terminy i operatory zapytań.