Wenn Sie nach einer bestimmten Gruppe von geteilten Ablagen suchen möchten, verwenden Sie den Abfragestring q
im Feld drives.list
, um die zurückzugebenden Ablagen zu filtern. Dazu kombinieren Sie einen oder mehrere Suchbegriffe.
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, nach denen Sie Ihre Suchergebnisse filtern möchten.
Informationen zu den Suchbegriffen und Operatoren, die Sie zum Filtern von geteilten Ablagen verwenden können, finden Sie unter Suchbegriffe und -operatoren.
Mit dem folgenden Abfragestring wird beispielsweise die Suche so gefiltert, dass nur geteilte Ablagen mit dem Namen „Google Drive API-Ressourcen“ zurückgegeben werden.
q: name = 'Google Drive API resources' & useDomainAdminAccess=false
Beispiele für Abfragestrings
Die folgende Tabelle enthält Beispiele für einige grundlegende Abfragestrings für geteilte Ablagen. Der tatsächliche Code variiert je nach der Clientbibliothek, 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, maskieren Sie sie mit einem umgekehrten Schrägstrich: 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 |
Geteilte Ablagen sind in der Standardansicht sichtbar | hidden = false |
false |
Geteilte Ablagen mit mehreren Mitgliedern | 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 aller geteilten Ablagen der Organisation | name contains 'confidential' and orgUnitId = 'C03az79cb' |
true |
Geteilte Ablagen mit dem Wort „vertraulich“ im Titel aller geteilten Ablagen, in denen der Nutzer Mitglied ist | name contains 'confidential' |
false |
Geteilte Ablagen ohne zugewiesenen Organisator | organizerCount = 0 |
true |
Geteilte Ablagen ohne die ID der Organisationseinheit | orgUnitId != 'C03az79cb' |
true |
Mehrere Begriffe mit Klammern abfragen
Sie können Klammern verwenden, um mehrere Suchbegriffe zu 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 die Operatoren and
und or
von links nach rechts aus, sodass die gleiche Suche ohne Klammern Folgendes zurückgibt:
- 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