擷取用戶端加密身分設定。
如果管理員要為機構中的使用者管理身分和金鑰組,則必須使用服務帳戶授權要求,該帳戶必須具備全網域委派授權,才能以 https://www.googleapis.com/auth/gmail.settings.basic 範圍模擬使用者。
如果使用者自行管理身分和金鑰組,則必須開啟並設定硬體金鑰加密功能,才能提出要求。
HTTP 要求
GET https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/cse/identities/{cseEmailAddress}
這個網址使用 gRPC 轉碼語法。
路徑參數
| 參數 | |
|---|---|
userId |
要求者的主要電子郵件地址。如要指出已驗證的使用者,可以使用特殊值 |
cseEmailAddress |
與擷取的用戶端加密身分設定相關聯的主要電子郵件地址。 |
要求主體
要求主體必須為空白。
回應主體
如果成功,回應主體會包含 CseIdentity 的執行個體。
授權範圍
需要下列其中一種 OAuth 範圍:
https://www.googleapis.com/auth/gmail.settings.basichttps://mail.google.com/https://www.googleapis.com/auth/gmail.modifyhttps://www.googleapis.com/auth/gmail.readonlyhttps://www.googleapis.com/auth/gmail.settings.sharing
詳情請參閱OAuth 2.0 Overview。