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

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

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

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

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

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

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 документа содержит строку «Hello there world», то запрос 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

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