Mit der Methode files.list
können Sie alle oder nur einen Teil der Dateien und Ordner eines Drive-Nutzers zurückgeben.
Sie können auch die Methode files.list
verwenden, um den für bestimmte Ressourcenmethoden (z. B. files.get
und files.update
) erforderlichen fileId
abzurufen.
Nach allen Dateien und Ordnern im Ordner „Meine Ablage“ des aktuellen Nutzers suchen
Verwenden Sie files.list
ohne Parameter, um alle Dateien und Ordner zurückzugeben.
Im Ordner „Meine Ablage“ des aktuellen Nutzers nach bestimmten Dateien oder Ordnern suchen
Wenn Sie nach einem bestimmten Satz von Dateien oder Ordnern suchen möchten, verwenden Sie das Feld q
des Abfragestrings mit files.list
. Damit können Sie die zurückzugebenden Dateien durch Kombinieren eines oder mehrerer Suchbegriffe filtern.
Ein Abfragestring besteht aus drei Teilen:
query_term operator values
Wobei:
query_term
ist der Suchbegriff oder das Feld, nach dem gesucht werden soll. Weitere Informationen zu den Suchbegriffen, nach denen sich geteilte Ablagen filtern lassen, finden Sie im Hilfeartikel Suchbegriffe und Operatoren.operator
gibt die Bedingung für den Suchbegriff an. Informationen zu den Operatoren, die Sie mit jedem Abfragebegriff verwenden können, finden Sie unter Abfrageoperatoren.values
sind die Werte, nach denen Sie Ihre Suchergebnisse filtern möchten.
Der folgende Abfragestring filtert beispielsweise die Suche so, dass nur Ordner zurückgegeben werden:
q: mimeType = 'application/vnd.google-apps.folder'
Das folgende Beispiel zeigt, wie Sie mit einer Clientbibliothek Suchergebnisse nach Dateinamen und IDs von JPEG-Dateien filtern. In diesem Beispiel wird der Abfragebegriff mimeType
verwendet, um die Ergebnisse auf Dateien vom Typ image/jpeg
einzugrenzen. In diesem Beispiel wird außerdem spaces
auf drive
gesetzt, um die Suche weiter auf den Drive-Speicherplatz einzugrenzen. Wenn nextPageToken
null
zurückgibt, sind keine weiteren Ergebnisse vorhanden.
Java
Python
Node.js
PHP
Wenn Sie die Suche auf Ordner beschränken möchten, setzen Sie den MIME-Typ mit dem Abfragestring auf q: mimeType = 'application/vnd.google-apps.folder'
.
Weitere Informationen zu MIME-Typen finden Sie unter Von Google Workspace und Google Drive unterstützte MIME-Typen.
Beispiele für Abfragestrings
Diese Tabelle enthält einige grundlegende Abfragestrings. Der tatsächliche Code unterscheidet sich je nach der Clientbibliothek, die Sie für die Suche verwenden.
Was Sie abfragen möchten | Beispiel |
---|---|
Dateien mit dem Namen „hello“ | name = 'hello' |
Dateien, deren Name die Wörter „hello“ und „goodbye“ enthält | name contains 'hello' and name contains 'goodbye' |
Dateien, deren Name das Wort „hello“ nicht enthält | not name contains 'hello' |
Ordner, die Google-Apps sind oder den MIME-Typ des Ordners haben | mimeType = 'application/vnd.google-apps.folder' |
Dateien, die keine Ordner sind | mimeType != 'application/vnd.google-apps.folder' |
Dateien, die den Text „Wichtig“ enthalten und sich im Papierkorb befinden | fullText contains 'important' and trashed = true |
Dateien, die das Wort „hello“ enthalten | fullText contains 'hello' |
Dateien, die das Wort „hello“ nicht enthalten | not fullText contains 'hello' |
Dateien, die den exakten Ausdruck „Hello World“ enthalten | fullText contains '"hello world"' |
Dateien mit einer Abfrage, die das Zeichen „\“ enthält (z.B. "\authors") | fullText contains '\\authors' |
Dateien mit ID innerhalb einer Sammlung, z.B. parents -Sammlung |
'1234567' in parents |
Dateien in einem Ordner mit Anwendungsdaten in einer Sammlung | 'appDataFolder' in parents |
Dateien, für die der Nutzer „test@beispiel.de“ Schreibberechtigung hat | 'test@example.org' in writers |
Dateien, für die Mitglieder der Gruppe „gruppe@beispiel.de“ Schreibberechtigung haben | 'group@example.org' in writers |
Dateien, die nach einem bestimmten Datum geändert wurden | modifiedTime > '2012-06-04T12:00:00' // default time zone is UTC |
Für den autorisierten Nutzer freigegebene Dateien mit „hello“ im Namen | sharedWithMe and name contains 'hello' |
Dateien, die für niemanden oder Domains freigegeben wurden (nur privat oder für bestimmte Nutzer oder Gruppen freigegeben) | visibility = 'limited' |
Bild- oder Videodateien, die nach einem bestimmten Datum geändert wurden | modifiedTime > '2012-06-04T12:00:00' and (mimeType contains 'image/' or mimeType contains 'video/') |
Nach Dateien mit einer benutzerdefinierten Dateieigenschaft suchen
Verwenden Sie den Suchbegriff appProperties
mit einem Schlüssel und Wert, um nach Dateien mit einem benutzerdefinierten Dateiattribut zu suchen. So suchen Sie beispielsweise nach einem benutzerdefinierten Dateiattribut namens additionalID
mit dem Wert 8e8aceg2af2ge72e78
:
appProperties has { key='additionalID' and value='8e8aceg2af2ge72e78' }
Weitere Informationen zu benutzerdefinierten Dateieigenschaften finden Sie unter Benutzerdefinierte Dateieigenschaften hinzufügen.
Nach Dateien mit einem bestimmten Label oder Feldwert suchen
Wenn Sie nach Dateien mit bestimmten Labels suchen möchten, verwenden Sie den Suchbegriff labels
mit einer bestimmten Label-ID. Beispiel: 'labels/LABEL_ID'
in labels
So suchen Sie nach Dateien ohne eine bestimmte Label-ID: Not
'labels/LABEL_ID' in labels
Sie können auch anhand bestimmter Feldwerte nach Dateien suchen. So suchen Sie beispielsweise nach Dateien mit einem Textwert: labels/LABEL_ID.text_field_id =
'TEXT'
Weitere Informationen finden Sie unter Nach Dateien mit einem bestimmten Label oder Feldwert suchen.
In Korpora suchen
Suchanfragen, die files.list
aufrufen, verwenden standardmäßig den user
-Korpus. Mit dem Parameter corpora
können Sie nach anderen Korpora suchen, z. B. nach Dateien, die für eineGoogle Workspace -Domain freigegeben wurden.
In einer einzelnen Abfrage können mehrere Korpora durchsucht werden, aber es können unvollständige Ergebnisse zurückgegeben werden, wenn der kombinierte Korpus zu groß ist. Wenn das incompleteSearch
-Ergebnis true
ist, wurden nicht alle Dokumente zurückgegeben.