Przewodnik po interfejsie API Dysku w wersji 2

Jeśli używasz Google Drive API w wersji 2, większość treści w przewodniku po Google Drive API w wersji 3 dotyczy też wersji 2. Ta sekcja zawiera wszystkie informacje dotyczące tylko 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 znajdziesz link do odpowiedniej strony przewodnika.

Pełną listę różnic znajdziesz w porównaniu interfejsów Drive API w wersji 2 i 3 referencyjnym.

Pobieranie i publikowanie wersji plików

Na stronie Pobieranie i publikowanie wersji plików te informacje dotyczą tylko wersji 2 i zastępują te sekcje w wersji 3:

Wyświetlanie i pobieranie poszczególnych wersji

Gdy uzyskasz listę wersji pliku, możesz pobrać zawartość dowolnej wersji, wysyłając autoryzowane żądanie GET do jej 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 przyszłości.

Możesz też wyeksportować wersję w jednym z obsługiwanych formatów, sprawdzają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ą tylko wersji 2:

Dostęp do właściwości uzyskuje się za pomocą zasobu properties.

Oto struktura typowej właściwości, która może służyć do przechowywania identyfikatora bazy danych pliku na Dysku Google.

{
  'key':        'additionalID',
  'value':      'ID',
  'visibility': 'PRIVATE'
}

Więcej informacji o limitach znajdziesz w properties w dokumentacji.

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 Implementowanie obsługi dysków współdzielonych te metody wymagają supportsAllDrives=true podczas pracy z treścią dysków 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.

Przesyłanie plików

Na stronie Przesyłanie danych pliku zwróć uwagę, że te informacje dotyczą tylko wersji 2:

Importowanie do typów Dokumentów Google

Gdy tworzysz plik na Dysku Google, możesz przekonwertować niektóre typy plików na dokumenty Dokumentów, Arkuszy lub Prezentacji Google. Dodaj parametry zapytania files.insert convert i ustaw właściwość mimeType pliku (workspace_name). Więcej informacji znajdziesz w sekcji Przesyłanie danych pliku data.

Udostępnianie plików, folderów i dysków

Na stronie Udostępnianie plików, folderów i dysków zwróć uwagę, że w wersji 3 tylko 1 pole, role, określa skuteczne role użytkownika, grupy, lub domeny. W wersji 2 musisz mieć zarówno pola role, jak i additionalRoles uprawnień, aby odzwierciedlały skuteczne 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 sekcji Wyszukiwanie plików i folderów.

Pole createdDate w wersji 2 to createdTime w wersji 3. Przykłady znajdziesz w sekcji Wyszukiwanie dysków współdzielonych.

Pole modifiedDate w wersji 2 to modifiedTime w wersji 3. Pole lastViewedByMeDate w wersji 2 to viewedByMeTime w wersji 3. Więcej informacji znajdziesz w sekcji Operatory i terminy wyszukiwania.