Method: files.listLabels

Выводит список меток файла. Подробнее см. в разделе Список меток файла .

HTTP-запрос

GET https://www.googleapis.com/drive/v3/files/{fileId}/listLabels

URL использует синтаксис перекодировки gRPC .

Параметры пути

Параметры
fileId

string

Идентификатор файла.

Параметры запроса

Параметры
maxResults

integer

Максимальное количество меток, возвращаемых на страницу. Если не задано, по умолчанию используется значение 100.

pageToken

string

Токен для продолжения предыдущего запроса списка на следующей странице. Значение должно быть равно значению nextPageToken из предыдущего ответа.

Текст запроса

Тело запроса должно быть пустым.

Тело ответа

Список меток, примененных к файлу.

В случае успеха тело ответа содержит данные со следующей структурой:

JSON-представление 
{
  "labels": [
    {
      object (Label)
    }
  ],
  "nextPageToken": string,
  "kind": string
}
Поля
labels[]

object ( Label )

Список этикеток.

nextPageToken

string

Токен страницы для следующей страницы с метками. Это поле будет отсутствовать, если достигнут конец списка. Если токен по какой-либо причине отклонён, его следует удалить, а пагинацию следует перезапустить с первой страницы результатов. Токен страницы обычно действителен в течение нескольких часов. Однако при добавлении или удалении новых элементов ожидаемые результаты могут отличаться.

kind

string

Это всегда "drive#labelList" .

Области авторизации

Требуется одна из следующих областей OAuth:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.meet.readonly
  • https://www.googleapis.com/auth/drive.metadata
  • https://www.googleapis.com/auth/drive.metadata.readonly
  • https://www.googleapis.com/auth/drive.readonly

Некоторые области действия ограничены, и для их использования вашему приложению требуется оценка безопасности. Подробнее см. в руководстве по авторизации .