Wenn Sie nach einer bestimmten Gruppe von geteilten Ablagen suchen möchten, verwenden Sie das Feld des Abfragestrings q
mit drives.list, um die zurückzugebenden Ablagen zu
filtern, indem Sie einen oder mehrere Suchbegriffe kombinieren.
Ein Abfragestring besteht aus den folgenden drei Teilen:
query_term operator values
Wobei:
query_termder Suchbegriff oder das Feld ist, nach dem gesucht werden soll.operatorgibt die Bedingung für den Suchbegriff an.valuessind die spezifischen Werte, mit denen Sie Ihre Suchergebnisse filtern möchten.
Die Suchbegriffe und Operatoren, mit denen Sie geteilte Ablagen filtern können, finden Sie unter Suchbegriffe und Operatoren.
Mit dem folgenden Abfragestring wird die Suche so gefiltert, dass nur geteilte Ablagen mit dem Namen „Google Drive API resources“ zurückgegeben werden.
q: name = 'Google Drive API resources' & useDomainAdminAccess=false
Beispiele für Abfragestrings
In der folgenden Tabelle finden Sie Beispiele für einige grundlegende Abfragestrings für geteilte Ablagen. Der tatsächliche Code hängt von der Clientbibliothek ab, die Sie für die Suche verwenden.
Sie müssen auch Sonderzeichen in Ihren Dateinamen maskieren, damit die Abfrage korrekt funktioniert. Wenn ein Dateiname beispielsweise sowohl ein Apostroph
(') als auch einen umgekehrten Schrägstrich ("\") enthält, maskieren Sie sie mit einem umgekehrten Schrägstrich: name
contains 'quinn\'s paper\\essay'.
| Was möchten Sie abfragen? | Beispiel | useDomainAdminAccess-Einstellung |
|---|---|---|
| Nach dem 1. Juni 2017 erstellte geteilte Ablagen | createdTime > '2017-06-01T12:00:00' |
true |
| In der Standardansicht sichtbare geteilte Ablagen | hidden = false |
false |
| Geteilte Ablagen mit mehr als einem Mitglied | memberCount > 1 |
true |
| Geteilte Ablagen mit dem Wort „vertraulich“ im Titel und mindestens 20 Mitgliedern | name contains 'confidential' and memberCount >= 20 |
true |
| Geteilte Ablagen mit dem Wort „vertraulich“ im Titel unter allen geteilten Ablagen der Organisation | name contains 'confidential' and orgUnitId = 'C03az79cb' |
true |
| Geteilte Ablagen mit dem Wort „vertraulich“ im Titel unter allen geteilten Ablagen, in denen der Nutzer Mitglied ist | name contains 'confidential' |
false |
| Geteilte Ablagen ohne zugewiesenen Organisator | organizerCount = 0 |
true |
| Geteilte Ablagen, die die ID der Organisationseinheit nicht enthalten | orgUnitId != 'C03az79cb' |
true |
Mehrere Begriffe mit Klammern abfragen
Sie können mehrere Suchbegriffe mit Klammern gruppieren. Wenn Sie beispielsweise nach geteilten Ablagen suchen möchten, die nach einem bestimmten Datum erstellt wurden und entweder mehr als fünf Organisatoren oder mehr als 20 Mitglieder haben, verwenden Sie diese Abfrage:
createdTime > '2019-01-01T12:00:00' and (organizerCount > 5 or
memberCount > 20)
Diese Suche gibt alle geteilten Ablagen zurück, die nach dem 1. Januar 2019 erstellt wurden und mehr als fünf Organisatoren oder mehr als 20 Mitglieder haben.
Die Drive API wertet die Operatoren and und or von links nach rechts aus. Daher würde dieselbe Suche ohne Klammern Folgendes zurückgeben:
- Nur geteilte Ablagen mit mehr als fünf Organisatoren, die nach dem 1. Januar 2019 erstellt wurden.
- Alle geteilten Ablagen mit mehr als 20 Mitgliedern, auch solche, die vor dem 1. Januar 2019 erstellt wurden.