ContactKeyClient

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

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")
fun getAllE2eeContactKeys(lookupKey: String): Task<E2eeContactKeyListParcelable>

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")
fun getAllE2eeSelfKeys(): Task<E2eeSelfKeyListParcelable>

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")
fun getAllOwnerE2eeAccountContactKeys(): Task<ImmutableList<E2eeAccountContactKeyParcelable>>

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")
fun getAllOwnerE2eeContactKeys(): Task<E2eeContactKeyListParcelable>

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")
fun getE2eeAccountKeysForAccount(accountId: String): Task<ImmutableList<E2eeAccountContactKeyParcelable>>

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")
fun getE2eeContactKey(lookupKey: String, deviceId: String, accountId: String): Task<E2eeContactKeyParcelable?>

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")
fun getE2eeSelfKey(deviceId: String, accountId: String): Task<E2eeSelfKeyParcelable?>

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.

fun getMaxKeySizeBytes(): Task<Int>

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

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

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")
fun getOwnerE2eeContactKeys(lookupKey: String): Task<E2eeContactKeyListParcelable>

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")
fun getOwnerE2eeSelfKeys(): Task<E2eeSelfKeyListParcelable>

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

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

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

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

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

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

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

fun isEnabled(): Task<Boolean>

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")
fun registerAccountContactKeysListener(
    accountIds: List<String>,
    listener: OnAccountContactKeysUpdatedListener
): Task<Void>

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")
fun removeE2eeAccountContactKey(deviceId: String, accountId: String): Task<Void>

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")
fun removeE2eeContactKey(
    lookupKey: String,
    deviceId: String,
    accountId: String
): Task<Void>

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

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

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
fun unregisterAccountContactKeysListener(
    listener: OnAccountContactKeysUpdatedListener
): Task<Boolean>

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"])
fun updateAllE2eeAccountKeys(accountKeyInfos: List<E2eeAccountKeyInfo>): Task<Void>

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"])
fun updateOrInsertE2eeContactKey(
    lookupKey: String,
    deviceId: String,
    accountId: String,
    keyValue: ByteArray
): Task<Void>

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"])
fun updateOrInsertE2eeContactKey(
    lookupKeys: List<String>,
    deviceId: String,
    accountId: String,
    keyValue: ByteArray
): Task<Void>

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")
fun updateOrInsertE2eeSelfKey(
    deviceId: String,
    accountId: String,
    keyValue: ByteArray
): Task<Void>

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à.