Method: alerts.list

Список предупреждений.

HTTP-запрос

GET https://alertcenter.googleapis.com/v1beta1/alerts

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

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

Параметры
customerId

string

Необязательный. Уникальный идентификатор аккаунта Google Workspace клиента, с которым связаны оповещения. В customerId должна быть удалена начальная буква «C» (например, 046psxkn ). Выводится из идентификатора вызывающего абонента, если он не указан. Найдите свой идентификатор клиента .

pageSize

integer

Необязательный. Запрошенный размер страницы. Сервер может вернуть меньше элементов, чем запрошено. Если не указано, сервер выбирает соответствующее значение по умолчанию.

pageToken

string

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

filter

string

Необязательный. Строка запроса для фильтрации результатов предупреждений. Дополнительные сведения см. в разделах Фильтры запросов и Поддерживаемые поля фильтров запросов .

orderBy

string

Необязательный. Порядок сортировки результатов списка. Если не указано, результаты могут быть возвращены в произвольном порядке. Вы можете отсортировать результаты в порядке убывания на основе метки времени создания, используя orderBy="createTime desc" . В настоящее время поддерживается сортировка createTime asc , createTime desc , updateTime desc

Тело запроса

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

Тело ответа

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

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

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

object ( Alert )

Список предупреждений.

nextPageToken

string

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

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

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/apps.alerts

Дополнительные сведения см. в руководстве по авторизации .