ContactKeyClient

@RequiresPermission(value = "android.permission.READ_CONTACTS")
fun getAccountContactKeysFlow(accountIds: List<String>): Flow<List<E2eeAccountContactKeyParcelable>>

Returns a flow of account contact keys updates.

The flow will emit when any key for any accountId provided is updated, added, or removed. It will emit the list of all keys for the provided accountIds, not just the ones that were updated.

@RequiresPermission(value = "android.permission.READ_CONTACTS")
fun getAllE2eeContactKeys(lookupKey: String): Task<E2eeContactKeyListParcelable>

Retrieves all end-to-end encryption contact key entries that belong to apps visible to the caller. The keys will be stripped of deviceId, timeUpdated and keyValue data.

@RequiresPermission(value = "android.permission.READ_CONTACTS")
fun getAllE2eeSelfKeys(): Task<E2eeSelfKeyListParcelable>

Returns all end-to-end encryption self key entries that belong to apps visible to the caller. The keys will be stripped of deviceId, timeUpdated and keyValue data.

@RequiresPermission(value = "android.permission.READ_CONTACTS")
fun getAllOwnerE2eeAccountContactKeys(): Task<ImmutableList<E2eeAccountContactKeyParcelable>>

Retrieves all end-to-end encryption account contact keys that belong to the caller app, whether they are associated with a contact or not.

@RequiresPermission(value = "android.permission.READ_CONTACTS")
fun getAllOwnerE2eeContactKeys(): Task<E2eeContactKeyListParcelable>

Retrieves all end-to-end encryption contact keys that belong to the caller app, across all contacts.

This method should be used to only retrieve keys that have at least one contact associated with them. If you need to retrieve keys that are not associated with any contacts, use getAllOwnerE2eeAccountContactKeys instead.

@RequiresPermission(value = "android.permission.READ_CONTACTS")
fun getE2eeAccountKeysForAccount(accountId: String): Task<ImmutableList<E2eeAccountContactKeyParcelable>>

Retrieves all end-to-end encryption contact key entries that belong to the caller app and the caller's account, across all contacts. Includes keys not associated with any contact.

@RequiresPermission(value = "android.permission.READ_CONTACTS")
fun getE2eeContactKey(lookupKey: String, deviceId: String, accountId: String): Task<E2eeContactKeyParcelable?>

Retrieves an end-to-end encryption contact key entry given the lookupKey, deviceId, accountId and inferred caller package name.

@RequiresPermission(value = "android.permission.READ_CONTACTS")
fun getE2eeSelfKey(deviceId: String, accountId: String): Task<E2eeSelfKeyParcelable?>

Returns an end-to-end encryption self key entry given the deviceId, accountId and the inferred package name of the caller.

fun getMaxKeySizeBytes(): Task<Int>

Returns the maximum allowed size of a key in bytes.

fun getOnboardingIntent(
    nextActivity: OnboardingNextActivity,
    lookupKey: String?,
    packageName: String?
): Task<PendingIntent>

Returns an intent to show the Onboarding activity, and marks that the Onboarding has been shown on this device. This requires a nextActivity, which can be either the string show or scan. If scan, the lookupKey of the contact to scan for is required.

@RequiresPermission(value = "android.permission.READ_CONTACTS")
fun getOwnerE2eeContactKeys(lookupKey: String): Task<E2eeContactKeyListParcelable>

Retrieves all end-to-end encryption contact key entries for a given lookupKey that belong to the caller app.

@RequiresPermission(value = "android.permission.READ_CONTACTS")
fun getOwnerE2eeSelfKeys(): Task<E2eeSelfKeyListParcelable>

Returns all end-to-end encryption self key entries that are owned by the caller app.

fun getScanQrCodeIntent(lookupKey: String, skipOnboarding: Boolean = false): Task<PendingIntent>

Returns an intent to the "Scan QR Code" activity.

fun getScanQrCodeIntentForAccount(packageName: String, accountId: String): Task<PendingIntent>

Returns an intent to the "Scan QR Code" activity for a specific account.

fun getShowQrCodeIntent(packageName: String?, skipOnboarding: Boolean = false): Task<PendingIntent>

Returns an intent to the "Show QR Code" activity.

fun isEnabled(): Task<Boolean>

Returns a Task that completes successfully whether the API is available or not.

If the API is available, the returned task will have a true result, and false otherwise.

Exceptions typically thrown when the API is unavailable will be caught and a task successfully returning false will be returned instead.

