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

В этом справочном руководстве представлены поисковые запросы и операторы, которые можно использовать с 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

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