ContactKeyClient

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

Devuelve un flujo de actualizaciones de claves de contacto de la cuenta.

El flujo se emitirá cuando se actualice, agregue o quite cualquier clave para cualquier accountId proporcionado. Se emitirá la lista de todas las claves para los accountIds proporcionados, no solo las que se actualizaron.

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

Recupera todas las entradas de claves de contacto de encriptación de extremo a extremo que pertenecen a las apps visibles para la persona que llama. Las claves se despojarán de los datos de deviceId, timeUpdated y keyValue.

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

Devuelve todas las entradas de claves propias de encriptación de extremo a extremo que pertenecen a las apps visibles para la persona que llama. Las claves se despojarán de los datos de deviceId, timeUpdated y keyValue.

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

Recupera todas las claves de contacto de la cuenta de encriptación de extremo a extremo que pertenecen a la app que llama, ya sea que estén asociadas a un contacto o no.

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

Recupera todas las claves de contacto de encriptación de extremo a extremo que pertenecen a la app de llamada, en todos los contactos.

Este método solo debe usarse para recuperar claves que tengan al menos un contacto asociado. Si necesitas recuperar claves que no están asociadas a ningún contacto, usa getAllOwnerE2eeAccountContactKeys.

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

Recupera todas las entradas de claves de contacto de encriptación de extremo a extremo que pertenecen a la app de llamada y a la cuenta del llamador, en todos los contactos. Incluye las llaves que no están asociadas a ningún contacto.

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

Recupera una entrada de clave de contacto de encriptación de extremo a extremo a partir de lookupKey, deviceId, accountId y el nombre del paquete de la persona que llama inferido.

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

Devuelve una entrada de clave propia de encriptación de extremo a extremo, dados el deviceId, el accountId y el nombre del paquete inferido del llamador.

abstract @NonNull Task<@NonNull Integer> getMaxKeySizeBytes()

Devuelve el tamaño máximo permitido de una clave en bytes.

abstract @NonNull Task<@NonNull PendingIntent> getOnboardingIntent(
    @NonNull OnboardingNextActivity nextActivity,
    String lookupKey,
    String packageName
)

Devuelve un intent para mostrar la actividad de Onboarding y marca que se mostró Onboarding en este dispositivo. Esto requiere un nextActivity, que puede ser la cadena show o scan. Si es scan, se requiere el lookupKey del contacto que se buscará.

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

Recupera todas las entradas de claves de contacto de encriptación de extremo a extremo para un lookupKey determinado que pertenece a la app que realiza la llamada.

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

Devuelve todas las entradas de la clave propia de encriptación de extremo a extremo que son propiedad de la app que realiza la llamada.

abstract @NonNull Task<@NonNull PendingIntent> getScanQrCodeIntent(@NonNull String lookupKey, boolean skipOnboarding)

Devuelve un intent para la actividad "Escanear código QR".

abstract @NonNull Task<@NonNull PendingIntent> getScanQrCodeIntentForAccount(
    @NonNull String packageName,
    @NonNull String accountId
)

Devuelve un intent para la actividad "Escanear código QR" de una cuenta específica.

abstract @NonNull Task<@NonNull PendingIntent> getShowQrCodeIntent(String packageName, boolean skipOnboarding)

Devuelve un intent para la actividad "Mostrar código QR".

abstract @NonNull Task<@NonNull Boolean> isEnabled()

Devuelve una tarea que se completa correctamente, ya sea que la API esté disponible o no.

Si la API está disponible, la tarea devuelta tendrá un resultado verdadero; de lo contrario, será falso.

Las excepciones que suelen generarse cuando la API no está disponible se detectarán y, en su lugar, se devolverá una tarea que muestre el valor falso de forma correcta.

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

Registra un objeto de escucha para las actualizaciones de las claves de contacto de la cuenta.

Se llamará al objeto de escucha cuando se actualice, agregue o quite cualquier clave para cualquier accountId proporcionado. Se llamará con la lista de todas las claves para los accountIds proporcionados, no solo las que se actualizaron.

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

