Nach geteilten Ablagen suchen

Wenn Sie nach einer bestimmten Gruppe von geteilten Ablagen suchen möchten, verwenden Sie den Abfragestring q field mit drives.list, um die zurückzugebenden Ablagen durch Kombinieren von einem oder mehreren Suchbegriffen zu filtern.

Ein Abfragestring besteht aus den folgenden 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 Suchergebnisse verwenden möchten.

Informationen zu den 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 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 freigegebene Ablagen. Der tatsächliche Code hängt von der Clientbibliothek ab, die Sie für Ihre Suche verwenden.

Außerdem müssen Sie Sonderzeichen in Ihren Dateinamen mit einem Escapezeichen versehen, damit die Abfrage richtig 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
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 nicht die ID der Organisationseinheit 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 Anfrage:

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. Dieselbe Suche ohne Klammern würde also 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.