Wdrażanie obsługi dysków współdzielonych

Dyski współdzielone mają inną organizację, model udostępniania i model własności niż Mój dysk. Jeśli Twoja aplikacja ma tworzyć pliki na dyskach współdzielonych i nimi zarządzać, musisz zaimplementować w niej obsługę dysków współdzielonych. Złożoność implementacji zależy od funkcji aplikacji.

Na początek musisz uwzględnić parametr zapytania supportsAllDrives=true w żądaniach, gdy aplikacja wykonuje operacje wymienione poniżej:

Interfejs Drive API w wersji 3

  • files.get
  • files.list
  • files.create
  • files.update
  • files.copy
  • files.delete
  • changes.list
  • changes.getStartPageToken
  • permissions.list
  • permissions.get
  • permissions.create
  • permissions.update
  • permissions.delete

Drive API w wersji 2

  • 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

Parametr supportsAllDrives=true informuje Dysk Google, że aplikacja jest przeznaczona do obsługi plików na dyskach współdzielonych.

Aplikacje, które odczytują lub modyfikują uprawnienia, śledzą zmiany lub muszą przeszukiwać wiele korpusów, wymagają dodatkowych funkcji dysku współdzielonego. Pozostała część tego dokumentu wskazuje dodatkowe zmiany wymagane do wykonania tych zadań.

Wyszukiwanie treści na dysku współdzielonym

Aby wyszukiwać dyski współdzielone, używaj metody files.list. Ta sekcja zawiera informacje o polach dotyczących dysku współdzielonego w metodzie files.list. Aby wyszukać dysk współdzielony, zapoznaj się z artykułem Wyszukiwanie plików i folderów.

Metoda files.list zawiera te pola specyficzne dla dysku współdzielonego i tryby zapytań:

  • driveId – identyfikator dysku współdzielonego, który ma zostać przeszukany.

  • includeItemsFromAllDrives – określa, czy wyniki mają uwzględniać elementy z dysków współdzielonych. Jeśli nie jest obecny lub ma wartość Fałsz, elementy dysku współdzielonego nie są zwracane.

  • corpora – treść elementów (plików lub dokumentów), do których odnosi się zapytanie. Obsługiwane treści to user, domain, drive i allDrives. Zamiast allDrives preferuj user lub drive, aby zwiększyć wydajność.

  • supportsAllDrives – czy aplikacja przesyłająca żądanie obsługuje zarówno Mój dysk, jak i dyski współdzielone. Jeśli wartość to false, elementy na dysku współdzielonym nie są uwzględniane w odpowiedzi.

Te tryby zapytań są specyficzne dla dysków współdzielonych:

includeItemsFromAllDrives corpora Opis zapytania
true user Zapytania dotyczące plików, do których użytkownik uzyskał dostęp, w tym plików z dysku współdzielonego i Mojego dysku.
true drive Wykonuje zapytania o wszystkie elementy na określonym dysku współdzielonym. W żądaniu należy określić driveId.
true allDrives Wyszukuje pliki, do których użytkownik ma dostęp, oraz wszystkie dyski współdzielone, których jest użytkownikiem. Pamiętaj, że odpowiedź może zawierać incompleteSearch : true, co oznacza, że w przypadku tej prośby nie przeprowadzono wyszukiwania w niektórych korpusach.
true domain Wyszukiwanie plików udostępnionych w domenie, w tym plików z dysków współdzielonych i Mojego dysku.

Śledzenie zmian na dysku współdzielonym

Aby śledzić zmiany na dysku współdzielonym, użyj metody changes.list. Ta sekcja zawiera informacje o polach dotyczących dysku współdzielonego w metodzie changes.list. Więcej informacji znajdziesz w artykule Śledzenie zmian dla użytkowników i dysków współdzielonych. Metoda changes.list zawiera te pola i tryby zapytań dotyczące dysków współdzielonych:

  • driveId – dysk współdzielony, z którego pobierane są zmiany. Jeśli są określone, identyfikatory zmian odnoszą się do zmian na dysku współdzielonym, a nie do zmian w plikach wyświetlanych użytkownikowi. Aby odwołać się do konkretnej zmiany dysku współdzielonego, jako identyfikatora należy używać zarówno identyfikatora dysku współdzielonego, jak i identyfikatora zmiany.
  • supportsAllDrives – czy aplikacja przesyłająca żądanie obsługuje dyski współdzielone. Jeśli wartość jest równa false, elementy dysku współdzielonego, w tym dyski współdzielone i pliki na dysku współdzielonym, nie są zwracane.
  • includeItemsFromAllDrives – czy pliki na dysku współdzielonym lub zmiany powinny być uwzględnione na liście zmian.

Te tryby zapytań są specyficzne dla dysków współdzielonych:

includeItemsFromAllDrives driveId Opis zapytania
true Nie Zmiany odzwierciedlają zmiany w plikach na dyskach współdzielonych, do których użytkownik ma dostęp, oraz na dyskach współdzielonych, których jest użytkownikiem.
true Tak Zmiany odzwierciedlają zmiany w określonym dysku współdzielonym i elementach na tym dysku.

Więcej informacji o zachowaniu historii zmian znajdziesz w artykule Historia zmian.

Włączanie obsługi dysków współdzielonych w interfejsie Dysku

Aby uzyskać dostęp do treści na dysku współdzielonym za pomocą interfejsu Dysku, upewnij się, że w Konsoli interfejsów API Google zaznaczono opcję „Obsługa dysków współdzielonych”. Więcej informacji znajdziesz w artykule Konfigurowanie integracji z interfejsem Dysku.

Używanie selektora plików na dyskach współdzielonych

Selektor plików umożliwia wybieranie elementów na dyskach współdzielonych. Szczegółowe informacje o włączaniu obsługi dysków współdzielonych i dodawaniu widoku dysków współdzielonych w selektorze plików znajdziesz w artykule Interfejs Google Picker API.

Dalsze kroki

Jeśli potrzebujesz pomocy przy tworzeniu dysków współdzielonych i zarządzaniu uprawnieniami do dysków współdzielonych, przejdź do artykułu Zarządzanie dyskami współdzielonymi.