Quita una entrada de clave de contacto de la cuenta de encriptación de extremo a extremo que pertenece a la app que realiza la llamada.

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

Quita una entrada de clave de contacto de encriptación de extremo a extremo que pertenece a la app de llamada.

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

Quita una entrada de clave propia de encriptación de extremo a extremo, dado el deviceId y el nombre del paquete inferido del llamador.

@CanIgnoreReturnValue
abstract @NonNull Task<@NonNull Boolean> unregisterAccountContactKeysListener(
    @NonNull OnAccountContactKeysUpdatedListener listener
)

Anula el registro de un objeto de escucha para las actualizaciones de las claves de contacto de la cuenta.

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

Inserta un lote de claves de contacto de la cuenta.

Se comporta de manera similar a updateOrInsertE2eeContactKey, pero permite insertar o actualizar varias claves a la vez. Cada clave se inserta en su propia transacción, por lo que es posible que se inserten algunas claves incluso si la tarea arroja una excepción.

Los clientes pueden optar por controlar las fallas temporales reenviando todo el lote, ya que esta API no afectará el estado de las claves ya insertadas.

Para cada clave, si se proporciona un lookupKey, pero no se proporciona la información básica del contacto (displayName, phoneNumber, emailAddress), esta API también intentará recuperar el nombre, el número de teléfono y la dirección de correo electrónico del contacto del proveedor de contactos. Cuando recuperen la clave, las apps de administración de contactos deben usar esta información para asegurarse de que la clave solo se use para el contacto para el que se creó.

La app de Android Key Verification almacena esta información en el dispositivo y solo la expone a los llamadores de la API que tienen el permiso READ_CONTACTS.

Si no se proporciona ningún lookupKey para una clave, esta API almacenará una clave que no esté vinculada a ningún contacto.

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

Inserta una entrada nueva en la tabla de claves de contacto de encriptación de extremo a extremo o actualiza una si ya existe. La app que llama es propietaria de la clave de contacto de encriptación de extremo a extremo insertada o actualizada.

Esta API también almacenará el nombre, el número de teléfono y la dirección de correo electrónico del contacto del proveedor de contactos, junto con la clave. Cuando recuperen la clave, las apps de administración de contactos deben usar esta información para asegurarse de que la clave solo se use para el contacto para el que se creó.

La app de Android Key Verification almacena esta información en el dispositivo y solo la expone a los llamadores de la API que tienen el permiso READ_CONTACTS.

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

Inserta una entrada nueva en la tabla de claves de contacto de encriptación de extremo a extremo o actualiza una si ya existe. La app que llama es propietaria de la clave de contacto de encriptación de extremo a extremo insertada o actualizada.

Para cada clave de búsqueda proporcionada, esta API también almacenará el nombre, el número de teléfono y la dirección de correo electrónico del contacto del proveedor de contactos, junto con la clave. Cuando recuperen la clave, las apps de administración de contactos deben usar esta información para asegurarse de que la clave solo se use para el contacto para el que se creó.

La app de Android Key Verification almacena esta información en el dispositivo y solo la expone a los llamadores de la API que tienen el permiso READ_CONTACTS.

Si la lista de claves de búsqueda está vacía, esta API almacenará una clave que no esté asociada a ningún contacto.

Si llamas a esta API con una o más claves de búsqueda, se actualizarán los metadatos de la clave para asociarla con los contactos proporcionados, pero no se quitarán las asociaciones existentes para los contactos que no se proporcionen en la lista. Para quitar la asociación entre un contacto y una clave, llama a removeE2eeContactKey con la clave de búsqueda adecuada.

@RequiresPermission(value = "android.permission.WRITE_CONTACTS")
abstract @NonNull Task<@NonNull Void> updateOrInsertE2eeSelfKey(
    @NonNull String deviceId,
    @NonNull String accountId,
    @NonNull byte[] keyValue
)

Inserta una entrada nueva en la tabla de claves propias de encriptación de extremo a extremo o actualiza una si ya existe.