Method: users.settings.cse.identities.list

Перечисляет зашифрованные на стороне клиента идентификаторы для аутентифицированного пользователя.

Для администраторов, управляющих удостоверениями и парами ключей для пользователей в своей организации, запросы требуют авторизации с помощью учетной записи службы , имеющей полномочия делегирования полномочий на уровне домена для выдачи себя за пользователей с областью действия https://www.googleapis.com/auth/gmail.settings.basic .

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

HTTP-запрос

GET https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/cse/identities

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

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

Параметры
userId

string

Основной адрес электронной почты запрашивающего. Чтобы указать аутентифицированного пользователя, можно использовать специальное значение me .

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

Параметры
pageToken

string

Токен пагинации, указывающий, какую страницу идентификаторов возвращать. Если токен не указан, то API вернет первую страницу результатов.

pageSize

integer

Количество возвращаемых идентификаторов. Если не указано, размер страницы по умолчанию составит 20 записей.

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

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

Тело ответа

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

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

object ( CseIdentity )

Одна страница списка идентификаторов CSE, настроенных для пользователя.

nextPageToken

string

Токен пагинации, который будет передан в последующий вызов identities.list для извлечения следующей страницы идентификаторов. Если это значение не возвращается или представляет собой пустую строку, то дальнейших страниц не остается.

Области действия авторизации

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

  • https://www.googleapis.com/auth/gmail.settings.basic
  • https://mail.google.com/
  • https://www.googleapis.com/auth/gmail.modify
  • https://www.googleapis.com/auth/gmail.readonly
  • https://www.googleapis.com/auth/gmail.settings.sharing

Более подробную информацию см. в Руководстве по авторизации .