Nach geteilten Ablagen suchen

In diesem Leitfaden wird erläutert, wie Sie mit der Google Drive API auf verschiedene Arten in geteilten Ablagen suchen können.

Wenn Sie nach einer bestimmten Gruppe von geteilten Ablagen suchen möchten, verwenden Sie das Feld des Abfragestrings q mit der Methode list für die Ressource drives. So können Sie die zurückzugebenden Ablagen filtern, indem Sie einen oder mehrere Suchbegriffe kombinieren.

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, mit denen Sie Ihre Suchergebnisse filtern möchten.

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

Alle Suchbegriffe für geteilte Ablagen finden Sie unter Suchbegriffe für geteilte Ablagen.

Alle Abfrageoperatoren, die Sie zum Erstellen einer Abfrage verwenden können, finden Sie unter Query operators.

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 soll abgefragt werden? Beispiel Einstellung useDomainAdminAccess
Operator für Stringübereinstimmung (contains)
Geteilte Ablagen mit dem Wort „vertraulich“ im Titel unter allen geteilten Ablagen, in denen der Nutzer Mitglied ist name contains 'confidential' false
Gleichheits- und Ungleichheitsoperatoren (=, !=)
Geteilte Ablagen, die in der Standardansicht sichtbar sind hidden = false false
Geteilte Ablagen, die in der Standardansicht ausgeblendet sind hidden = true false
Geteilte Ablagen ohne zugewiesenen Organisator organizerCount = 0 true
Geteilte Ablagen mit genau einem Mitglied memberCount = 1 true
Geteilte Ablagen, die zur Organisationseinheit mit der ID gehören orgUnitId = 'C03az79cb' true
Geteilte Ablagen, die die ID der Organisationseinheit nicht enthalten orgUnitId != 'C03az79cb' true
Geteilte Ablagen mit Namen, die nicht mit einem bestimmten Namen übereinstimmen name != 'Archived Projects' true
Vergleichsoperatoren (>, >=, <, <=)
Geteilte Ablagen, die nach dem 1. Juni 2017 erstellt wurden createdTime > '2017-06-01T12:00:00' true
Geteilte Ablagen, die vor dem 1. Januar 2023 erstellt wurden createdTime < '2023-01-01T00:00:00' true
Geteilte Ablagen mit mehr als einem Mitglied memberCount > 1 true
Geteilte Ablagen mit weniger als fünf Mitgliedern memberCount < 5 true
Geteilte Ablagen mit maximal drei Organisatoren organizerCount <= 3 true
Logische Operatoren (and, or, not)
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 Namen, die entweder „Project“ oder „Archive“ enthalten name contains 'Project' or name contains 'Archive' true
Geteilte Ablagen, deren Namen nicht „Draft“ enthalten not name contains 'Draft' true
Geteilte Ablagen, die nicht zu einer Zielorganisationseinheit gehören und nach einem bestimmten Datum erstellt wurden orgUnitId != 'C03az79cb' and createdTime > '2023-01-01T00:00:00' true

Mehrere Suchbegriffe 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. Bei derselben Suche ohne Klammern würde Folgendes zurückgegeben:

  • 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.