ContactKeyClient

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

Renvoie un flux de mises à jour des clés de contact du compte.

Le flux est émis lorsqu'une clé pour un accountId fourni est mise à jour, ajoutée ou supprimée. Elle émettra la liste de toutes les clés pour les accountId fournis, et pas seulement celles qui ont été mises à jour.

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

Récupère toutes les entrées de clé de contact de chiffrement de bout en bout appartenant aux applications visibles par l'appelant. Les données deviceId, timeUpdated et keyValue seront supprimées des clés.

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

Renvoie toutes les entrées de clé auto-chiffrée de bout en bout appartenant aux applications visibles par l'appelant. Les données deviceId, timeUpdated et keyValue seront supprimées des clés.

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

Récupère toutes les clés de contact de compte de chiffrement de bout en bout appartenant à l'application d'appel, qu'elles soient associées ou non à un contact.

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

Récupère toutes les clés de contact de chiffrement de bout en bout appartenant à l'application appelante, pour tous les contacts.

Cette méthode ne doit être utilisée que pour récupérer les clés auxquelles au moins un contact est associé. Si vous devez récupérer des clés qui ne sont associées à aucun contact, utilisez plutôt getAllOwnerE2eeAccountContactKeys.

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

Récupère toutes les entrées de clé de contact de chiffrement de bout en bout qui appartiennent à l'application appelante et au compte de l'appelant, pour tous les contacts. Inclut les clés non associées à un contact.

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

Récupère une entrée de clé de contact de chiffrement de bout en bout en fonction de lookupKey, deviceId, accountId et du nom du package de l'appelant inféré.

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

Renvoie une entrée de clé auto-chiffrée de bout en bout en fonction de deviceId, accountId et du nom de package inféré de l'appelant.

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

Renvoie la taille maximale autorisée d'une clé en octets.

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

Renvoie une intention d'afficher l'activité d'intégration et indique que l'intégration a été affichée sur cet appareil. Cela nécessite un nextActivity, qui peut être la chaîne show ou scan. Si la valeur est scan, le lookupKey du contact à rechercher est obligatoire.

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

Récupère toutes les entrées de clé de contact de chiffrement de bout en bout pour un lookupKey donné appartenant à l'application appelante.

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

Renvoie toutes les entrées de clé de chiffrement de bout en bout appartenant à l'application appelante.

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

Renvoie un intent à l'activité "Scan QR Code".

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

Renvoie un intent à l'activité "Scanner le code QR" pour un compte spécifique.

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

Renvoie un intent à l'activité "Afficher le code QR".

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

Renvoie une tâche qui se termine correctement, que l'API soit disponible ou non.

Si l'API est disponible, la tâche renvoyée aura un résultat "true", sinon "false".

Les exceptions généralement générées lorsque l'API n'est pas disponible seront interceptées et une tâche renvoyant la valeur "false" sera renvoyée à la place.

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

Enregistre un écouteur pour les mises à jour des clés de contact du compte.

L'écouteur sera appelé lorsqu'une clé pour un accountId fourni est mise à jour, ajoutée ou supprimée. Elle sera appelée avec la liste de toutes les clés pour les accountIds fournis, et pas seulement celles qui ont été mises à jour.

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

Supprime une entrée de clé de contact de compte de chiffrement de bout en bout appartenant à l'application appelante.

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

Supprime une entrée de clé de contact de chiffrement de bout en bout appartenant à l'application appelante.

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

Supprime une entrée de clé auto-chiffrée de bout en bout en fonction de l'ID de l'appareil et du nom de package inféré de l'appelant.

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

Désenregistre un écouteur pour les mises à jour des clés de contact du compte.

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

Insère un lot de clés de contact de compte.

Se comporte de la même manière que updateOrInsertE2eeContactKey, mais permet d'insérer/mettre à jour plusieurs clés à la fois. Chaque clé est insérée dans sa propre transaction. Il est donc possible que certaines clés soient insérées même si la tâche génère une exception.

Les clients peuvent choisir de gérer les échecs temporaires en renvoyant l'intégralité du lot, car cette API n'affectera pas l'état des clés déjà insérées.

Pour chaque clé, si une lookupKey est fournie, mais que les informations de base du contact (displayName, phoneNumber, emailAddress) ne le sont pas, cette API tentera également de récupérer le nom, le numéro de téléphone et l'adresse e-mail du contact auprès du fournisseur de contacts. Lors de la récupération de la clé, les applications de gestion des contacts doivent utiliser ces informations pour s'assurer que la clé n'est utilisée que pour le contact auquel elle est destinée.

L'application Android Key Verification stocke ces informations sur l'appareil et ne les expose qu'aux appelants d'API disposant de l'autorisation READ_CONTACTS.

Si aucune lookupKey n'est fournie pour une clé, cette API stocke une clé qui n'est associée à aucun contact.

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

Insère une nouvelle entrée dans la table des clés de contact pour le chiffrement de bout en bout ou met à jour une entrée si elle existe déjà. La clé de contact de chiffrement de bout en bout insérée/mise à jour appartient à l'application appelante.

Cette API stockera également le nom, le numéro de téléphone et l'adresse e-mail du contact à partir du fournisseur de contacts, en plus de la clé. Lors de la récupération de la clé, les applications de gestion des contacts doivent utiliser ces informations pour s'assurer que la clé n'est utilisée que pour le contact auquel elle est destinée.

L'application Android Key Verification stocke ces informations sur l'appareil et ne les expose qu'aux appelants d'API disposant de l'autorisation 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
)

Insère une nouvelle entrée dans la table des clés de contact pour le chiffrement de bout en bout ou met à jour une entrée si elle existe déjà. La clé de contact de chiffrement de bout en bout insérée/mise à jour appartient à l'application appelante.

Pour chaque clé de recherche fournie, cette API stocke également le nom, le numéro de téléphone et l'adresse e-mail du contact à partir du fournisseur de contacts, en plus de la clé. Lors de la récupération de la clé, les applications de gestion des contacts doivent utiliser ces informations pour s'assurer que la clé n'est utilisée que pour le contact auquel elle est destinée.

L'application Android Key Verification stocke ces informations sur l'appareil et ne les expose qu'aux appelants d'API disposant de l'autorisation READ_CONTACTS.

Si la liste des clés de recherche est vide, cette API stocke une clé qui n'est associée à aucun contact.

Si vous appelez cette API avec une ou plusieurs clés de recherche, les métadonnées de la clé seront mises à jour pour l'associer aux contacts fournis. Toutefois, les associations existantes pour les contacts qui ne figurent pas dans la liste ne seront pas supprimées. Pour supprimer l'association entre un contact et une clé, appelez removeE2eeContactKey avec la clé de recherche appropriée.

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

Insère une nouvelle entrée dans la table des clés auto-chiffrées de bout en bout ou en met à jour une si elle existe déjà.