Чтобы найти определенный набор общих дисков, используйте поле строки запроса 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 Drive оценивает операторы and и or слева направо, поэтому тот же поиск без круглых скобок вернет следующий результат:
- Только общие диски с более чем пятью организаторами, созданные после 1 января 2019 года.
- Все общие диски с более чем 20 участниками, даже созданные до 1 января 2019 года.