In diesem Leitfaden finden Sie 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 nach geteilten Ablagen finden Sie im Hilfeartikel Nach geteilten Ablagen suchen.
Abfragestring-Syntax
Ein Abfragestring besteht aus den folgenden 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, die Sie zum Filtern der Suchergebnisse verwenden möchten.
Abfrageoperatoren
In der folgenden Tabelle sind die gültigen Abfrageparameter aufgeführt:
Operator | Nutzung |
---|---|
contains |
Der Inhalt einer Zeichenfolge ist im 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 Abfragen entsprechen. |
or |
Gibt Elemente zurück, die einer der 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 Begriffe für Dateiabfragen aufgeführt. Informationen zu Datentypen und Beschreibungen finden Sie in der Ressourcenreferenz zu files
.
Suchbegriff | Gültige Operatoren | Nutzung |
---|---|---|
name |
contains , = , != |
Name der Datei. Setzen Sie einfache Anführungszeichen (' ). Verwenden Sie einfache Anführungszeichen in Suchanfragen mit \' , wie zum Beispiel 'Valentine\'s Day' . |
fullText |
contains |
Gibt an, ob die Attribute name , description , indexableText oder der Text im Inhalt oder in den Metadaten der Datei übereinstimmen. Setzen Sie einfache Anführungszeichen (' ). Verwenden Sie einfache Anführungszeichen in Suchanfragen mit \' , wie zum Beispiel 'Valentine\'s Day' . |
mimeType |
contains , = , != |
Der MIME-Typ der Datei. Setzen Sie einfache Anführungszeichen (' ). Verwenden Sie einfache Anführungszeichen in Suchanfragen mit \' , wie zum Beispiel '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, 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 die Datei zuletzt 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. 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 Sammlung die angegebene ID enthält. |
owners |
in |
Nutzer, die Eigentümer der Datei sind. |
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 berechtigt sind, die Datei zu lesen. 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) der Datei. Kann entweder true oder false sein. |
createdTime |
<= , < , = , != , > , >= |
Datum, an dem die geteilte Ablage erstellt wurde. Verwenden Sie das Format RFC 3339. 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 . Verwenden Sie 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 einen Präfixabgleich für einenname
-Begriff durch. Angenommen, Sie haben den NamenHelloWorld
. Bei einer Abfrage vonname contains 'Hello'
wird ein Ergebnis zurückgegeben, bei einer Abfrage mitname contains 'World'
nicht.Der Operator
contains
führt nur einen Abgleich für ganze Stringtokens für den BegrifffullText
durch. Wenn beispielsweise der vollständige Text eines Dokuments den String „HelloWorld“ enthält, gibt nur die AbfragefullText contains 'HelloWorld'
ein Ergebnis zurück.Der Operator
contains
stimmt mit einer exakten alphanumerischen Wortgruppe überein, wenn sie in doppelte Anführungszeichen gesetzt ist. Wenn beispielsweise dasfullText
eines Dokuments den String „Hello there world“ enthält, gibt die AbfragefullText contains '"Hello there"'
ein Ergebnis zurück, nicht aber die AbfragefullText contains '"Hello world"'
. Da die Suche alphanumerisch ist, gibt die AbfragefullText contains '"Hello world"'
ein Ergebnis zurück, wenn der Volltext eines Dokuments den String „Hello_world“ enthält.Die Begriffe
owners
,writers
undreaders
sind indirekt in derpermissions
-Liste enthalten und beziehen sich auf dierole
für die Berechtigung. Eine vollständige Liste der Rollenberechtigungen finden Sie unter Rollen und Berechtigungen.
Weitere Beispiele für Abfragestring-Suchanfragen 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, 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 einfache Anführungszeichen (' ). Verwenden Sie einfache Anführungszeichen in Suchanfragen mit \' , wie zum Beispiel 'Valentine\'s Day' . |
true |
organizerCount |
<= , < , = , != , > , >= |
Anzahl der Nutzer und Gruppen, die Organisatoren der geteilten Ablage sind. Nimmt einen numerischen Wert an. | true |
orgUnitId |
= , != |
Die ID der Organisationseinheit einer geteilten Ablage. Nimmt einen String-Wert an. | true |
Weitere Beispiele für die Suche mit Abfragestrings finden Sie im Hilfeartikel Beispiele für Abfragestrings in geteilten Ablagen.
Weitere Informationen
- Nach Dateien und Ordnern suchen
- Geteilte Ablagen suchen
- Von Google Workspace und Google Drive unterstützte MIME-Typen
- Rollen und Berechtigungen