Suchbegriffe und Operatoren

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

In dieser Referenz finden Sie die Suchbegriffe und Operatoren, die Sie mit der Google Drive API verwenden können.

Abfrageoperatoren

In dieser Tabelle sind alle gültigen Abfrageparameter aufgeführt:

Betreiber Nutzung
contains Der Inhalt einer Zeichenfolge ist in der anderen vorhanden.
= Der Inhalt eines Strings oder booleschen Werts ist mit dem anderen identisch.
!= 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 Suchanfragen entsprechen.
or Gibt Elemente zurück, die mit einer der beiden Abfragen übereinstimmen.
not Negiert eine Suchanfrage.
has Eine Sammlung enthält ein Element, das mit den Parametern übereinstimmt.

Dateispezifische Suchbegriffe

In der folgenden Tabelle sind alle gültigen Begriffe für Dateiabfragen aufgeführt. Weitere Informationen zu Datentypen und Beschreibungen finden Sie in der files-Ressourcenreferenz.

Suchbegriff Gültige Operatoren Nutzung
name contains, =, != Name der Datei. Setzen Sie den Text in einfache Anführungszeichen: '. Verwenden Sie \' als Escapezeichen für einfache Anführungszeichen, z. B. 'Valentine\'s Day'.
fullText contains Gibt an, ob die Eigenschaften name, description, indexableText oder Text im Inhalt oder in den Metadaten der Datei übereinstimmen. Setzen Sie den Text in einfache Anführungszeichen: '. Verwenden Sie \' als Escapezeichen für einfache Anführungszeichen, z. B. 'Valentine\'s Day'.
mimeType contains, =, != MIME-Typ der Datei. Setzen Sie den Text in einfache Anführungszeichen: '. Verwenden Sie \' als Escapezeichen für einfache Anführungszeichen, 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 Änderung der Datei. RFC 3339-Format. Die 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 das letzte Mal eine Datei aufgerufen hat. RFC 3339-Format. Die 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 markiert ist oder nicht. 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 Ressourcenreferenz zu Berechtigungen.
readers in Nutzer oder Gruppen, die zum Lesen der Datei berechtigt sind. Weitere Informationen finden Sie in der Ressourcenreferenz zu Berechtigungen.
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) der Datei. 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 benutzerdefinierter Dateien.
visibility =, != Die Sichtbarkeit der Datei. Gültige Werte sind anyoneCanFind, anyoneWithLink, domainCanFind, domainWithLink und limited. Setzen Sie den Text in einfache Anführungszeichen: '.
shortcutDetails.targetId =, != Die ID des Elements, auf das die Verknüpfung verweist.

Im Folgenden sehen Sie Kombinationen aus Operatoren und Suchbegriffen:

  • Der Operator contains führt nur für einen name-Begriff einen Präfixabgleich 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.

  • Mit dem Operator contains werden nur ganze Stringtokens für den fullText-Term abgeglichen. Wenn beispielsweise der vollständige Text eines Dokuments 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, wenn diese 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, nicht aber die Abfrage fullText contains '"Hello world"'. 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 permissions-Liste enthalten und beziehen sich auf die role für die Berechtigung.

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

Spezifische 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 Drive-Ressourcenreferenz.

Suchbegriff Gültige Operatoren Nutzung Erforderliche useDomainAdminAccess-Einstellung
createdTime <=, <, =, !=, >, >= Datum, an dem die geteilte Ablage erstellt wurde. RFC 3339-Format. Die 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 Nimmt einen numerischen Wert an. true
name contains, =, != Name der geteilten Ablage Setzen Sie den Text in einfache Anführungszeichen: '. Verwenden Sie \' als Escapezeichen für einfache Anführungszeichen, z. B. 'Valentine\'s Day'. false
organizerCount <=, <, =, !=, >, >= Anzahl der Nutzer und Gruppen, die Organisatoren der geteilten Ablage sind. Nimmt einen numerischen Wert an. true
orgUnitId =, != Die ID der Organisationseinheit (OE) einer geteilten Ablage. Nimmt einen String-Wert an. true