列出已驗證使用者的用戶端加密身分。
HTTP 要求
GET https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/cse/identities
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
userId |
要求者的主要電子郵件地址。如要指定已通過驗證的使用者,您可以使用特殊值 |
查詢參數
參數 | |
---|---|
pageToken |
分頁符記,用於指出要傳回哪個身分頁面。如未提供憑證,API 會傳回第一頁結果。 |
pageSize |
要傳回的身分數量。如果未提供,頁面大小將預設為 20 個項目。 |
要求主體
要求主體必須為空白。
回應主體
如果成功,回應主體即會包含具有以下結構的資料:
JSON 表示法 |
---|
{
"cseIdentities": [
{
object ( |
欄位 | |
---|---|
cseIdentities[] |
為使用者設定的 CSE 身分清單頁面。 |
nextPageToken |
要傳遞至後續 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
詳情請參閱授權指南。