Suchbegriffe und Operatoren

Dieser Leitfaden enthält Suchbegriffe und Operatoren, die Sie mit der Google Drive API verwenden können, um nach Dateien, Ordnern und geteilten Ablagen zu filtern.

Beispiele für die Dateisuche finden Sie unter Nach Dateien und Ordnern suchen.

Beispiele für die Suche in geteilten Ablagen finden Sie im Hilfeartikel Nach geteilten Ablagen suchen.

Syntax des Abfragestrings

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.

Abfrageoperatoren

In der folgenden Tabelle sind die gültigen Abfrageoperatoren aufgeführt:

Operator Nutzung
contains Der Inhalt eines Strings ist im anderen vorhanden.
= Der Inhalt einer Zeichenfolge oder eines booleschen Werts ist gleich dem Inhalt des anderen.
!= Der Inhalt einer Zeichenfolge oder eines booleschen Werts ist nicht gleich dem Inhalt des anderen.
< Ein Wert ist kleiner als ein anderer.
<= Ein Wert ist kleiner oder gleich einem anderen.
> Ein Wert ist größer als ein anderer.
>= Ein Wert ist größer oder gleich einem anderen.
in Ein Element ist in einer Sammlung enthalten.
and Gibt Elemente zurück, die mit beiden Abfragen übereinstimmen.
or Gibt Elemente zurück, die mit einer der beiden Abfragen übereinstimmen.
not Negiert eine Suchanfrage.
has Eine Sammlung enthält ein Element, das den Parametern entspricht.

Dateispezifische Suchbegriffe

In der folgenden Tabelle sind alle gültigen Dateiabfragebegriffe aufgeführt. Informationen zu Datentypen und -beschreibungen finden Sie in der files-Ressourcenreferenz.

