Method: alerts.list

Liệt kê các cảnh báo.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số truy vấn

Tham số
customerId

string

Không bắt buộc. Mã nhận dạng duy nhất của tài khoản Google Workspace của khách hàng liên kết với cảnh báo. customerId phải có chữ "C" ở đầu bị xoá (ví dụ: 046psxkn). Được suy ra từ danh tính người gọi nếu không được cung cấp. Tìm mã khách hàng của bạn.

pageSize

integer

Không bắt buộc. Kích thước trang được yêu cầu. Máy chủ có thể trả về ít mục hơn số lượng yêu cầu. Nếu bạn chưa chỉ định, máy chủ sẽ chọn một chế độ mặc định phù hợp.

pageToken

string

Không bắt buộc. Mã thông báo xác định một trang kết quả mà máy chủ sẽ trả về. Nếu giá trị trống thì một vòng lặp mới sẽ được bắt đầu. Để tiếp tục lặp lại, hãy truyền giá trị từ trường nextPageToken của ListAlertsResponse trước đó.

filter

string

Không bắt buộc. Chuỗi truy vấn để lọc kết quả cảnh báo. Để biết thêm thông tin chi tiết, hãy xem Bộ lọc cụm từ tìm kiếmCác trường bộ lọc cụm từ tìm kiếm được hỗ trợ.

orderBy

string

Không bắt buộc. Thứ tự sắp xếp của danh sách kết quả. Nếu không được chỉ định, kết quả có thể được trả về theo thứ tự tuỳ ý. Bạn có thể sắp xếp kết quả theo thứ tự giảm dần dựa trên dấu thời gian tạo bằng orderBy="createTime desc". Hiện tại, các chế độ sắp xếp được hỗ trợ là createTime asc, createTime desc, updateTime desc

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Nội dung phản hồi

Tin nhắn phản hồi cho yêu cầu liệt kê cảnh báo.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON
{
  "alerts": [
    {
      object (Alert)
    }
  ],
  "nextPageToken": string
}
Trường
alerts[]

object (Alert)

Danh sách cảnh báo.

nextPageToken

string

Mã thông báo cho trang tiếp theo. Nếu giá trị này không trống, thì trạng thái này cho biết có thể còn nhiều cảnh báo khác phù hợp với yêu cầu trang thông tin; bạn có thể sử dụng giá trị này trong ListAlertsRequest tiếp theo để nhận cảnh báo tiếp tục từ kết quả gần đây nhất của lệnh gọi danh sách hiện tại.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem Hướng dẫn uỷ quyền.