Gmail API . users . settings . cse . identities

close()

Close httplib2 connections.

create(userId, body=None, x__xgafv=None)

Creates and configures a client-side encryption identity that's authorized to send mail from the user account. Google publishes the S/MIME certificate to a shared domain-wide directory so that people within a Google Workspace organization can encrypt and send mail to the identity.

Args:
  userId: string, The requester's primary email address. To indicate the authenticated user, you can use the special value `me`. (required)
  body: object, The request body.
    The object takes the form of:

{ # The 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.
  "emailAddress": "A String", # The email address for the sending identity. The email address must be the primary email address of the authenticated user.
  "primaryKeyPairId": "A String", # If a key pair is associated, the ID of the key pair, CseKeyPair.
  "signAndEncryptKeyPairs": { # The configuration of a CSE identity that uses different key pairs for signing and encryption. # The configuration of a CSE identity that uses different key pairs for signing and encryption.
    "encryptionKeyPairId": "A String", # The ID of the CseKeyPair that encrypts signed outgoing mail.
    "signingKeyPairId": "A String", # The ID of the CseKeyPair that signs outgoing mail.
  },
}

  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # The 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.
  "emailAddress": "A String", # The email address for the sending identity. The email address must be the primary email address of the authenticated user.
  "primaryKeyPairId": "A String", # If a key pair is associated, the ID of the key pair, CseKeyPair.
  "signAndEncryptKeyPairs": { # The configuration of a CSE identity that uses different key pairs for signing and encryption. # The configuration of a CSE identity that uses different key pairs for signing and encryption.
    "encryptionKeyPairId": "A String", # The ID of the CseKeyPair that encrypts signed outgoing mail.
    "signingKeyPairId": "A String", # The ID of the CseKeyPair that signs outgoing mail.
  },
}

delete(userId, cseEmailAddress, x__xgafv=None)

Deletes a client-side encryption identity. The authenticated user can no longer use the identity to send encrypted messages. You cannot restore the identity after you delete it. Instead, use the CreateCseIdentity method to create another identity with the same configuration.

Args:
  userId: string, The requester's primary email address. To indicate the authenticated user, you can use the special value `me`. (required)
  cseEmailAddress: string, The primary email address associated with the client-side encryption identity configuration that's removed. (required)
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

get(userId, cseEmailAddress, x__xgafv=None)

Retrieves a client-side encryption identity configuration.

Args:
  userId: string, The requester's primary email address. To indicate the authenticated user, you can use the special value `me`. (required)
  cseEmailAddress: string, The primary email address associated with the client-side encryption identity configuration that's retrieved. (required)
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # The 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.
  "emailAddress": "A String", # The email address for the sending identity. The email address must be the primary email address of the authenticated user.
  "primaryKeyPairId": "A String", # If a key pair is associated, the ID of the key pair, CseKeyPair.
  "signAndEncryptKeyPairs": { # The configuration of a CSE identity that uses different key pairs for signing and encryption. # The configuration of a CSE identity that uses different key pairs for signing and encryption.
    "encryptionKeyPairId": "A String", # The ID of the CseKeyPair that encrypts signed outgoing mail.
    "signingKeyPairId": "A String", # The ID of the CseKeyPair that signs outgoing mail.
  },
}

list(userId, pageSize=None, pageToken=None, x__xgafv=None)

Lists the client-side encrypted identities for an authenticated user.

Args:
  userId: string, The requester's primary email address. To indicate the authenticated user, you can use the special value `me`. (required)
  pageSize: integer, The number of identities to return. If not provided, the page size will default to 20 entries.
  pageToken: string, Pagination token indicating which page of identities to return. If the token is not supplied, then the API will return the first page of results.
  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    {
  "cseIdentities": [ # One page of the list of CSE identities configured for the user.
    { # The 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.
      "emailAddress": "A String", # The email address for the sending identity. The email address must be the primary email address of the authenticated user.
      "primaryKeyPairId": "A String", # If a key pair is associated, the ID of the key pair, CseKeyPair.
      "signAndEncryptKeyPairs": { # The configuration of a CSE identity that uses different key pairs for signing and encryption. # The configuration of a CSE identity that uses different key pairs for signing and encryption.
        "encryptionKeyPairId": "A String", # The ID of the CseKeyPair that encrypts signed outgoing mail.
        "signingKeyPairId": "A String", # The ID of the CseKeyPair that signs outgoing mail.
      },
    },
  ],
  "nextPageToken": "A String", # Pagination token to be passed to a subsequent ListCseIdentities call in order to retrieve the next page of identities. If this value is not returned or is the empty string, then no further pages remain.
}

list_next()

Retrieves the next page of results.

        Args:
          previous_request: The request for the previous page. (required)
          previous_response: The response from the request for the previous page. (required)

        Returns:
          A request object that you can call 'execute()' on to request the next
          page. Returns None if there are no more items in the collection.
        

patch(userId, emailAddress, body=None, x__xgafv=None)

Associates a different key pair with an existing client-side encryption identity. The updated key pair must validate against Google's [S/MIME certificate profiles](https://support.google.com/a/answer/7300887).

Args:
  userId: string, The requester's primary email address. To indicate the authenticated user, you can use the special value `me`. (required)
  emailAddress: string, The email address of the client-side encryption identity to update. (required)
  body: object, The request body.
    The object takes the form of:

{ # The 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.
  "emailAddress": "A String", # The email address for the sending identity. The email address must be the primary email address of the authenticated user.
  "primaryKeyPairId": "A String", # If a key pair is associated, the ID of the key pair, CseKeyPair.
  "signAndEncryptKeyPairs": { # The configuration of a CSE identity that uses different key pairs for signing and encryption. # The configuration of a CSE identity that uses different key pairs for signing and encryption.
    "encryptionKeyPairId": "A String", # The ID of the CseKeyPair that encrypts signed outgoing mail.
    "signingKeyPairId": "A String", # The ID of the CseKeyPair that signs outgoing mail.
  },
}

  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # The 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.
  "emailAddress": "A String", # The email address for the sending identity. The email address must be the primary email address of the authenticated user.
  "primaryKeyPairId": "A String", # If a key pair is associated, the ID of the key pair, CseKeyPair.
  "signAndEncryptKeyPairs": { # The configuration of a CSE identity that uses different key pairs for signing and encryption. # The configuration of a CSE identity that uses different key pairs for signing and encryption.
    "encryptionKeyPairId": "A String", # The ID of the CseKeyPair that encrypts signed outgoing mail.
    "signingKeyPairId": "A String", # The ID of the CseKeyPair that signs outgoing mail.
  },
}