ContactKeyClient

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

Restituisce un flusso di aggiornamenti delle chiavi di contatto dell'account.

Il flusso viene emesso quando una chiave per un accountId fornito viene aggiornata, aggiunta o rimossa. Verrà emesso l'elenco di tutte le chiavi per gli account ID forniti, non solo di quelle aggiornate.

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

Recupera tutte le voci della chiave di contatto con crittografia end-to-end appartenenti alle app visibili al chiamante. Le chiavi verranno private dei dati deviceId, timeUpdated e keyValue.

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

Restituisce tutte le voci della chiave automatica di crittografia end-to-end appartenenti ad app visibili al chiamante. Le chiavi verranno private dei dati deviceId, timeUpdated e keyValue.

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

Recupera tutte le chiavi di contatto dell'account con crittografia end-to-end appartenenti all'app chiamante, indipendentemente dal fatto che siano associate o meno a un contatto.

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

Recupera tutte le chiavi di contatto con crittografia end-to-end appartenenti all'app chiamante, per tutti i contatti.

Questo metodo deve essere utilizzato solo per recuperare le chiavi a cui è associato almeno un contatto. Se devi recuperare chiavi non associate ad alcun contatto, utilizza getAllOwnerE2eeAccountContactKeys.

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

Recupera tutte le voci della chiave di contatto con crittografia end-to-end appartenenti all'app chiamante e all'account del chiamante, per tutti i contatti. Include le chiavi non associate ad alcun contatto.

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

Recupera una voce della chiave di contatto con crittografia end-to-end dato il lookupKey, il deviceId, il accountId e il nome del pacchetto del chiamante dedotto.

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

Restituisce una voce di chiave automatica di crittografia end-to-end dato deviceId, accountId e il nome del pacchetto dedotto del chiamante.

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

Restituisce la dimensione massima consentita di una chiave in byte.

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

Restituisce un intent per mostrare l'attività di onboarding e indica che l'onboarding è stato mostrato su questo dispositivo. Ciò richiede un nextActivity, che può essere la stringa show o scan. Se scan, è necessario l'lookupKey del contatto da cercare.

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

Recupera tutte le voci della chiave di contatto con crittografia end-to-end per un determinato lookupKey appartenente all'app chiamante.

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

Restituisce tutte le voci della chiave automatica di crittografia end-to-end di proprietà dell'app chiamante.

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

Restituisce un intent all'attività "Scansiona codice QR".

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

Restituisce un intent all'attività "Scansiona codice QR" per un account specifico.

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

Restituisce un intent all'attività "Mostra codice QR".

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

Restituisce un'attività che viene completata correttamente indipendentemente dalla disponibilità dell'API.

Se l'API è disponibile, l'attività restituita avrà un risultato true, altrimenti false.

Le eccezioni in genere generate quando l'API non è disponibile verranno rilevate e verrà restituita un'attività che restituisce correttamente false.

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

Registra un listener per gli aggiornamenti delle chiavi di contatto dell'account.

Il listener verrà chiamato quando una chiave per qualsiasi accountId fornito viene aggiornata, aggiunta o rimossa. Verrà chiamato con l'elenco di tutte le chiavi per gli accountIds forniti, non solo quelle aggiornate.

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

Rimuove una voce della chiave di contatto dell'account con crittografia end-to-end appartenente all'app chiamante.

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

Rimuove una voce della chiave di contatto con crittografia end-to-end appartenente all'app chiamante.

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

Rimuove una voce della chiave automatica di crittografia end-to-end dato il deviceId e il nome del pacchetto dedotto del chiamante.

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

Annulla la registrazione di un listener per gli aggiornamenti delle chiavi di contatto dell'account.

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

Inserisce un batch di chiavi di contatto dell'account.

Si comporta in modo simile a updateOrInsertE2eeContactKey, ma consente di inserire/aggiornare più chiavi contemporaneamente. Ogni chiave viene inserita nella propria transazione, quindi alcune chiavi potrebbero essere inserite anche se l'attività genera un'eccezione.

I client possono scegliere di gestire gli errori temporanei inviando nuovamente l'intero batch, in quanto questa API non influirà sullo stato delle chiavi già inserite.

Per ogni chiave, se viene fornita una lookupKey, ma non le informazioni di base del contatto (displayName, phoneNumber, emailAddress), questa API tenterà anche di recuperare il nome, il numero di telefono e l'indirizzo email del contatto dal provider di contatti. Quando recuperano la chiave, le app di gestione dei contatti devono utilizzare queste informazioni per assicurarsi che la chiave venga utilizzata solo per il contatto a cui è destinata.

L'app Android Key Verification memorizza queste informazioni sul dispositivo e le espone solo ai chiamanti API che dispongono dell'autorizzazione READ_CONTACTS.

Se non viene fornita alcuna lookupKey per una chiave, questa API memorizzerà una chiave non associata ad alcun contatto.

@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
)

Inserisce una nuova voce nella tabella delle chiavi di contatto per la crittografia end-to-end o ne aggiorna una se esiste già. La chiave di contatto con crittografia end-to-end inserita/aggiornata è di proprietà dell'app chiamante.

Questa API memorizzerà anche il nome, il numero di telefono e l'indirizzo email del contatto dal provider di contatti, insieme alla chiave. Quando recuperano la chiave, le app di gestione dei contatti devono utilizzare queste informazioni per assicurarsi che la chiave venga utilizzata solo per il contatto a cui è destinata.

L'app Android Key Verification memorizza queste informazioni sul dispositivo e le espone solo ai chiamanti API che dispongono dell'autorizzazione 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
)

Inserisce una nuova voce nella tabella delle chiavi di contatto per la crittografia end-to-end o ne aggiorna una se esiste già. La chiave di contatto con crittografia end-to-end inserita/aggiornata è di proprietà dell'app chiamante.

Per ogni chiave di ricerca fornita, questa API memorizzerà anche il nome, il numero di telefono e l'indirizzo email del contatto dal provider di contatti, insieme alla chiave. Quando recuperano la chiave, le app di gestione dei contatti devono utilizzare queste informazioni per assicurarsi che la chiave venga utilizzata solo per il contatto a cui è destinata.

L'app Android Key Verification memorizza queste informazioni sul dispositivo e le espone solo ai chiamanti API che dispongono dell'autorizzazione READ_CONTACTS.

Se l'elenco delle chiavi di ricerca è vuoto, questa API memorizzerà una chiave non associata ad alcun contatto.

La chiamata di questa API con una o più chiavi di ricerca aggiornerà i metadati della chiave per associarla ai contatti forniti, ma non rimuoverà le associazioni esistenti per i contatti non forniti nell'elenco. Per rimuovere un'associazione tra un contatto e una chiave, chiama removeE2eeContactKey con la chiave di ricerca appropriata.

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

Inserisce una nuova voce nella tabella delle chiavi self-service per la crittografia end-to-end o ne aggiorna una se esiste già.