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

Dyski współdzielone działają według innych modeli organizacji, udostępniania i własności niż Mój dysk. Jeśli Twoja aplikacja ma tworzyć pliki na dyskach współdzielonych i nimi zarządzać, musisz wdrożyć w niej obsługę dysków współdzielonych. Stopień złożoności 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:

Drive API v3

  • 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 i tryby zapytań dotyczące dysków współdzielonych:

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

  • includeItemsFromAllDrives – czy elementy z dysków współdzielonych mają być uwzględniane w wynikach. 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 podmioty to user, domain, drive i allDrives. Zamiast allDrives użyj 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 Wyszukiwanie wszystkich elementów na określonym dysku współdzielonym. W żądaniu należy podać identyfikator dysku (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ływać się do konkretnej zmiany na dysku współdzielonym, należy użyć jako identyfikatora 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.

Korzystanie z selektora plików na dyskach współdzielonych

Selektor plików obsługuje 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

Aby dowiedzieć się więcej o tworzeniu dysków współdzielonych i zarządzaniu uprawnieniami do nich, przejdź do sekcji Zarządzanie dyskami współdzielonymi.