REST Resource: users.settings.cse.identities
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Kaynak: CseIdentity
Kimliği doğrulanmış bir kullanıcının e-posta adresi için istemci tarafı şifreleme (İTŞ) yapılandırması. Gmail, istemci tarafında şifrelenmiş e-posta iletilerinin taslaklarını kaydetmek ve şifrelenmiş e-posta iletilerini imzalayıp göndermek için İTŞ yapılandırmalarını kullanır.
Kuruluşlarındaki kullanıcıların kimliklerini ve anahtar çiftlerini yöneten yöneticiler, https://www.googleapis.com/auth/gmail.settings.basic kapsamıyla kullanıcıların kimliğine bürünmek için alan genelinde yetkilendirme yetkisine sahip bir hizmet hesabı ile yetkilendirme gerektirir.
Kendi kimliklerini ve anahtar çiftlerini yöneten kullanıcılar için isteklerin gönderilebilmesi için donanım anahtarı şifrelemesinin etkinleştirilip yapılandırılması gerekir.
| JSON gösterimi |
{
"emailAddress": string,
// Union field key_pair_configuration can be only one of the following:
"primaryKeyPairId": string,
"signAndEncryptKeyPairs": {
object (SignAndEncryptKeyPairs)
}
// End of list of possible types for union field key_pair_configuration.
} |
| Alanlar |
emailAddress |
string
Gönderen kimliğinin e-posta adresi. E-posta adresi, kimliği doğrulanmış kullanıcının birincil e-posta adresi olmalıdır.
|
Birlik alanı key_pair_configuration. key_pair_configuration yalnızca aşağıdakilerden biri olabilir:
|
primaryKeyPairId |
string
Bir anahtar çifti ilişkilendirilmişse CseKeyPair anahtar çiftinin kimliğidir.
|
signAndEncryptKeyPairs |
object (SignAndEncryptKeyPairs)
İmzalama ve şifreleme için farklı anahtar çiftleri kullanan bir İTŞ kimliğinin yapılandırması.
|
SignAndEncryptKeyPairs
İmzalama ve şifreleme için farklı anahtar çiftleri kullanan bir İTŞ kimliğinin yapılandırması.
| JSON gösterimi |
{
"signingKeyPairId": string,
"encryptionKeyPairId": string
} |
| Alanlar |
signingKeyPairId |
string
Giden postayı imzalayan CseKeyPair kimliği.
|
encryptionKeyPairId |
string
İmzalı giden postayı şifreleyen CseKeyPair öğesinin kimliği.
|
Yöntemler |
|
|
Kullanıcı hesabından posta gönderme yetkisi olan bir istemci tarafı şifreleme kimliği oluşturur ve yapılandırır. |
|
|
İstemci tarafı şifreleme kimliğini siler. |
|
|
İstemci tarafı şifreleme kimlik yapılandırmasını alır. |
|
|
Kimliği doğrulanmış bir kullanıcının istemci tarafında şifrelenmiş kimliklerini listeler. |
|
|
Mevcut bir istemci tarafı şifreleme kimliğiyle farklı bir anahtar çifti ilişkilendirir. |
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-25 UTC.
[null,null,["Son güncelleme tarihi: 2025-07-25 UTC."],[],[],null,["# REST Resource: users.settings.cse.identities\n\n- [Resource: CseIdentity](#CseIdentity)\n - [JSON representation](#CseIdentity.SCHEMA_REPRESENTATION)\n- [SignAndEncryptKeyPairs](#SignAndEncryptKeyPairs)\n - [JSON representation](#SignAndEncryptKeyPairs.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: CseIdentity\n---------------------\n\nThe client-side encryption (CSE) configuration for the email address of an authenticated user. Gmail uses CSE configurations to save drafts of client-side encrypted email messages, and to sign and send encrypted email messages.\n\nFor administrators managing identities and keypairs for users in their organization, requests require authorization with a [service account](https://developers.google.com/identity/protocols/OAuth2ServiceAccount) that has [domain-wide delegation authority](https://developers.google.com/identity/protocols/OAuth2ServiceAccount#delegatingauthority) to impersonate users with the `https://www.googleapis.com/auth/gmail.settings.basic` scope.\n\nFor users managing their own identities and keypairs, requests require [hardware key encryption](https://support.google.com/a/answer/14153163) turned on and configured.\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"emailAddress\": string, // Union field `key_pair_configuration` can be only one of the following: \"primaryKeyPairId\": string, \"signAndEncryptKeyPairs\": { object (/workspace/gmail/api/reference/rest/v1/users.settings.cse.identities#SignAndEncryptKeyPairs) } // End of list of possible types for union field `key_pair_configuration`. } ``` |\n\n| Fields ||\n|--------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `emailAddress` | `string` The email address for the sending identity. The email address must be the primary email address of the authenticated user. |\n| Union field `key_pair_configuration`. `key_pair_configuration` can be only one of the following: ||\n| `primaryKeyPairId` | `string` If a key pair is associated, the ID of the key pair, [CseKeyPair](/workspace/gmail/api/reference/rest/v1/users.settings.cse.keypairs#CseKeyPair). |\n| `signAndEncryptKeyPairs` | `object (`[SignAndEncryptKeyPairs](/workspace/gmail/api/reference/rest/v1/users.settings.cse.identities#SignAndEncryptKeyPairs)`)` The configuration of a CSE identity that uses different key pairs for signing and encryption. |\n\nSignAndEncryptKeyPairs\n----------------------\n\nThe configuration of a CSE identity that uses different key pairs for signing and encryption.\n\n| JSON representation |\n|-----------------------------------------------------------------------|\n| ``` { \"signingKeyPairId\": string, \"encryptionKeyPairId\": string } ``` |\n\n| Fields ||\n|-----------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `signingKeyPairId` | `string` The ID of the [CseKeyPair](/workspace/gmail/api/reference/rest/v1/users.settings.cse.keypairs#CseKeyPair) that signs outgoing mail. |\n| `encryptionKeyPairId` | `string` The ID of the [CseKeyPair](/workspace/gmail/api/reference/rest/v1/users.settings.cse.keypairs#CseKeyPair) that encrypts signed outgoing mail. |\n\n| Methods ------- ||\n|-------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------|\n| ### [create](/workspace/gmail/api/reference/rest/v1/users.settings.cse.identities/create) | Creates and configures a client-side encryption identity that's authorized to send mail from the user account. |\n| ### [delete](/workspace/gmail/api/reference/rest/v1/users.settings.cse.identities/delete) | Deletes a client-side encryption identity. |\n| ### [get](/workspace/gmail/api/reference/rest/v1/users.settings.cse.identities/get) | Retrieves a client-side encryption identity configuration. |\n| ### [list](/workspace/gmail/api/reference/rest/v1/users.settings.cse.identities/list) | Lists the client-side encrypted identities for an authenticated user. |\n| ### [patch](/workspace/gmail/api/reference/rest/v1/users.settings.cse.identities/patch) | Associates a different key pair with an existing client-side encryption identity. |"]]
