ContactKeyClient

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

Retorna um fluxo de atualizações de chaves de contato da conta.

O fluxo será emitido quando qualquer chave de qualquer accountId fornecido for atualizada, adicionada ou removida. Ele vai emitir a lista de todas as chaves para os accountIds fornecidos, não apenas as que foram atualizadas.

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

Recupera todas as entradas de chave de contato de criptografia de ponta a ponta pertencentes a apps visíveis para o autor da chamada. As chaves serão removidas dos dados de deviceId, timeUpdated e keyValue.

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

Retorna todas as entradas de chave própria de criptografia de ponta a ponta pertencentes a apps visíveis para o autor da chamada. As chaves serão removidas dos dados de deviceId, timeUpdated e keyValue.

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

Recupera todas as chaves de contato da conta de criptografia de ponta a ponta que pertencem ao app de chamada, estejam elas associadas a um contato ou não.

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

Recupera todas as chaves de contato de criptografia de ponta a ponta que pertencem ao app de chamada em todos os contatos.

Esse método deve ser usado apenas para recuperar chaves que tenham pelo menos um contato associado a elas. Se você precisar recuperar chaves que não estão associadas a nenhum contato, use getAllOwnerE2eeAccountContactKeys.

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

Recupera todas as entradas de chave de contato de criptografia de ponta a ponta que pertencem ao app e à conta do autor da chamada em todos os contatos. Inclui chaves não associadas a nenhum contato.

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

Recupera uma entrada de chave de contato de criptografia de ponta a ponta com base no lookupKey, deviceId, accountId e no nome do pacote do autor da chamada inferido.

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

Retorna uma entrada de chave própria de criptografia de ponta a ponta com base no deviceId, no accountId e no nome do pacote inferido do autor da chamada.

fun getMaxKeySizeBytes(): Task<Int>

Retorna o tamanho máximo permitido de uma chave em bytes.

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

Retorna uma intent para mostrar a atividade de integração e marca que a integração foi mostrada neste dispositivo. Isso requer um nextActivity, que pode ser a string show ou scan. Se scan, o lookupKey do contato a ser verificado é obrigatório.

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

Recupera todas as entradas de chave de contato de criptografia de ponta a ponta para um determinado lookupKey que pertence ao app de chamada.

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

Retorna todas as entradas de chave própria de criptografia de ponta a ponta pertencentes ao app de chamada.

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

Retorna uma intent para a atividade "Ler o QR code".

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

Retorna uma intent para a atividade "Ler o QR code" de uma conta específica.

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

Retorna uma intent para a atividade "Mostrar QR code".

fun isEnabled(): Task<Boolean>

Retorna uma tarefa que é concluída com êxito, esteja a API disponível ou não.

Se a API estiver disponível, a tarefa retornada terá um resultado verdadeiro. Caso contrário, será falso.

As exceções normalmente geradas quando a API está indisponível serão capturadas, e uma tarefa que retorna "false" será retornada.

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

Registra um listener para atualizações de chaves de contato da conta.

O listener será chamado quando qualquer chave de qualquer accountId fornecido for atualizada, adicionada ou removida. Ela será chamada com a lista de todas as chaves dos accountIds fornecidos, não apenas as que foram atualizadas.

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

Remove uma entrada de chave de contato da conta de criptografia de ponta a ponta pertencente ao app de chamada.

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

Remove uma entrada de chave de contato de criptografia de ponta a ponta pertencente ao app de chamada.

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

Remove uma entrada de chave própria de criptografia de ponta a ponta usando o deviceId e o nome do pacote inferido do caller.

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

Cancela o registro de um listener para atualizações de chaves de contato da conta.

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

Insere um lote de chaves de contato da conta.

Funciona de maneira semelhante a updateOrInsertE2eeContactKey, mas permite que várias chaves sejam inseridas/atualizadas de uma só vez. Cada chave é inserida em uma transação própria. Portanto, algumas chaves podem ser inseridas mesmo que a tarefa gere uma exceção.

Os clientes podem optar por lidar com falhas temporárias reenviando todo o lote, já que essa API não afeta o status das chaves já inseridas.

Para cada chave, se um lookupKey for fornecido, mas as informações básicas do contato (displayName, phoneNumber, emailAddress) não forem, essa API também tentará recuperar o nome, o número de telefone e o endereço de e-mail do contato do provedor de contatos. Ao recuperar a chave, os apps de gerenciamento de contatos precisam usar essas informações para garantir que ela seja usada apenas para o contato a que se destina.

O app Android Key Verification armazena essas informações no dispositivo e as expõe apenas para chamadores de API que têm a permissão READ_CONTACTS.

Se nenhuma lookupKey for fornecida para uma chave, essa API vai armazenar uma chave que não está vinculada a nenhum contato.

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

Insere uma nova entrada na tabela de chaves de contato de criptografia de ponta a ponta ou atualiza uma se ela já existir. A chave de contato de criptografia de ponta a ponta inserida/atualizada pertence ao app autor da chamada.

Essa API também armazena o nome, o número de telefone e o endereço de e-mail do contato do Provedor de contatos, além da chave. Ao recuperar a chave, os apps de gerenciamento de contatos precisam usar essas informações para garantir que ela seja usada apenas para o contato a que se destina.

O app Android Key Verification armazena essas informações no dispositivo e as expõe apenas para chamadores de API que têm a permissão READ_CONTACTS.

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

Insere uma nova entrada na tabela de chaves de contato de criptografia de ponta a ponta ou atualiza uma se ela já existir. A chave de contato de criptografia de ponta a ponta inserida/atualizada pertence ao app autor da chamada.

Para cada chave de pesquisa fornecida, essa API também armazena o nome, o número de telefone e o endereço de e-mail do contato do Provedor de contatos, junto com a chave. Ao recuperar a chave, os apps de gerenciamento de contatos precisam usar essas informações para garantir que ela seja usada apenas para o contato a que se destina.

O app Android Key Verification armazena essas informações no dispositivo e as expõe apenas para chamadores de API que têm a permissão READ_CONTACTS.

Se a lista de chaves de pesquisa estiver vazia, essa API vai armazenar uma chave que não está associada a nenhum contato.

Chamar essa API com uma ou mais chaves de pesquisa vai atualizar os metadados da chave para associá-la aos contatos fornecidos, mas não vai remover associações existentes para contatos que não estão na lista. Para remover uma associação entre um contato e uma chave, chame removeE2eeContactKey com a chave de pesquisa apropriada.

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

Insere uma nova entrada na tabela de autochaves de criptografia de ponta a ponta ou atualiza uma se ela já existir.