Чтобы найти определенный набор общих дисков, используйте поле строки запроса 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 года.