Zawiera listę plików użytkownika.
Ta metoda akceptuje parametr q
, który jest zapytaniem łączącym co najmniej jedno wyszukiwane hasło. Więcej informacji znajdziesz w przewodniku Wyszukiwanie plików i folderów.
Żądanie HTTP
GET https://www.googleapis.com/drive/v2/files
Adres URL używa składni transkodowania gRPC.
Parametry zapytania
Parametry | |
---|---|
corpora |
ciała elementów (plików/dokumentów), których dotyczy zapytanie. Obsługiwane ciała to |
corpus |
Wycofane: treść elementów (plików/dokumentów), do których odnosi się zapytanie. Użyj w zamian zasady |
driveId |
Identyfikator dysku współdzielonego do przeszukania. |
includeItemsFromAllDrives |
Określa, czy w wynikach mają być uwzględnione zarówno elementy z Mojego dysku, jak i dysku współdzielonego. |
includeTeamDriveItems |
Wycofane: zamiast tego użyj elementu |
maxResults |
Maksymalna liczba plików do zwrócenia na stronę. Częściowe lub puste strony wyników mogą zostać wyświetlone jeszcze przed osiągnięciem końca listy plików. |
orderBy |
Rozdzielona przecinkami lista kluczy sortowania. Prawidłowe klucze to |
pageToken |
Token strony na pliki. |
projection |
Wycofany: ten parametr nie ma funkcji. |
q |
Ciąg zapytania do wyszukiwania plików. |
spaces |
Rozdzielona przecinkami lista spacji, których dotyczy zapytanie. Obsługiwane wartości to |
supportsAllDrives |
Określa, czy aplikacja żądająca obsługuje zarówno Mój dysk, jak i dyski współdzielone. |
supportsTeamDrives |
Wycofane: zamiast tego użyj elementu |
teamDriveId |
Wycofane: zamiast tego użyj elementu |
includePermissionsForView |
Określa, które dodatkowe uprawnienia do widoku mają być uwzględnione w odpowiedzi. Obsługiwana jest tylko wartość |
includeLabels |
Rozdzielona przecinkami lista identyfikatorów etykiet do uwzględnienia w części |
Treść żądania
Treść żądania musi być pusta.
Treść odpowiedzi
Listę plików.
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{
"nextPageToken": string,
"kind": string,
"etag": string,
"selfLink": string,
"incompleteSearch": boolean,
"nextLink": string,
"items": [
{
object ( |
Pola | |
---|---|
nextPageToken |
Token strony następnej strony plików. Będzie jej brakować po osiągnięciu końca listy plików. Jeśli token zostanie z jakiegokolwiek powodu odrzucony, należy go odrzucić i uruchomić ponownie podział na strony na pierwszej stronie wyników. |
kind |
Jest to zawsze |
etag |
Wartość ETag listy. |
selfLink |
Link do tej listy. |
incompleteSearch |
Wskazuje, czy proces wyszukiwania nie został zakończony. Jeśli ma wartość true (prawda), może brakować niektórych wyników wyszukiwania, ponieważ nie wszystkie dokumenty zostały przeszukane. Ten błąd może wystąpić podczas wyszukiwania wielu dysków za pomocą korpusu „allDrives”, ale nie udało się przeszukać wszystkich korpusów. W takim przypadku zalecamy klientom zawężenie zapytania, wybierając inny korpus, taki jak „domyślny” lub „dysk”. |
nextLink |
Link do następnej strony z plikami. |
items[] |
Lista plików. Jeśli wartość NextPageToken jest wypełniona, ta lista może być niekompletna i należy pobrać dodatkową stronę wyników. |
Zakresy autoryzacji
Wymaga jednego z tych zakresów OAuth:
https://www.googleapis.com/auth/docs
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.appdata
https://www.googleapis.com/auth/drive.apps.readonly
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/drive.metadata
https://www.googleapis.com/auth/drive.metadata.readonly
https://www.googleapis.com/auth/drive.photos.readonly
https://www.googleapis.com/auth/drive.readonly
Niektóre zakresy są objęte ograniczeniami, a aplikacja może z nich korzystać dopiero po sprawdzeniu zabezpieczeń. Więcej informacji znajdziesz w przewodniku po autoryzacji.
Korpus
Wartości w polu enum | |
---|---|
DEFAULT |
Elementy, do których użytkownik uzyskał dostęp. |
DOMAIN |
Elementy udostępnione w domenie użytkownika. |