Die Google Drive API unterstützt mehrere Möglichkeiten zum Suchen nach Dateien und Ordnern.
Mit der Methode files.list
können Sie
alle oder einige der Dateien und Ordner eines Drive-Nutzers. Das files.list
kann auch verwendet werden, um die fileId
abzurufen, die für eine Ressource erforderlich sind.
(z. B. files.get
und
files.update
).
Nach allen Dateien und Ordnern im Ordner „Meine Ablage“ des aktuellen Nutzers suchen
Verwenden Sie die Methode files.list
ohne Parameter, um alle Dateien und
Ordner.
GET https://www.googleapis.com/drive/v3/files
Nach bestimmten Dateien oder Ordnern in „Meine Ablage“ des aktuellen Nutzers suchen
Wenn Sie nach einer bestimmten Gruppe von Dateien oder Ordnern suchen möchten, verwenden Sie den Abfragestring im Feld q
mit der Methode files.list
zum Filtern der
-Dateien, die zurückgegeben werden sollen, indem Sie einen oder mehrere Suchbegriffe kombinieren.
Ein Abfragestring besteht aus drei Teilen:
query_term operator values
Wobei:
query_term
ist der Suchbegriff oder das Feld, nach dem gesucht werden soll.operator
gibt die Bedingung für den Suchbegriff an.values
sind die spezifischen Werte, die Sie zum Filtern Ihrer Suche verwenden möchten Ergebnisse.
Um die Suchbegriffe und Operatoren anzuzeigen, die Sie mit Filterdateien und -ordnern verwenden können, Siehe Suchbegriffe und Operatoren
Der folgende Abfragestring filtert die Suche beispielsweise so, dass nur Ergebnisse zurückgegeben werden, Ordner durch Festlegen des MIME-Typs:
q: mimeType = 'application/vnd.google-apps.folder'
Weitere Informationen zu MIME-Typen finden Sie unter Google Workspace und Google Drive unterstützten MIME-Typen aus.
Beispiele für Abfragestrings
Die folgende Tabelle enthält Beispiele für einige grundlegende Abfragestrings. Der eigentliche Code variiert je nach Clientbibliothek, die Sie für die Suche verwenden.
Außerdem müssen Sie Sonderzeichen in Ihren Dateinamen mit Escapezeichen versehen, um sicherzustellen,
wie die Abfrage funktioniert. Beispiel: Wenn ein Dateiname sowohl einen Apostroph enthält,
('
) und eines umgekehrten Schrägstrichs ("\"
) müssen Sie einen umgekehrten Schrägstrich als Escapezeichen verwenden: name
contains 'quinn\'s paper\\essay'
.
Was Sie abfragen möchten | Beispiel |
---|---|
Dateien mit dem Namen „hello“ | name = 'hello' |
Dateien mit einem Namen, der die Wörter „Hallo“ enthält und „Auf Wiedersehen“. | name contains 'hello' and name contains 'goodbye' |
Dateien mit einem Namen, der nicht das Wort „Hallo“ enthält | not name contains 'hello' |
Dateien, die den Text „wichtig“ enthalten und im Papierkorb | fullText contains 'important' and trashed = true |
Dateien, die das Wort „hello“ enthalten | fullText contains 'hello' |
Dateien, die nicht das Wort „Hallo“ enthalten | not fullText contains 'hello' |
Dateien, die den exakten Ausdruck „Hallo Welt“ enthalten | fullText contains '"hello world"' |
Dateien mit einer Abfrage, die „\“ enthält Zeichen (z. B. "\authors") | fullText contains '\\authors' |
Dateien, die Ordner sind | mimeType = 'application/vnd.google-apps.folder' |
Dateien, die keine Ordner sind | mimeType != 'application/vnd.google-apps.folder' |
Dateien, die nach einem bestimmten Datum geändert wurden (Standardzeitzone ist UTC) | modifiedTime > '2012-06-04T12:00:00' |
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/') |
Markierte Dateien | starred = true |
Dateien in einer Sammlung (z. B. die Ordner-ID in der Sammlung parents ) |
'1234567' in parents |
Dateien in einem Ordner mit Anwendungsdaten in einer Sammlung | 'appDataFolder' in parents |
Dateien für den Nutzer „test@beispiel.org“ ist der Eigentümer | 'test@example.org' in owners |
Dateien für den Nutzer „test@beispiel.org“ hat Schreibberechtigung | 'test@example.org' in writers |
Dateien für Mitglieder der Gruppe „gruppe@beispiel.de“ haben Schreibberechtigung | 'group@example.org' in writers |
Dateien, die für den autorisierten Nutzer mit „hello“ freigegeben wurden im Namen | sharedWithMe and name contains 'hello' |
Dateien mit einer benutzerdefinierten Dateieigenschaft, die für alle Apps sichtbar ist | properties has { key='mass' and value='1.3kg' } |
Dateien mit einer benutzerdefinierten Dateieigenschaft, die nur für die anfragende App freigegeben ist | appProperties has { key='additionalID' and value='8e8aceg2af2ge72e78' } |
Dateien, die für niemanden oder Domains freigegeben wurden (nur privat oder für bestimmte Nutzer oder Gruppen freigegeben) | visibility = 'limited' |
Suchergebnisse mit einer Clientbibliothek filtern
Im folgenden Codebeispiel wird gezeigt, wie Sie die Suche mithilfe einer Clientbibliothek filtern.
die Ergebnisse für Dateinamen und IDs von JPEG-Dateien. In diesem Beispiel wird die Methode mimeType
verwendet.
Suchbegriff, um die Ergebnisse auf Dateien des Typs image/jpeg
einzugrenzen. Außerdem wird festgelegt,
spaces
auf drive
, um die Suche weiter auf das Drive-Element einzugrenzen
Gruppenbereich. Wenn nextPageToken
null
zurückgibt,
es gibt keine weiteren Ergebnisse.
Java
Python
Node.js
PHP
Nach Dateien mit einer benutzerdefinierten Dateieigenschaft suchen
Um nach Dateien mit einem benutzerdefinierten Dateiattribut zu suchen, verwenden Sie entweder die properties
oder
den appProperties
-Suchbegriff mit einem Schlüssel und einem Wert. Zum Beispiel
Suchen Sie nach einer benutzerdefinierten Dateieigenschaft, die für die anfragende App namens
additionalID
mit dem Wert 8e8aceg2af2ge72e78
:
appProperties has { key='additionalID' and value='8e8aceg2af2ge72e78' }
Weitere Informationen finden Sie unter Benutzerdefinierte Datei hinzufügen Eigenschaften.
Nach Dateien mit einem bestimmten Label oder Feldwert suchen
Um nach Dateien mit bestimmten Labels zu suchen, verwenden Sie den Suchbegriff labels
mit einer bestimmten Label-ID. Beispiel: 'labels/LABEL_ID' in
labels
Wenn der Vorgang erfolgreich ist, enthält der Antworttext alle Dateiinstanzen, bei denen der
angewendet wird.
So suchen Sie nach Dateien ohne bestimmte Label-ID: Not
'labels/LABEL_ID' in labels
.
Sie können auch basierend auf bestimmten Feldwerten nach Dateien suchen. Zum Beispiel
Suche nach Dateien mit einem Textwert:
labels/LABEL_ID.text_field_id ='TEXT'
Weitere Informationen finden Sie unter Dateien mit einem bestimmten Label oder Feld suchen Wert:
Korpora suchen
Bei Suchanfragen, die files.list
aufrufen, wird der
Standardmäßig corpora
von user
. Suchen
anderen Korpora (z. B. für domain
freigegebene Dateien) die corpora
.
In einer einzelnen Suchanfrage können mehrere Korpora durchsucht werden, obwohl die Ergebnisse unvollständig sind.
zurückgegeben, wenn der kombinierte Korpora zu groß ist. Wenn incompleteSearch
gleich
true
im Antworttext eingeben, wurden nicht alle Dokumente zurückgegeben. Wenn dieses
finden, sollten Sie Ihre Abfrage eingrenzen, indem Sie andere Korpora auswählen,
user
oder drive
.
Weitere Informationen
- Geteilte Ablagen suchen
- Suchbegriffe und Operatoren
- Von Google Workspace und Google Drive unterstützte MIME-Typen
- Rollen und Berechtigungen
- Nach Dateien mit einem bestimmten Label oder Feldwert suchen