Suchbegriffe und Operatoren

In diesem Referenzleitfaden werden die Suchbegriffe und Operatoren beschrieben, die Sie mit dem Google Drive API verwenden, 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, die Sie zum Filtern Ihrer Suche verwenden möchten Ergebnisse.

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. Für Datentypen und finden Sie in der Ressource files Referenz.

Suchbegriff Gültige Operatoren Nutzung
name contains, =, != Name der Datei. In einfache Anführungszeichen (') einschließen. Verwenden Sie \' in Abfragen, um einfache Anführungszeichen zu maskieren, z. B. 'Valentine\'s Day'.
fullText contains Ob die Attribute name, description, indexableText oder Text im Dateiinhalt oder in den Metadaten der Datei übereinstimmen. In einfache Anführungszeichen (') einschließen. Verwenden Sie \' in Abfragen, um einfache Anführungszeichen zu maskieren, z. B. 'Valentine\'s Day'.
mimeType contains, =, != MIME-Typ der Datei. In einfache Anführungszeichen (') einschließen. Verwenden Sie \' in Abfragen, um einfache Anführungszeichen zu maskieren, 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 festen 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 festen 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 unter Für mich freigegeben“ des Nutzers befinden erfasst werden. 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 Private benutzerdefinierte Dateieigenschaften.
visibility =, != Die Sichtbarkeit 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 einen Präfixabgleich nur für eine Laufzeit von name. Angenommen, Sie haben einen Namen, von HelloWorld. Bei einer Abfrage mit name contains 'Hello' wird ein Ergebnis, die name contains 'World'-Abfrage jedoch nicht.

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

  • Der Operator contains sucht nach einer exakten alphanumerischen Wortgruppe, wenn 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, Text eines Dokuments den String "Hello_world" enthält, dann ist die Abfrage fullText contains '"Hello world"' gibt ein Ergebnis zurück.

  • Die Bedingungen owners, writers und readers spiegeln sich indirekt in den permissions und verweisen Sie auf das role für die Berechtigung. Eine vollständige Liste der Rollenberechtigungen finden Sie unter Rollen und Berechtigungen:

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

Spezifische Suchbegriffe für geteilte Ablagen

In der folgenden Tabelle sind alle gültigen Suchbegriffe für geteilte Ablagen aufgeführt. Für Datentypen und finden Sie in der Ressource zu drives. Referenz.

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. In einfache Anführungszeichen (') einschließen. Verwenden Sie \' in Abfragen, um einfache Anführungszeichen zu maskieren, 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 Suchanfragen in Abfragestrings finden Sie im Hilfeartikel Abfragestrings für geteilte Ablagen erstellen. Beispiele.