Suchbegriffe und Operatoren

In diesem Referenzleitfaden finden Sie Suchbegriffe und Operatoren, mit denen Sie in der Google Drive API nach Dateien, Ordnern und geteilten Ablagen filtern können.

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

Beispiele für die Suche in geteilten Ablagen finden Sie unter Geteilte Ablagen suchen.

Syntax für Abfragestrings

Ein Abfragestring besteht aus drei Teilen:

query_term operator values

Wobei:

  • query_term der Suchbegriff oder das Feld ist, nach dem gesucht werden soll.

  • operator die Bedingung für den Suchbegriff angibt.

  • values die spezifischen Werte sind, mit 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 eines Strings oder booleschen Werts ist gleich dem anderen.
!= Der Inhalt eines Strings oder booleschen Werts ist nicht gleich dem 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 beiden Abfragen entsprechen.
or Gibt Elemente zurück, die einer der beiden Abfragen entsprechen.
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 Dateien aufgeführt. Datentypen und Beschreibungen finden Sie in der files Ressource Referenz.

Suchbegriff Gültige Operatoren Nutzung
name contains, =, != Name der Datei. In einfache Anführungszeichen (') setzen. Einfache Anführungszeichen in Abfragen mit \' maskieren, z. B. 'Valentine\'s Day'.
fullText contains Gibt an, ob die Eigenschaften name, description, indexableText oder der Text im Inhalt oder in den Metadaten der Datei übereinstimmen. In einfache Anführungszeichen (') setzen. Einfache Anführungszeichen in Abfragen mit \' maskieren, z. B. 'Valentine\'s Day'.
mimeType contains, =, != MIME-Typ der Datei. In einfache Anführungszeichen (') setzen. Einfache Anführungszeichen in Abfragen mit \' maskieren, z. B. 'Valentine\'s Day'. Weitere Informationen zu MIME-Typen finden Sie unter Unterstützte MIME-Typen in Google Workspace und Google Drive.
modifiedTime <=, <, =, !=, >, >= Datum der letzten Änderung der Datei. RFC 3339-Format, Standardzeitzone ist 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 die 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 vergleichbar, sondern nur mit konstanten Datumsangaben.
trashed =, != Gibt an, ob sich die Datei im Papierkorb befindet. Kann entweder true oder false sein.
starred =, != Gibt an, ob die Datei mit einem Sternchen markiert ist. Kann entweder true oder false sein.
parents in Gibt an, ob die Sammlung der übergeordneten Elemente 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 Referenz zur Ressource permissions.
readers in Nutzer oder Gruppen, die berechtigt sind, die Datei zu lesen. Weitere Informationen finden Sie in der Referenz zur Ressource permissions.
sharedWithMe =, != Dateien, die sich in der Sammlung „Für mich freigegeben“ des Nutzers befinden. Alle Dateinutzer sind in der ACL (Access Control List) der Datei enthalten. Kann entweder true oder false sein.
createdTime <=, <, =, !=, >, >= Datum, an dem die Datei erstellt wurde. RFC 3339-Format verwenden, Standardzeitzone ist UTC, z. B. 2012-06-04T12:00:00-08:00. Nur in der Drive API v3 unterstützt.
properties has Öffentliche benutzerdefinierte Dateieigenschaften.
appProperties has Private benutzerdefinierte Dateieigenschaften.
visibility =, != Die Sichtbarkeitsebene der Datei. Gültige Werte sind anyoneCanFind, anyoneWithLink, domainCanFind, domainWithLink und limited. In einfache Anführungszeichen (') setzen.
shortcutDetails.targetId =, != Die ID des Elements, auf das die Verknüpfung verweist.

Im Folgenden werden Kombinationen von Operatoren und Suchbegriffen veranschaulicht:

  • Der Operator contains führt nur eine Präfixübereinstimmung für einen name-Begriff aus. 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 für den Begriff fullText nur eine Übereinstimmung mit vollständigen String-Tokens aus. Wenn der vollständige Text eines Dokuments beispielsweise den String „HelloWorld“ enthält, gibt nur die Abfrage fullText contains 'HelloWorld' ein Ergebnis zurück.

  • Der Operator contains findet eine Übereinstimmung mit einer Wortgruppe, wenn der rechte Operand in doppelte Anführungszeichen gesetzt wird. Beispiel:

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

    • Wenn der vollständige Text eines Dokuments den String „Hello_world“ enthält, gibt die Abfrage fullText contains '"Hello world"' trotzdem ein Ergebnis zurück, da der Unterstrich im Dokumentstring als Leerzeichen behandelt wird.

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

Weitere Beispiele für Abfragestrings finden Sie unter Beispiele für Abfragestrings für Dateien.

Suchbegriffe für geteilte Ablagen

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

Suchbegriff Gültige Operatoren Nutzung Einstellung useDomainAdminAccess
createdTime <=, <, =, !=, >, >= 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. Akzeptiert einen numerischen Wert. true
name contains, =, != Name der geteilten Ablage. In einfache Anführungszeichen (') setzen. Einfache Anführungszeichen in Abfragen mit \' maskieren, z. B. 'Valentine\'s Day'. true
organizerCount <=, <, =, !=, >, >= Anzahl der Nutzer und Gruppen, die Organisatoren der geteilten Ablage sind. Akzeptiert einen numerischen Wert. true
orgUnitId =, != Die ID der Organisationseinheit einer geteilten Ablage. Akzeptiert einen Stringwert. true

Weitere Beispiele für Abfragestrings finden Sie unter Beispiele für Abfragestrings für geteilte Ablagen.