Przewodnik po interfejsie API Dysku w wersji 2

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 roleadditionalRoles 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.