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 inne niż informacje widoczne na konkretnych stronach przewodnika do wersji 3. Aby uzyskać pełny kontekst, każda podsekcja zawiera link do odpowiedniej strony przewodnika.

Pełną listę różnic znajdziesz w dokumentacji porównawczej interfejsów Drive API w wersjach 2 i 3.

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 widoczne dla wersji 3:

Wyświetlanie i pobieranie pojedynczych 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). Gdy poprosisz o sprawdzenie, Dysk Google wygeneruje ten tymczasowy URL. Nie korzystaj z niej 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

Poza informacjami na stronie Dodaj niestandardowe właściwości pliku te informacje dotyczą wersji 2:

Dostęp do usług uzyskuje się 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 sekcji properties w dokumentacji referencyjnej.

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

Informacje podane na stronie Wdróż obsługę dysków współdzielonych zastąp to dodatkowe pole trashedDate dla wersji 2.

W sekcji Zaimplementuj obsługę 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 charakterystycznych dla dysków współdzielonych. Listę parametrów znajdziesz w sekcji Śledzenie zmian na dysku współdzielonym.

Prześlij pliki

Zwróć uwagę, że na stronie Prześlij dane pliku te informacje dotyczą 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, Arkusze Google lub Prezentacje Google. Dołącz files.insert convert parametry zapytania i ustaw właściwość (workspace_name) mimeType pliku. 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 której w wersji 3 jest tylko jedno pole role, określa efektywne role dla użytkownika, grupy lub domeny. W wersji 2 zarówno pola role, jak i additionalRoles uprawnienia odzwierciedlają efektywne role, jakie użytkownik, grupa lub domena mają w przypadku danego elementu.

Różnice w wyszukiwanych hasłach w wersji 2

Pole title wersji 2 ma w wersji 3 wartość name. Przykłady znajdziesz w sekcji Wyszukiwanie plików i folderów artykułu Korzystanie z Gmaila z użyciem czytnika ekranu.

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

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