Чтобы найти определенный набор общих дисков, используйте поле строки запроса q с drives.list , чтобы отфильтровать возвращаемые диски, объединив один или несколько поисковых терминов.
Строка запроса состоит из следующих трех частей:
query_term operator values
Где:
query_term— термин запроса или поле для поиска.operatorзадает условие для термина запроса.values— это конкретные значения, которые вы хотите использовать для фильтрации результатов поиска.
Чтобы просмотреть условия запроса и операторы, которые можно использовать для фильтрации общих дисков, см. раздел Условия поиска и операторы .
Например, следующая строка запроса фильтрует поиск, возвращая только общие диски с названием «Ресурсы API Google Диска».
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 Диска оценивает операторы and и or слева направо, поэтому тот же поиск без скобок вернет:
- Только общие диски с более чем пятью организаторами, созданные после 1 января 2019 года.
- Все общие диски с более чем 20 участниками, даже те, которые были созданы до 1 января 2019 года.