Method: alerts.list

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

列出快訊。

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

查詢參數

參數
customerId

string

選用，與快訊相關聯之 Google Workspace 帳戶的專屬 ID。customerId 必須移除初始的「C」(例如 046psxkn)，如未提供呼叫者推論。查看您的客戶 ID。
pageSize

integer

選用，要求的頁面大小。伺服器傳回的項目數量可能會少於要求的項目。如未指定，伺服器會選擇適當的預設值。
pageToken

string

選用，權杖，用於識別伺服器應傳回的結果頁面。如果空白，就會開始新的疊代作業。如要繼續疊代，請傳入前一個 ListAlertsResponse 的 nextPageToken 欄位中的值。
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