Suchbegriffe und Operatoren

Dieser Referenzleitfaden enthält Suchbegriffe und Operatoren, mit denen Sie mit der Google Drive API nach Dateien, Ordnern und freigegebenen Ablagen filtern können.

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

Informationen zu Suchanfragen in geteilten Ablagen finden Sie unter Nach geteilten Ablagen suchen.

Syntax von Abfragestrings

Ein Suchstring besteht aus den folgenden drei Teilen:

query_term operator values

Wobei:

  • query_term ist der Suchbegriff oder das Suchfeld.

  • operator gibt die Bedingung für den Suchbegriff an.

  • values sind die Werte, mit denen Sie Ihre Suchergebnisse filtern möchten.

Abfrageoperatoren

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

Operator Nutzung
contains Der Inhalt eines Strings ist im anderen enthalten.
= Der Inhalt eines Strings oder Booleschen Werts ist mit dem anderen identisch.
!= Der Inhalt eines Strings oder Booleschen Werts ist nicht mit dem anderen identisch.
< 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 Elemente zurückgeben, die mit beiden Suchanfragen übereinstimmen
or Gibt Elemente zurück, die mit einer der beiden Suchanfragen ü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 Suchbegriffe für Dateiabfragen aufgeführt. Datentypen und Beschreibungen finden Sie in der files-Ressourcenreferenz.

Suchbegriff Gültige Operatoren Nutzung
name contains, =, != Name der Datei. Setzen Sie sie in einfache Anführungszeichen ('). Maskieren Sie einfache Anführungszeichen in Abfragen mit \', z. B. 'Valentine\'s Day'.
fullText contains Ob die Eigenschaften name, description, indexableText oder der Text im Inhalt oder in den Metadaten der Datei übereinstimmen. Setzen Sie sie in einfache Anführungszeichen ('). Maskieren Sie einfache Anführungszeichen in Abfragen mit \', z. B. 'Valentine\'s Day'.
mimeType contains, =, != MIME-Typ der Datei. Setzen Sie sie in einfache Anführungszeichen ('). Maskieren Sie einfache Anführungszeichen in Abfragen mit \', z. B. 'Valentine\'s Day'. Weitere Informationen zu MIME-Typen finden Sie unter Von Google Workspace und Google Drive unterstützte MIME-Typen.
modifiedTime <=, <, =, !=, >, >= Datum der letzten Dateiänderung. RFC 3339-Format, Standardzeitzone ist UTC, z. B. 2012-06-04T12:00:00-08:00. Felder vom Typ date sind nicht miteinander, sondern nur mit konstanten Datumsangaben vergleichbar.
viewedByMeTime <=, <, =, !=, >, >= Datum, an dem der Nutzer eine Datei zuletzt aufgerufen hat. RFC 3339-Format, Standardzeitzone ist UTC, z. B. 2012-06-04T12:00:00-08:00. Felder vom Typ date sind nicht miteinander, sondern nur mit konstanten Datumsangaben vergleichbar.
trashed =, != Gibt an, ob sich die Datei im Papierkorb befindet oder nicht. Kann entweder true oder false sein.
starred =, != Gibt an, ob die Datei mit einem Stern 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 Lesezugriff auf die Datei haben. Weitere Informationen finden Sie in der Ressourcenreferenz zu permissions.
sharedWithMe =, != Dateien in der Sammlung Für mich freigegeben des Nutzers. Alle Dateinutzer sind in der Zugriffssteuerungsliste (Access Control List, ACL) der Datei enthalten. Kann entweder true oder false sein.
createdTime <=, <, =, !=, >, >= Das 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 Benutzerdefinierte Dateieigenschaften für den privaten Bereich
visibility =, != Die Sichtbarkeitsstufe der Datei. Gültige Werte sind anyoneCanFind, anyoneWithLink, domainCanFind, domainWithLink und limited. Setzen Sie den Wert in einfache Anführungszeichen (').
shortcutDetails.targetId =, != Die ID des Elements, auf das der Verknüpfungspunkt verweist.

Im Folgenden werden Kombinationen von Operatoren und Suchbegriffen veranschaulicht:

  • Der Operator contains führt nur einen Präfixabgleich für einen name-Termin aus. Angenommen, der Name lautet HelloWorld. Eine Abfrage für name contains 'Hello' gibt ein Ergebnis zurück, eine Abfrage für name contains 'World' hingegen nicht.

  • Der Operator contains führt nur eine Übereinstimmung für vollständige String-Tokens für den Begriff fullText durch. Wenn der vollständige Text eines Dokuments beispielsweise den String „HalloWelt“ enthält, gibt nur die Suchanfrage fullText contains 'HelloWorld' ein Ergebnis zurück.

  • Der Operator contains entspricht genau einer alphanumerischen Wortgruppe, wenn sie in doppelte Anführungszeichen gesetzt ist. Wenn die fullText eines Dokuments beispielsweise den String „Hallo Welt“ 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"' auch ein Ergebnis zurück, wenn der vollständige Text eines Dokuments den String „Hallo_Welt“ enthält.

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

Weitere Beispiele für Suchanfragen mit Suchstrings finden Sie unter Beispiele für Suchstrings für Dateien.

Suchbegriffe, die sich auf eine geteilte Ablage beziehen

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

Suchbegriff Gültige Operatoren Nutzung useDomainAdminAccess-Einstellung
createdTime <=, <, =, !=, >, >= Das Datum, an dem die geteilte Ablage erstellt wurde. RFC 3339-Format, Standardzeitzone ist 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. Er nimmt einen numerischen Wert an. true
name contains, =, != Name der geteilten Ablage. Setzen Sie sie in einfache Anführungszeichen ('). Maskieren Sie einfache Anführungszeichen in Abfragen mit \', z. B. 'Valentine\'s Day'. true
organizerCount <=, <, =, !=, >, >= Anzahl der Nutzer und Gruppen, die die geteilte Ablage organisieren. Er nimmt einen numerischen Wert an. true
orgUnitId =, != Die ID der Organisationseinheit einer geteilten Ablage. Erforderlich ist ein Stringwert. true

Weitere Beispiele für Suchanfragen mit Suchstrings finden Sie unter Beispiele für Suchstrings für geteilte Ablagen.