Przewodnik po interfejsie API Dysku w wersji 2

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 również wersji 2. Ta sekcja zawiera wszystkie informacje dotyczące wersji 2 i różnią się od tych przedstawionych na poszczególnych stronach przewodnika po wersji 3. Aby poznać pełny kontekst, każda podsekcja zawiera link do odpowiedniej strony z przewodnikiem.

Pełną listę różnic znajdziesz w dokumentacji interfejsu Drive API v2 i 3.

Pobieranie i publikowanie wersji plików

Na stronie Pobieranie i publikowanie wersji plików podane są poniższe informacje dotyczące wersji 2, które zastępują te sekcje dotyczące wersji 3:

Wyświetlanie i pobieranie poszczególnych wersji

Gdy otrzymasz listę wersji pliku, możesz pobrać treść dowolnej wersji, wysyłając autoryzowane żądanie GET do właściwości []downloadUrl](/drive/api/reference/rest/v2/revisions). Dysk Google generuje ten krótkotrwały URL po zgłoszeniu prośby o weryfikację. Nie należy używać tej funkcji 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 Dodaj niestandardowe właściwości pliku w wersji 2 dotyczą też następujące informacje:

Dostęp do usług jest możliwy przez zasób properties.

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

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

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

Włącz obsługę dysku współdzielonego

Oprócz informacji na stronie Implementacja pomocy dotyczącej dysku współdzielonego zastąp to dodatkowe pole trashedDate dla wersji 2.

W sekcji Wdrażanie obsługi dysków współdzielonych poniższe metody wymagają ustawienia supportsAllDrives=true w przypadku 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ę na te informacje dotyczące wersji 2:

Importowanie do Dokumentów Google

Podczas tworzenia pliku na Dysku Google możesz przekonwertować niektóre typy plików na format Dokumentów, Arkuszy lub Prezentacji Google. Dodaj parametry zapytania files.insert convert i ustaw w pliku właściwość mimeType (workspace_name) Więcej informacji znajdziesz w artykule Przesyłanie danych 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 w jednym polu (role) określono efektywne role użytkownika, grupy lub domeny. W wersji 2 wymagane jest, aby zarówno pole role, jak i additionalRoles odzwierciedlały efektywne role użytkownika, grupy lub domeny w przypadku danego elementu.

Różnice wyszukiwanych haseł w wersji 2

Pole title w wersji 2 zawiera wartość name w wersji 3. Przykłady znajdziesz w artykule Wyszukiwanie plików i folderów.

Pole createdDate w wersji 2 zawiera wartość createdTime w wersji 3. Przykłady znajdziesz w artykule Wyszukiwanie dysków współdzielonych.

Pole modifiedDate w wersji 2 zawiera wartość modifiedTime w wersji 3. Pole lastViewedByMeDate w wersji 2 zawiera wartość viewedByMeTime w wersji 3. Więcej informacji znajdziesz w artykule Wyszukiwane hasła i operatory.