Для поиска определенного набора общих дисков используйте поле запроса q с drives.list , чтобы отфильтровать возвращаемые диски, комбинируя один или несколько поисковых запросов.
Запросная строка состоит из следующих трех частей:
query_term operator values
Где:
query_term— это поисковый запрос или поле, по которому будет производиться поиск.operatorзадает условие для поискового запроса.values— это конкретные значения, которые вы хотите использовать для фильтрации результатов поиска.
Чтобы просмотреть поисковые запросы и операторы, которые можно использовать для фильтрации общих дисков, см. раздел «Поисковые запросы и операторы» .
Например, следующая строка запроса фильтрует поиск, чтобы возвращать только общие диски с именем "Ресурсы API Google Drive".
q: name = 'Google Drive API resources' & useDomainAdminAccess=false
Примеры строк запроса
В таблице ниже приведены примеры некоторых базовых строк запроса для общих дисков. Фактический код может отличаться в зависимости от используемой клиентской библиотеки для поиска.
Для корректной работы запроса необходимо также экранировать специальные символы в именах файлов. Например, если имя файла содержит как апостроф ( ' ), так и обратную косую черту ( "\" ), используйте обратную косую черту для их экранирования: name contains 'quinn\'s paper\\essay' .
| Что вы хотите запросить | Пример | параметр useDomainAdminAccess |
|---|---|---|
| Общие диски, созданные после 1 июня 2017 года. | createdTime > '2017-06-01T12:00:00' | true |
| Общие диски, отображаемые в представлении по умолчанию. | hidden = false | false |
| Совместное использование дисков более чем одним пользователем. | memberCount > 1 | true |
| Общие диски, в названии которых содержится слово «конфиденциально», и на которых зарегистрировано 20 или более пользователей. | name contains 'confidential' and memberCount >= 20 | true |
| Среди всех общих дисков организации обнаружены диски, в названии которых содержится слово «конфиденциально». | name contains 'confidential' and orgUnitId = 'C03az79cb' | true |
| Среди всех общих дисков, участником которых является пользователь, отображаются общие диски, в названии которых содержится слово «конфиденциально». | name contains 'confidential' | false |
| Общие диски без назначенного организатора | organizerCount = 0 | true |
| Общие диски, не содержащие идентификатор организационной единицы. | orgUnitId != 'C03az79cb' | true |
Запрос нескольких терминов в скобках
Для группировки нескольких поисковых запросов можно использовать скобки. Например, чтобы найти общие диски, созданные после определенной даты и имеющие более пяти организаторов или более 20 участников, используйте следующий запрос:
createdTime > '2019-01-01T12:00:00' and (organizerCount > 5 or
memberCount > 20)
В результате поиска будут найдены все общие диски, созданные после 1 января 2019 года, которые имеют более пяти организаторов или более 20 участников.
API Google Drive обрабатывает операторы and » и or слева направо, поэтому тот же поиск без скобок вернет следующий результат:
- Доступ к общим дискам предоставлялся только более чем пяти организаторам, созданным после 1 января 2019 года.
- Все общие диски, на которых размещено более 20 пользователей, даже те, которые были созданы до 1 января 2019 года.