Method: users.sections.list

Список разделов, доступных пользователю чата. Разделы помогают пользователям группировать свои беседы и настраивать список разделов, отображаемых на панели навигации чата. Подробнее см. раздел «Создание и организация разделов в Google Chat» .

Требуется аутентификация пользователя с указанием области авторизации :

  • https://www.googleapis.com/auth/chat.users.sections
  • https://www.googleapis.com/auth/chat.users.sections.readonly

HTTP-запрос

GET https://chat.googleapis.com/v1/{parent=users/*}/sections

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

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

Параметры
parent

string

Обязательно. Родительский ресурс — это имя ресурса пользователя, которому принадлежит этот набор разделов. Поддерживается отображение разделов только для вызывающего пользователя. Чтобы сослаться на вызывающего пользователя, укажите один из следующих параметров:

  • Псевдоним me . Например, users/me .

  • Их электронный адрес в Workspace. Например, users/user@example.com .

  • Их идентификатор пользователя. Например, users/123456789 .

Формат: users/{user}

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

Параметры
pageSize

integer

Необязательный параметр. Максимальное количество возвращаемых разделов. Сервис может вернуть меньшее количество разделов.

Если не указано иное, будет возвращено не более 10 разделов.

Максимальное значение — 100. Если вы укажете значение больше 100, оно автоматически изменится на 100.

Отрицательные значения приводят к ошибке INVALID_ARGUMENT .

pageToken

string

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

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

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

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

Ответный текст

Ответное сообщение для отображения разделов списка.

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

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

object ( Section )

Разделы, предоставленные указанным пользователем.

nextPageToken

string

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

Области полномочий

Требуется один из следующих диапазонов аутентификации OAuth:

  • https://www.googleapis.com/auth/chat.users.sections
  • https://www.googleapis.com/auth/chat.users.sections.readonly

Для получения более подробной информации см. руководство по авторизации .