Method: users.settings.cse.identities.list

列出已驗證使用者的用戶端加密身分。

HTTP 要求

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

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

路徑參數

參數
userId

string

要求者的主要電子郵件地址。如要表示已驗證的使用者，可以使用特殊值 me。

查詢參數

參數
pageToken

string

分頁權杖，用於指出要傳回哪個身分頁面。如果未提供憑證，API 會傳回第一頁的結果。
pageSize

integer

要傳回的識別資訊數量。如果未提供，則頁面大小會預設為 20 個項目。

要求主體

要求主體必須為空白。

回應主體

如果成功，回應主體即會包含具有以下結構的資料：

JSON 表示法 
{
  "cseIdentities": [
    {
      object (CseIdentity)
    }
  ],
  "nextPageToken": string
}
欄位
cseIdentities[]

object (CseIdentity)

為使用者設定的 CSE 身分清單的一頁。
nextPageToken

string

要傳遞至後續的 Identity.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

詳情請參閱授權指南。