Wenn Sie nach einer bestimmten Gruppe freigegebener Ablagen suchen möchten, verwenden Sie das Abfragestring-Feld q mit drives.list, um die zurückzugebenden Ablagen durch Kombination mehrerer Suchbegriffe zu filtern.
Ein Suchstring besteht aus den folgenden drei Teilen:
query_term operator values
Wobei:
query_termist der Suchbegriff oder das Suchfeld.operatorgibt die Bedingung für den Suchbegriff an.valuessind die Werte, mit denen Sie Ihre Suchergebnisse filtern möchten.
Informationen zu Suchbegriffen und Operatoren, mit denen Sie geteilte Ablagen filtern können, finden Sie unter Suchbegriffe und Operatoren.
Mit dem folgenden Suchstring wird die Suche beispielsweise so gefiltert, dass nur freigegebene Laufwerke mit dem Namen „Google Drive API-Ressourcen“ 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 freigegebene Laufwerke. Der tatsächliche Code hängt von der Clientbibliothek ab, die Sie für die Suche verwenden.
Außerdem müssen Sie Sonderzeichen in den Dateinamen mit Escapezeichen versehen, damit die Abfrage ordnungsgemäß funktioniert. Wenn ein Dateiname beispielsweise sowohl ein Apostroph (') als auch einen umgekehrten Schrägstrich ("\") enthält, müssen Sie beide Zeichen mit einem umgekehrten Schrägstrich maskieren: name
contains 'quinn\'s paper\\essay'.
| Was Sie abfragen möchten | Beispiel | useDomainAdminAccess-Einstellung |
|---|---|---|
| Geteilte Ablagen, die nach dem 1. Juni 2017 erstellt wurden | 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, in denen der Nutzer Mitglied ist | name contains 'confidential' |
false |
| Geteilte Ablagen ohne Organisator | organizerCount = 0 |
true |
| Geteilte Ablagen ohne die ID der Organisationseinheit | orgUnitId != 'C03az79cb' |
true |
Mehrere Begriffe mit Klammern abfragen
Sie können mehrere Suchbegriffe mithilfe von Klammern gruppieren. Mit dieser Abfrage können Sie beispielsweise nach geteilten Ablagen suchen, die nach einem bestimmten Datum erstellt wurden und entweder mehr als fünf Organisatoren oder mehr als 20 Mitglieder haben:
createdTime > '2019-01-01T12:00:00' and (organizerCount > 5 or
memberCount > 20)
Bei dieser Suche werden alle geteilten Ablagen zurückgegeben, die nach dem 1. Januar 2019 erstellt wurden und mehr als fünf Organisatoren oder mehr als 20 Mitglieder haben.
Die Drive API wertet and- und or-Operatoren von links nach rechts aus. Die gleiche Suche ohne Klammern würde 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