Условия и операторы поисковых запросов

В этом справочном руководстве представлены термины запросов и операторы, которые вы можете использовать с API Google Диска для фильтрации файлов, папок и общих дисков.

Примеры поиска файлов см. в разделе Поиск файлов и папок .

Пример поиска общих дисков см. в разделе Поиск общих дисков .

Синтаксис строки запроса

Строка запроса состоит из следующих трех частей:

query_term operator values

Где:

  • query_term — это термин запроса или поле для поиска.

  • operator определяет условие для термина запроса.

  • values — это конкретные значения, которые вы хотите использовать для фильтрации результатов поиска.

Операторы запроса

В следующей таблице перечислены допустимые операторы запроса:

Оператор Использование
contains Содержимое одной строки присутствует в другой.
= Содержимое строки или логического значения равно другому.
!= Содержимое строки или логического значения не равно другому.
< Значение меньше другого.
<= Значение меньше или равно другому.
> Значение больше другого.
>= Значение больше или равно другому.
in Элемент содержится в коллекции.
and Возвращайте элементы, соответствующие обоим запросам.
or Возвращайте элементы, соответствующие любому запросу.
not Отменяет поисковый запрос.
has Коллекция содержит элемент, соответствующий параметрам.

Условия запроса для конкретного файла

В следующей таблице перечислены все допустимые термины запроса файла. Типы данных и описания см. в справочнике по ресурсам files .

Термин запроса Допустимые операторы Использование
name contains , = , != Имя файла. Окружите одинарными кавычками ( ' ). Экранируйте одинарные кавычки в запросах с помощью \' , например 'Valentine\'s Day' .
fullText contains Совпадают ли name , description , свойства indexableText или текст в содержимом файла или метаданных файла. Окружите одинарными кавычками ( ' ). Экранируйте одинарные кавычки в запросах с помощью \' , например 'Valentine\'s Day' .
mimeType contains , = , != MIME-тип файла. Окружите одинарными кавычками ( ' ). Экранируйте одинарные кавычки в запросах с помощью \' , например 'Valentine\'s Day' . Дополнительную информацию о типах MIME см. в разделе Типы MIME, поддерживаемые Google Workspace и Google Drive .
modifiedTime <= , < , = , != , > , >= Дата последней модификации файла. Формат RFC 3339 , часовой пояс по умолчанию — UTC, например 2012-06-04T12:00:00-08:00 . Поля типа date не сопоставимы друг с другом, только с постоянными датами.
viewedByMeTime <= , < , = , != , > , >= Дата, когда пользователь последний раз просматривал файл. Формат RFC 3339 , часовой пояс по умолчанию — UTC, например 2012-06-04T12:00:00-08:00 . Поля типа date не сопоставимы друг с другом, только с постоянными датами.
trashed = , != Независимо от того, находится файл в корзине или нет. Может быть либо true , либо false .
starred = , != Независимо от того, помечен файл или нет. Может быть либо true , либо false .
parents in Содержит ли родительская коллекция указанный идентификатор.
owners in Пользователи, владеющие файлом.
writers in Пользователи или группы, имеющие разрешение на изменение файла. См. справочник по ресурсам permissions .
readers in Пользователи или группы, у которых есть разрешение на чтение файла. См. справочник по ресурсам permissions .
sharedWithMe = , != Файлы, находящиеся в коллекции пользователя «Доступно мне» . Все пользователи файла находятся в списке управления доступом (ACL) к файлу. Может быть либо true , либо false .
createdTime <= , < , = , != , > , >= Дата создания общего диска. Используйте формат RFC 3339 , часовой пояс по умолчанию — UTC, например 2012-06-04T12:00:00-08:00 .
properties has Публичные пользовательские свойства файла.
appProperties has Частные пользовательские свойства файла.
visibility = , != Уровень видимости файла. Допустимые значения: anyoneCanFind , anyoneWithLink , domainCanFind , domainWithLink и limited . Окружите одинарными кавычками ( ' ).
shortcutDetails.targetId = , != Идентификатор элемента, на который указывает ярлык.

Ниже показаны комбинации операторов и терминов запроса:

  • Оператор contains выполняет сопоставление префиксов только для термина name . Например, предположим, что у вас есть имя HelloWorld . Запрос name contains 'Hello' возвращает результат, а запрос name contains 'World' — нет.

  • Оператор contains выполняет сопоставление только целых строковых токенов для fullText термина. Например, если полный текст документа содержит строку «HelloWorld», только запрос fullText contains 'HelloWorld' возвращает результат.

  • Оператор contains соответствует точной буквенно-цифровой фразе, если она заключена в двойные кавычки. Например, если fullText документа содержит строку «Привет, мир», то запрос fullText contains '"Hello there"' возвращает результат, а запрос fullText contains '"Hello world"' нет. Кроме того, поскольку поиск является буквенно-цифровым, если полный текст документа содержит строку «Hello_world», то запрос fullText contains '"Hello world"' возвращает результат.

  • Условия owners , writers и readers косвенно отражаются в списке permissions и относятся к role в разрешении. Полный список разрешений ролей см. в разделе Роли и разрешения .

Дополнительные примеры поиска строк запроса см. в разделе Примеры строк запроса файлов .

Условия запроса, относящиеся к общему диску

В следующей таблице перечислены все допустимые условия запроса на общий диск. Типы данных и описания см. в справочнике по ресурсам drives .

Термин запроса Допустимые операторы Использование параметр useDomainAdminAccess
createdTime <= , < , = , != , > , >= Дата создания общего диска. Формат RFC 3339 , часовой пояс по умолчанию — UTC, например 2012-06-04T12:00:00-08:00 . true
hidden = , != Указывает, скрыт ли общий диск. Может быть либо true , либо false . false
memberCount <= , < , = , != , > , >= Количество пользователей и групп, являющихся участниками общего диска. Принимает числовое значение. true
name contains , = , != Имя общего диска. Окружите одинарными кавычками ( ' ). Экранируйте одинарные кавычки в запросах с помощью \' , например 'Valentine\'s Day' . true
organizerCount <= , < , = , != , > , >= Количество пользователей и групп, являющихся организаторами общего диска. Принимает числовое значение. true
orgUnitId = , != Идентификатор организационного подразделения общего диска. Принимает строковое значение. true

Дополнительные примеры поиска по строке запроса см. в разделе Примеры строк запроса на общий диск .