@RequiresPermission(value = "android.permission.READ_CONTACTS")
fun registerAccountContactKeysListener(
    accountIds: List<String>,
    listener: OnAccountContactKeysUpdatedListener
): Task<Void>

Registers a listener for account contact keys updates.

The listener will be called when any key for any accountId provided is updated, added, or removed. It will be called with the list of all keys for the provided accountIds, not just the ones that were updated.

@RequiresPermission(value = "android.permission.WRITE_CONTACTS")
fun removeE2eeAccountContactKey(deviceId: String, accountId: String): Task<Void>

Removes an end-to-end encryption account contact key entry that belongs to the caller app.

@RequiresPermission(value = "android.permission.WRITE_CONTACTS")
fun removeE2eeContactKey(
    lookupKey: String,
    deviceId: String,
    accountId: String
): Task<Void>

Removes an end-to-end encryption contact key entry that belongs to the caller app.

@RequiresPermission(value = "android.permission.WRITE_CONTACTS")
fun removeE2eeSelfKey(deviceId: String, accountId: String): Task<Void>

Removes an end-to-end encryption self key entry given the deviceId and the inferred package name of the caller.

@CanIgnoreReturnValue
fun unregisterAccountContactKeysListener(
    listener: OnAccountContactKeysUpdatedListener
): Task<Boolean>

Unregisters a listener for account contact keys updates.

@RequiresPermission(allOf = ["android.permission.READ_CONTACTS", "android.permission.WRITE_CONTACTS"])
fun updateAllE2eeAccountKeys(accountKeyInfos: List<E2eeAccountKeyInfo>): Task<Void>

Inserts a batch of account contact keys.

Behaves similarly to updateOrInsertE2eeContactKey, but allows for multiple keys to be inserted/updated at once. Each key is inserted in its own transaction, so some keys may be inserted even if the task throws an exception.

Clients may choose to handle temporary failures by resending the whole batch, as this API will not affect the status of already-inserted keys.

For each key, if a lookupKey is provided but the contact basic info (displayName, phoneNumber, emailAddress)is not, this API will also attempt to retrieve the contact's name, phone number, and email address from the Contacts Provider. When retrieving the key, contact management apps should use this information to make sure that the key is only used for the contact that it was intended for.

The Android Key Verification app stores this information on-device and only exposes it to API callers that hold the READ_CONTACTS permission.

If no lookupKey is provided for a key, this API will store a key that is not tied to any contact.

@RequiresPermission(allOf = ["android.permission.READ_CONTACTS", "android.permission.WRITE_CONTACTS"])
fun updateOrInsertE2eeContactKey(
    lookupKey: String,
    deviceId: String,
    accountId: String,
    keyValue: ByteArray
): Task<Void>

Inserts a new entry into the end-to-end encryption contact keys table or updates one if it already exists. The inserted/updated end-to-end encryption contact key is owned by the caller app.

This API will also store the contact's name, phone number, and email address from the Contacts Provider, alongside the key. When retrieving the key, contact management apps should use this information to make sure that the key is only used for the contact that it was intended for.

The Android Key Verification app stores this information on-device and only exposes it to API callers that hold the READ_CONTACTS permission.

@RequiresPermission(allOf = ["android.permission.READ_CONTACTS", "android.permission.WRITE_CONTACTS"])
fun updateOrInsertE2eeContactKey(
    lookupKeys: List<String>,
    deviceId: String,
    accountId: String,
    keyValue: ByteArray
): Task<Void>

Inserts a new entry into the end-to-end encryption contact keys table or updates one if it already exists. The inserted/updated end-to-end encryption contact key is owned by the caller app.

For each provided lookup key, this API will also store the contact's name, phone number, and email address from the Contacts Provider, alongside the key. When retrieving the key, contact management apps should use this information to make sure that the key is only used for the contact that it was intended for.

The Android Key Verification app stores this information on-device and only exposes it to API callers that hold the READ_CONTACTS permission.

If the list of lookup keys is empty, this API will store a key that is not associated with any contact.

Calling this API with one or more lookup keys will update the key metadata to associate it with the provided contacts, but will not remove any existing associations for contacts that are not provided in the list. To remove an association between a contact and a key, call removeE2eeContactKey with the appropriate lookup key.

@RequiresPermission(value = "android.permission.WRITE_CONTACTS")
fun updateOrInsertE2eeSelfKey(
    deviceId: String,
    accountId: String,
    keyValue: ByteArray
): Task<Void>

Inserts a new entry into the end-to-end encryption self keys table or updates one if it already exists.