Отображает список общих дисков пользователя.
Этот метод принимает параметр q , представляющий собой поисковый запрос, объединяющий один или несколько поисковых терминов. Для получения дополнительной информации см. руководство по поиску общих дисков .
HTTP-запрос
GET https://www.googleapis.com/drive/v3/drives
В URL-адресе используется синтаксис транскодирования gRPC .
Параметры запроса
| Параметры | |
|---|---|
pageSize | Максимальное количество общих дисков, которое может быть возвращено. Сервис может вернуть меньшее количество. Если не указано иное, будет возвращено не более 10 общих дисков. Максимальное значение — 100; значения выше 100 будут принудительно уменьшены до 100. |
pageToken | Токен страницы для общих дисков. |
q | Строка запроса для поиска на общих дисках. |
useDomainAdminAccess | Отправьте запрос от имени администратора домена; если установлено значение true, то будут возвращены все общие диски домена, в котором отправитель запроса является администратором. |
Текст запроса
Тело запроса должно быть пустым.
Ответный текст
Список общих дисков.
В случае успеха тело ответа содержит данные следующей структуры:
| JSON-представление |
|---|
{
"drives": [
{
object ( |
| Поля | |
|---|---|
drives[] | Список общих дисков. Если поле nextPageToken заполнено, этот список может быть неполным, и потребуется дополнительная страница результатов. |
nextPageToken | Токен страницы для перехода на следующую страницу общих дисков. Он будет отсутствовать, если список завершен. Если токен отклонен по какой-либо причине, его следует удалить, и постраничная навигация должна быть начата заново с первой страницы результатов. Токен страницы обычно действителен в течение нескольких часов. Однако, если добавляются или удаляются новые элементы, ожидаемые результаты могут отличаться. |
kind | Определяет тип ресурса. Значение: фиксированная строка |
Области полномочий
Требуется один из следующих диапазонов аутентификации OAuth:
-
https://www.googleapis.com/auth/drive -
https://www.googleapis.com/auth/drive.readonly
Некоторые области действия ограничены и требуют проведения оценки безопасности для их использования вашим приложением. Для получения дополнительной информации см. руководство по авторизации .