Suchbegriff Gültige Operatoren Nutzung
name contains, =, != Name der Datei. Setzen Sie einfache Anführungszeichen ('). Setzen Sie einfache Anführungszeichen in Abfragen mit \' um, z. B. 'Valentine\'s Day'.
fullText contains Ob die Attribute name, description, indexableText oder Text im Dateiinhalt oder in den Metadaten der Datei übereinstimmen. Setzen Sie einfache Anführungszeichen ('). Setzen Sie einfache Anführungszeichen in Abfragen mit \' um, z. B. 'Valentine\'s Day'.
mimeType contains, =, != MIME-Typ der Datei. Setzen Sie einfache Anführungszeichen ('). Setzen Sie einfache Anführungszeichen in Abfragen mit \' um, z. B. 'Valentine\'s Day'. Weitere Informationen zu MIME-Typen finden Sie im Hilfeartikel Von Google Workspace und Google Drive unterstützte MIME-Typen.
modifiedTime <=, <, =, !=, >, >= Datum der letzten Dateiänderung. RFC 3339-Format verwenden, ist die Standardzeitzone UTC, z. B. 2012-06-04T12:00:00-08:00. Felder vom Typ date sind nicht miteinander vergleichbar, sondern nur mit konstanten Datumsangaben.
viewedByMeTime <=, <, =, !=, >, >= Datum, an dem der Nutzer eine Datei zuletzt aufgerufen hat. RFC 3339-Format verwenden, ist die Standardzeitzone UTC, z. B. 2012-06-04T12:00:00-08:00. Felder vom Typ date sind nicht miteinander vergleichbar, sondern nur mit konstanten Datumsangaben.
trashed =, != Gibt an, ob sich die Datei im Papierkorb befindet oder nicht. Kann entweder true oder false sein.
starred =, != Gibt an, ob die Datei markiert ist oder nicht. Kann entweder true oder false sein.
parents in Gibt an, ob die übergeordnete Sammlung die angegebene ID enthält.
owners in Nutzer, denen die Datei gehört
writers in Nutzer oder Gruppen, die berechtigt sind, die Datei zu ändern Weitere Informationen finden Sie in der Ressourcenreferenz zu permissions.
readers in Nutzer oder Gruppen, die zum Lesen der Datei berechtigt sind Weitere Informationen finden Sie in der Ressourcenreferenz zu permissions.
sharedWithMe =, != Dateien, die sich in der Sammlung „Für mich freigegeben“ des Nutzers befinden Alle Nutzer der Datei befinden sich in der Access Control List (ACL). Kann entweder true oder false sein.
createdTime <=, <, =, !=, >, >= Datum, an dem die geteilte Ablage erstellt wurde. Verwenden Sie das RFC 3339-Format. Die Standardzeitzone ist UTC, z. B. 2012-06-04T12:00:00-08:00.
properties has Öffentliche benutzerdefinierte Dateieigenschaften.
appProperties has Eigenschaften privater Dateien
visibility =, != Die Sichtbarkeitsstufe der Datei. Gültige Werte sind anyoneCanFind, anyoneWithLink, domainCanFind, domainWithLink und limited. In einfache Anführungszeichen (') einschließen.
shortcutDetails.targetId =, != Die ID des Elements, auf das die Verknüpfung verweist.

Im Folgenden sehen Sie Kombinationen von Operatoren und Suchbegriffen:

  • Der Operator contains führt nur einen Präfixabgleich für einen name-Begriff durch. Angenommen, Sie haben den Namen HelloWorld. Eine Abfrage von name contains 'Hello' gibt ein Ergebnis zurück, eine Abfrage von name contains 'World' jedoch nicht.

  • Der Operator contains führt nur einen Abgleich für ganze Stringtokens für den Begriff fullText durch. Wenn der Volltext eines Dokuments beispielsweise den String „HelloWorld“ enthält, gibt nur die Abfrage fullText contains 'HelloWorld' ein Ergebnis zurück.

  • Der Operator contains sucht nach einer exakten alphanumerischen Wortgruppe, die in doppelte Anführungszeichen gesetzt ist. Wenn beispielsweise die fullText eines Dokuments den String „Hello there world“ enthält, gibt die Abfrage fullText contains '"Hello there"' ein Ergebnis zurück, die Abfrage fullText contains '"Hello world"' jedoch nicht. Da die Suche alphanumerisch ist, gibt die Abfrage fullText contains '"Hello world"' außerdem ein Ergebnis zurück, wenn der Volltext eines Dokuments den String „Hello_world“ enthält.

  • Die Begriffe owners, writers und readers sind indirekt in der Liste permissions enthalten und beziehen sich auf die role in der Berechtigung. Eine vollständige Liste der Rollenberechtigungen finden Sie unter Rollen und Berechtigungen.

Weitere Beispiele für die Suche nach Abfragestrings finden Sie unter Beispiele für Dateiabfragestrings.

Spezifische Suchbegriffe für geteilte Ablagen

In der folgenden Tabelle sind alle gültigen Suchbegriffe für geteilte Ablagen aufgeführt. Informationen zu Datentypen und -beschreibungen finden Sie in der drives-Ressourcenreferenz.

Suchbegriff Gültige Operatoren Nutzung useDomainAdminAccess-Einstellung
createdTime <=, <, =, !=, >, >= Datum, an dem die geteilte Ablage erstellt wurde. RFC 3339-Format verwenden, ist die Standardzeitzone UTC, z. B. 2012-06-04T12:00:00-08:00. true
hidden =, != Gibt an, ob die geteilte Ablage ausgeblendet ist. Kann entweder true oder false sein. false
memberCount <=, <, =, !=, >, >= Anzahl der Nutzer und Gruppen, die Mitglieder der geteilten Ablage sind Nimmt einen numerischen Wert. true
name contains, =, != Name der geteilten Ablage. Setzen Sie einfache Anführungszeichen ('). Setzen Sie einfache Anführungszeichen in Abfragen mit \' um, z. B. 'Valentine\'s Day'. true
organizerCount <=, <, =, !=, >, >= Anzahl der Nutzer und Gruppen, die Organisatoren der geteilten Ablage sind. Nimmt einen numerischen Wert. true
orgUnitId =, != Die ID der Organisationseinheit einer geteilten Ablage. Übernimmt einen Stringwert. true

Weitere Beispiele für die Suche nach Abfragestrings finden Sie unter Beispiele für Abfragestrings in geteilten Ablagen.