ContactKeyClient

interface ContactKeyClient : HasApiKey

यह Contact Key API के लिए क्लाइंट है.

खास जानकारी

सार्वजनिक फ़ंक्शन
Flow<List<E2eeAccountContactKeyParcelable>>
@RequiresPermission(value = "android.permission.READ_CONTACTS")
getAccountContactKeysFlow(accountIds: List<String>)

खाते के संपर्क की कुंजियों के अपडेट का फ़्लो दिखाता है.
Task<E2eeContactKeyListParcelable>
@RequiresPermission(value = "android.permission.READ_CONTACTS")
getAllE2eeContactKeys(lookupKey: String)

यह उन सभी एंड-टू-एंड एन्क्रिप्शन संपर्क कुंजी एंट्री को वापस लाता है जो कॉल करने वाले व्यक्ति को दिखने वाले ऐप्लिकेशन से जुड़ी होती हैं.
Task<E2eeSelfKeyListParcelable>
@RequiresPermission(value = "android.permission.READ_CONTACTS")
getAllE2eeSelfKeys()

यह उन सभी ऐप्लिकेशन के लिए, एंड-टू-एंड एन्क्रिप्शन की सेल्फ की एंट्री दिखाता है जो कॉल करने वाले व्यक्ति को दिखते हैं.
Task<ImmutableList<E2eeAccountContactKeyParcelable>>
@RequiresPermission(value = "android.permission.READ_CONTACTS")
getAllOwnerE2eeAccountContactKeys()

यह फ़ंक्शन, कॉल करने वाले ऐप्लिकेशन के सभी एंड-टू-एंड एन्क्रिप्शन खाते की संपर्क कुंजियां वापस लाता है. भले ही, वे किसी संपर्क से जुड़ी हों या नहीं.
Task<E2eeContactKeyListParcelable>
@RequiresPermission(value = "android.permission.READ_CONTACTS")
getAllOwnerE2eeContactKeys()

यह कॉलर ऐप्लिकेशन से जुड़ी, एंड-टू-एंड एन्क्रिप्शन वाली सभी संपर्क कुंजियां वापस पाता है. ये कुंजियां, सभी संपर्कों के लिए होती हैं.
Task<ImmutableList<E2eeAccountContactKeyParcelable>>
@RequiresPermission(value = "android.permission.READ_CONTACTS")
getE2eeAccountKeysForAccount(accountId: String)

यह फ़ंक्शन, कॉल करने वाले ऐप्लिकेशन और कॉल करने वाले के खाते से जुड़ी, एंड-टू-एंड एन्क्रिप्शन वाली संपर्क कुंजी की सभी एंट्री को वापस लाता है. ये एंट्री, सभी संपर्कों के लिए होती हैं.
Task<E2eeContactKeyParcelable?>
@RequiresPermission(value = "android.permission.READ_CONTACTS")
getE2eeContactKey(lookupKey: String, deviceId: String, accountId: String)

यह कुकी, एंड-टू-एंड एन्क्रिप्शन की सुविधा के लिए संपर्क कुंजी की एंट्री को वापस लाती है. इसके लिए, lookupKey, deviceId, accountId और कॉलर के पैकेज का अनुमानित नाम दिया जाता है.
Task<E2eeSelfKeyParcelable?>
@RequiresPermission(value = "android.permission.READ_CONTACTS")
getE2eeSelfKey(deviceId: String, accountId: String)

यह फ़ंक्शन, deviceId, accountId, और कॉल करने वाले का अनुमानित पैकेज का नाम दिए जाने पर, एंड-टू-एंड एन्क्रिप्शन (E2EE) की सुविधा के लिए खुद की कुंजी की एंट्री दिखाता है.
Task<Int>

यह फ़ंक्शन, किसी कुंजी के लिए ज़्यादा से ज़्यादा साइज़ को बाइट में दिखाता है.
Task<PendingIntent>
getOnboardingIntent(
    nextActivity: OnboardingNextActivity,
    lookupKey: String?,
    packageName: String?
)

यह फ़ंक्शन, ऑनबोर्डिंग गतिविधि दिखाने के लिए एक इंटेंट दिखाता है. साथ ही, यह मार्क करता है कि इस डिवाइस पर ऑनबोर्डिंग दिखाई गई है.
Task<E2eeContactKeyListParcelable>
@RequiresPermission(value = "android.permission.READ_CONTACTS")
getOwnerE2eeContactKeys(lookupKey: String)

यह फ़ंक्शन, कॉलर ऐप्लिकेशन से जुड़े किसी दिए गए lookupKey के लिए, एंड-टू-एंड एन्क्रिप्शन की सुविधा वाली संपर्क कुंजी की सभी एंट्री वापस लाता है.
Task<E2eeSelfKeyListParcelable>
@RequiresPermission(value = "android.permission.READ_CONTACTS")
getOwnerE2eeSelfKeys()

यह फ़ंक्शन, एंड-टू-एंड एन्क्रिप्शन की सुविधा के लिए खुद की कुंजी की उन सभी एंट्री को दिखाता है जिनका मालिकाना हक, कॉल करने वाले ऐप्लिकेशन के पास है.
Task<PendingIntent>
getScanQrCodeIntent(lookupKey: String, skipOnboarding: Boolean)

यह "क्यूआर कोड स्कैन करें" गतिविधि के लिए एक इंटेंट दिखाता है.
Task<PendingIntent>
getScanQrCodeIntentForAccount(packageName: String, accountId: String)

यह फ़ंक्शन, किसी खाते के लिए "क्यूआर कोड स्कैन करें" गतिविधि का इंटेंट दिखाता है.
Task<PendingIntent>
getShowQrCodeIntent(packageName: String?, skipOnboarding: Boolean)

यह "क्यूआर कोड दिखाएं" गतिविधि के लिए एक इंटेंट दिखाता है.
Task<Boolean>

यह एक ऐसा टास्क दिखाता है जो एपीआई उपलब्ध होने या न होने पर भी पूरा हो जाता है.
Task<Void>
@RequiresPermission(value = "android.permission.READ_CONTACTS")
registerAccountContactKeysListener(
    accountIds: List<String>,
    listener: OnAccountContactKeysUpdatedListener
)

यह कुकी, खाते से जुड़े संपर्क की कुंजियों के अपडेट के लिए लिसनर को रजिस्टर करती है.
Task<Void>
@RequiresPermission(value = "android.permission.WRITE_CONTACTS")
removeE2eeAccountContactKey(deviceId: String, accountId: String)

यह कॉलर ऐप्लिकेशन से जुड़ी, एंड-टू-एंड एन्क्रिप्शन की सुविधा वाले खाते की संपर्क कुंजी की एंट्री को हटाता है.
Task<Void>
@RequiresPermission(value = "android.permission.WRITE_CONTACTS")
removeE2eeContactKey(
    lookupKey: String,
    deviceId: String,
    accountId: String
)

यह कॉलर ऐप्लिकेशन से जुड़ी, पूरी तरह सुरक्षित (E2EE) की गई संपर्क कुंजी की एंट्री को हटाता है.
Task<Void>
@RequiresPermission(value = "android.permission.WRITE_CONTACTS")
removeE2eeSelfKey(deviceId: String, accountId: String)

यह डिवाइस आईडी और कॉल करने वाले व्यक्ति के पैकेज के अनुमानित नाम के आधार पर, एंड-टू-एंड एन्क्रिप्शन की सेल्फ की एंट्री को हटाता है.
Task<Boolean>

यह फ़ंक्शन, खाते के संपर्क कुंजी अपडेट के लिए लिसनर को अनरजिस्टर करता है.
Task<Void>
@RequiresPermission(allOf = ["android.permission.READ_CONTACTS", "android.permission.WRITE_CONTACTS"])
updateAllE2eeAccountKeys(accountKeyInfos: List<E2eeAccountKeyInfo>)

खाते के संपर्क की कुंजियों का बैच डालता है.
Task<Void>
@RequiresPermission(allOf = ["android.permission.READ_CONTACTS", "android.permission.WRITE_CONTACTS"])
updateOrInsertE2eeContactKey(
    lookupKey: String,
    deviceId: String,
    accountId: String,
    keyValue: ByteArray
)

यह फ़ंक्शन, एंड-टू-एंड एन्क्रिप्शन वाली संपर्क कुंजियों की टेबल में नई एंट्री डालता है. अगर कोई एंट्री पहले से मौजूद है, तो उसे अपडेट करता है.
Task<Void>
@RequiresPermission(allOf = ["android.permission.READ_CONTACTS", "android.permission.WRITE_CONTACTS"])
updateOrInsertE2eeContactKey(
    lookupKeys: List<String>,
    deviceId: String,
    accountId: String,
    keyValue: ByteArray
)

यह फ़ंक्शन, एंड-टू-एंड एन्क्रिप्शन वाली संपर्क कुंजियों की टेबल में नई एंट्री डालता है. अगर कोई एंट्री पहले से मौजूद है, तो उसे अपडेट करता है.
Task<Void>
@RequiresPermission(value = "android.permission.WRITE_CONTACTS")
updateOrInsertE2eeSelfKey(
    deviceId: String,
    accountId: String,
    keyValue: ByteArray
)

यह कुकी, एंड-टू-एंड एन्क्रिप्शन की सुविधा के लिए इस्तेमाल की जाने वाली सेल्फ़ की टेबल में नई एंट्री डालती है. अगर कोई एंट्री पहले से मौजूद है, तो यह उसे अपडेट करती है.

सार्वजनिक फ़ंक्शन

getAccountContactKeysFlow

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

खाते के संपर्क की कुंजियों के अपडेट का फ़्लो दिखाता है.

यह फ़्लो तब शुरू होगा, जब दिए गए किसी भी accountId के लिए कोई कुंजी अपडेट की जाएगी, जोड़ी जाएगी या हटाई जाएगी. यह दिए गए accountIds के लिए, सभी कुंजियों की सूची दिखाएगा. सिर्फ़ उन कुंजियों की सूची नहीं दिखाएगा जिन्हें अपडेट किया गया था.

पैरामीटर
accountIds: List<String>

उन खातों के आईडी की सूची जिनके अपडेट सुनने हैं.
रिटर्न
Flow<List<E2eeAccountContactKeyParcelable>>

यह एक ऐसा फ़्लो है जो दिए गए accountIds के लिए, E2eeAccountContactKeyParcelable की सूचियां तब भेजता है, जब कोई भी कुंजी अपडेट की जाती है, जोड़ी जाती है या हटाई जाती है.
थ्रो
com.google.android.libraries.sdkcoroutines.flow.CallbackChannelFullException

अगर कॉलबैक इवेंट को बहुत धीरे-धीरे प्रोसेस किया जाता है.

getAllE2eeContactKeys

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

यह उन सभी एंड-टू-एंड एन्क्रिप्शन संपर्क कुंजी एंट्री को वापस लाता है जो कॉल करने वाले व्यक्ति को दिखने वाले ऐप्लिकेशन से जुड़ी होती हैं. इन कुंजियों से deviceId, timeUpdated, और keyValue का डेटा हटा दिया जाएगा.

पैरामीटर
lookupKey: String

वह वैल्यू जो संपर्क को रेफ़रंस करती है
रिटर्न
Task<E2eeContactKeyListParcelable>

E2eeContactKeyListParcelable में एंड-टू-एंड एन्क्रिप्शन के लिए इस्तेमाल की जाने वाली संपर्क कुंजी की जानकारी वाली सूची होती है. अगर कोई कुंजी नहीं मिलती है, तो यह सूची खाली होती है.

getAllE2eeSelfKeys

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

यह उन सभी ऐप्लिकेशन के लिए, एंड-टू-एंड एन्क्रिप्शन की सेल्फ की एंट्री दिखाता है जो कॉल करने वाले व्यक्ति को दिखते हैं. इन कुंजियों से deviceId, timeUpdated, और keyValue का डेटा हटा दिया जाएगा.

रिटर्न
Task<E2eeSelfKeyListParcelable>

E2eeSelfKeyListParcelable में एंड-टू-एंड एन्क्रिप्शन के लिए इस्तेमाल की गई निजी कुंजी की जानकारी वाली सूची होती है. अगर कोई निजी कुंजी नहीं मिलती है, तो यह सूची खाली होती है.

getAllOwnerE2eeAccountContactKeys

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

यह फ़ंक्शन, कॉल करने वाले ऐप्लिकेशन के लिए, एंड-टू-एंड एन्क्रिप्शन की सुविधा वाले खाते की सभी संपर्क कुंजियां वापस लाता है. भले ही, वे किसी संपर्क से जुड़ी हों या नहीं.

रिटर्न
Task<ImmutableList<E2eeAccountContactKeyParcelable>>

E2eeAccountContactKeyParcelable ऑब्जेक्ट की सूची, जिसमें एंड-टू-एंड एन्क्रिप्शन के लिए संपर्क कुंजी की जानकारी होती है. अगर कोई कुंजी नहीं मिलती है, तो यह एक खाली सूची होती है.

getAllOwnerE2eeContactKeys

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

यह कॉलर ऐप्लिकेशन से जुड़ी, एंड-टू-एंड एन्क्रिप्शन वाली सभी संपर्क कुंजियां वापस पाता है. ये कुंजियां, सभी संपर्कों के लिए होती हैं.

इस तरीके का इस्तेमाल सिर्फ़ उन कुंजियों को वापस पाने के लिए किया जाना चाहिए जिनसे कम से कम एक संपर्क जुड़ा हो. अगर आपको ऐसी कुंजियां वापस लानी हैं जो किसी भी संपर्क से जुड़ी नहीं हैं, तो getAllOwnerE2eeAccountContactKeys का इस्तेमाल करें.

रिटर्न
Task<E2eeContactKeyListParcelable>

E2eeContactKeyListParcelable में एंड-टू-एंड एन्क्रिप्शन के लिए इस्तेमाल की जाने वाली संपर्क कुंजी की जानकारी वाली सूची होती है. अगर कोई कुंजी नहीं मिलती है, तो यह सूची खाली होती है.

getE2eeAccountKeysForAccount

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

यह फ़ंक्शन, कॉल करने वाले ऐप्लिकेशन और कॉल करने वाले के खाते से जुड़ी, एंड-टू-एंड एन्क्रिप्शन वाली संपर्क कुंजी की सभी एंट्री को वापस लाता है. ये एंट्री, सभी संपर्कों के लिए होती हैं. इसमें वे कुंजियां शामिल हैं जो किसी संपर्क से जुड़ी नहीं हैं.

रिटर्न
Task<ImmutableList<E2eeAccountContactKeyParcelable>>

E2eeAccountContactKeyParcelable ऑब्जेक्ट की सूची, जिसमें एंड-टू-एंड एन्क्रिप्शन के लिए संपर्क कुंजी की जानकारी होती है. अगर कोई कुंजी नहीं मिलती है, तो यह एक खाली सूची होती है.

getE2eeContactKey

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

यह कुकी, एंड-टू-एंड एन्क्रिप्शन की सुविधा के लिए संपर्क कुंजी की एंट्री को वापस लाती है. इसके लिए, lookupKey, deviceId, accountId और कॉल करने वाले व्यक्ति के पैकेज का अनुमानित नाम दिया जाता है.

पैरामीटर
lookupKey: String

वह वैल्यू जो संपर्क को रेफ़रंस करती है
deviceId: String

ऐप्लिकेशन के लिए डिवाइस का आइडेंटिफ़ायर
accountId: String

खाते के लिए, ऐप्लिकेशन के हिसाब से तय किया गया आइडेंटिफ़ायर
रिटर्न
Task<E2eeContactKeyParcelable?>

an E2eeContactKeyParcelable जिसमें संपर्क की मुख्य जानकारी शामिल होती है. अगर संपर्क की मुख्य जानकारी नहीं मिलती है, तो null.

getE2eeSelfKey

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

यह फ़ंक्शन, deviceId, accountId, और कॉल करने वाले का अनुमानित पैकेज का नाम दिए जाने पर, एंड-टू-एंड एन्क्रिप्शन (E2EE) की सुविधा के लिए खुद की कुंजी की एंट्री दिखाता है.

पैरामीटर
deviceId: String

ऐप्लिकेशन के लिए डिवाइस का आइडेंटिफ़ायर
accountId: String

खाते के लिए, ऐप्लिकेशन के हिसाब से तय किया गया आइडेंटिफ़ायर
रिटर्न
Task<E2eeSelfKeyParcelable?>

एक E2eeSelfKeyParcelable जिसमें एंड-टू-एंड एन्क्रिप्शन के लिए इस्तेमाल की गई सेल्फ की की जानकारी होती है. अगर कोई सेल्फ की नहीं मिलती है, तो यह वैल्यू शून्य होती है.

getMaxKeySizeBytes

fun getMaxKeySizeBytes(): Task<Int>

यह फ़ंक्शन, किसी कुंजी के लिए ज़्यादा से ज़्यादा साइज़ को बाइट में दिखाता है.

getOnboardingIntent

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

यह फ़ंक्शन, ऑनबोर्डिंग गतिविधि दिखाने के लिए एक इंटेंट दिखाता है. साथ ही, यह मार्क करता है कि इस डिवाइस पर ऑनबोर्डिंग दिखाई गई है. इसके लिए, nextActivity की ज़रूरत होती है. यह show या scan स्ट्रिंग हो सकता है. अगर scan है, तो स्कैन करने के लिए संपर्क की lookupKey ज़रूरी है.

पैरामीटर
nextActivity: OnboardingNextActivity

यह कुकी, ऑनबोर्डिंग गतिविधि के बाद दिखने वाली अगली गतिविधि के बारे में जानकारी सेव करती है. यह show या scan में से कोई एक होना चाहिए.
lookupKey: String?

वह वैल्यू जो संपर्क को रेफ़रंस करती है. अगर nextActivity की वैल्यू scan है, तो इसका इस्तेमाल करना ज़रूरी है.
packageName: String?

उस ऐप्लिकेशन का पैकेज नाम जिसकी कुंजियां ज़रूरी हैं (ज़रूरी नहीं).

getOwnerE2eeContactKeys

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

यह फ़ंक्शन, कॉलर ऐप्लिकेशन से जुड़े किसी दिए गए lookupKey के लिए, एंड-टू-एंड एन्क्रिप्शन की सुविधा वाली संपर्क कुंजी की सभी एंट्री वापस लाता है.

पैरामीटर
lookupKey: String

वह वैल्यू जो संपर्क को रेफ़रंस करती है
रिटर्न
Task<E2eeContactKeyListParcelable>

E2eeContactKeyListParcelable, जिसमें एंड-टू-एंड एन्क्रिप्शन के लिए संपर्क कुंजी की जानकारी वाली सूची होती है. अगर कोई कुंजी नहीं मिलती है, तो यह एक खाली सूची होती है.

getOwnerE2eeSelfKeys

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

यह फ़ंक्शन, एंड-टू-एंड एन्क्रिप्शन की सुविधा के लिए खुद की कुंजी की उन सभी एंट्री को दिखाता है जिनका मालिकाना हक, कॉल करने वाले ऐप्लिकेशन के पास है.

रिटर्न
Task<E2eeSelfKeyListParcelable>

E2eeSelfKeyListParcelable में एंड-टू-एंड एन्क्रिप्शन के लिए इस्तेमाल किए गए सेल्फ की की जानकारी होती है. अगर कोई सेल्फ की नहीं मिलती है, तो यह एक खाली सूची होती है.

getScanQrCodeIntent

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

यह "क्यूआर कोड स्कैन करें" गतिविधि के लिए एक इंटेंट दिखाता है.

पैरामीटर
lookupKey: String

वह वैल्यू जो संपर्क को रेफ़रंस करती है
skipOnboarding: Boolean = false

फ़िलहाल, इसका इस्तेमाल नहीं किया जाता है.

getScanQrCodeIntentForAccount

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

यह फ़ंक्शन, किसी खाते के लिए "क्यूआर कोड स्कैन करें" गतिविधि का इंटेंट दिखाता है.

पैरामीटर
packageName: String

उस खाते से जुड़ा पैकेज का नाम जिसकी पुष्टि उपयोगकर्ता को करनी है
accountId: String

वह खाता आईडी जिससे उपयोगकर्ता को अपने खाते की पुष्टि करानी है

getShowQrCodeIntent

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

यह "क्यूआर कोड दिखाएं" गतिविधि के लिए एक इंटेंट दिखाता है.

पैरामीटर
packageName: String?

उस ऐप्लिकेशन का पैकेज नाम जिसकी कुंजियां ज़रूरी हैं (ज़रूरी नहीं)
skipOnboarding: Boolean = false

फ़िलहाल, इसका इस्तेमाल नहीं किया जाता है.

isEnabled

fun isEnabled(): Task<Boolean>

यह एक ऐसा टास्क दिखाता है जो एपीआई उपलब्ध होने या न होने पर भी पूरा हो जाता है.

अगर एपीआई उपलब्ध है, तो टास्क के नतीजे के तौर पर सही वैल्यू मिलेगी. अगर एपीआई उपलब्ध नहीं है, तो टास्क के नतीजे के तौर पर गलत वैल्यू मिलेगी.

आम तौर पर, एपीआई के उपलब्ध न होने पर दिखने वाली गड़बड़ियों को ठीक किया जाएगा. इसके बजाय, टास्क के लिए 'गलत है' वैल्यू दिखाई जाएगी.

registerAccountContactKeysListener

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

यह कुकी, खाते से जुड़े संपर्क की कुंजियों के अपडेट के लिए लिसनर को रजिस्टर करती है.

जब दिए गए किसी भी accountId के लिए कोई भी कुंजी अपडेट की जाएगी, जोड़ी जाएगी या हटाई जाएगी, तब लिसनर को कॉल किया जाएगा. इसे दिए गए accountIds के लिए सभी कुंजियों की सूची के साथ कॉल किया जाएगा. सिर्फ़ उन कुंजियों के साथ नहीं जिन्हें अपडेट किया गया था.

पैरामीटर
accountIds: List<String>

उन खाता आईडी की सूची जिनके लिए लिसनर को रजिस्टर करना है.
listener: OnAccountContactKeysUpdatedListener

लिसनर को रजिस्टर करना होगा.

removeE2eeAccountContactKey

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

यह कॉलर ऐप्लिकेशन से जुड़ी, एंड-टू-एंड एन्क्रिप्शन की सुविधा वाले खाते की संपर्क कुंजी की एंट्री को हटाता है.

पैरामीटर
deviceId: String

ऐप्लिकेशन के लिए डिवाइस का आइडेंटिफ़ायर
accountId: String

खाते के लिए, ऐप्लिकेशन के हिसाब से तय किया गया आइडेंटिफ़ायर

removeE2eeContactKey

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

यह कॉलर ऐप्लिकेशन से जुड़ी, एंड-टू-एंड एन्क्रिप्शन (E2EE) वाली संपर्क कुंजी की एंट्री को हटाता है.

पैरामीटर
lookupKey: String

वह वैल्यू जो संपर्क को रेफ़रंस करती है
deviceId: String

ऐप्लिकेशन के लिए डिवाइस का आइडेंटिफ़ायर
accountId: String

खाते के लिए, ऐप्लिकेशन के हिसाब से तय किया गया आइडेंटिफ़ायर

removeE2eeSelfKey

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

यह डिवाइस आईडी और कॉल करने वाले व्यक्ति के पैकेज के अनुमानित नाम के आधार पर, एंड-टू-एंड एन्क्रिप्शन की सेल्फ की एंट्री को हटाता है.

पैरामीटर
deviceId: String

ऐप्लिकेशन के लिए डिवाइस का आइडेंटिफ़ायर
accountId: String

खाते के लिए, ऐप्लिकेशन के हिसाब से तय किया गया आइडेंटिफ़ायर

unregisterAccountContactKeysListener

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

यह फ़ंक्शन, खाते के संपर्क कुंजी अपडेट के लिए लिसनर को अनरजिस्टर करता है.

पैरामीटर
listener: OnAccountContactKeysUpdatedListener

को अनरजिस्टर करने का विकल्प मिलता है.

updateAllE2eeAccountKeys

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

खाते के संपर्क की कुंजियों का बैच डालता है.

यह updateOrInsertE2eeContactKey की तरह ही काम करता है. हालांकि, इससे एक साथ कई कुंजियां डाली/अपडेट की जा सकती हैं. हर कुंजी को उसके अपने लेन-देन में डाला जाता है. इसलिए, टास्क में कोई अपवाद होने पर भी कुछ कुंजियां डाली जा सकती हैं.

क्लाइंट, पूरे बैच को फिर से भेजकर कुछ समय के लिए होने वाली गड़बड़ियों को ठीक कर सकते हैं. ऐसा इसलिए, क्योंकि इस एपीआई से पहले से डाली गई कुंजियों की स्थिति पर कोई असर नहीं पड़ेगा.

हर कुंजी के लिए, अगर lookupKey दिया गया है, लेकिन संपर्क की बुनियादी जानकारी (displayName, phoneNumber, emailAddress) नहीं दी गई है, तो यह एपीआई, Contacts Provider से संपर्क का नाम, फ़ोन नंबर, और ईमेल पता भी वापस पाने की कोशिश करेगा. कुंजी को वापस पाने के दौरान, संपर्क जानकारी मैनेज करने वाले ऐप्लिकेशन को इस जानकारी का इस्तेमाल करना चाहिए. इससे यह पक्का किया जा सकेगा कि कुंजी का इस्तेमाल सिर्फ़ उस संपर्क के लिए किया गया है जिसके लिए इसे बनाया गया था.

Android Key Verification ऐप्लिकेशन, इस जानकारी को डिवाइस पर सेव करता है. साथ ही, इसे सिर्फ़ उन एपीआई कॉलर के साथ शेयर करता है जिनके पास READ_CONTACTS अनुमति है.

अगर किसी कुंजी के लिए lookupKey नहीं दिया गया है, तो यह एपीआई ऐसी कुंजी सेव करेगा जो किसी संपर्क से जुड़ी नहीं है.

पैरामीटर
accountKeyInfos: List<E2eeAccountKeyInfo>

E2eeAccountKeyInfo ऑब्जेक्ट की सूची, जिसमें एंड-टू-एंड एन्क्रिप्शन की संपर्क कुंजी की जानकारी शामिल होती है.

updateOrInsertE2eeContactKey

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

यह फ़ंक्शन, एंड-टू-एंड एन्क्रिप्शन वाली संपर्क कुंजियों की टेबल में नई एंट्री डालता है. अगर कोई एंट्री पहले से मौजूद है, तो उसे अपडेट करता है. एंड-टू-एंड एन्क्रिप्शन के लिए डाली गई/अपडेट की गई संपर्क कुंजी का मालिकाना हक, कॉल करने वाले ऐप्लिकेशन के पास है.

यह एपीआई, Contacts Provider से मिले संपर्क का नाम, फ़ोन नंबर, और ईमेल पते को भी सेव करेगा. साथ ही, कुंजी को भी सेव करेगा. कुंजी को वापस पाने के दौरान, संपर्क जानकारी मैनेज करने वाले ऐप्लिकेशन को इस जानकारी का इस्तेमाल करना चाहिए. इससे यह पक्का किया जा सकेगा कि कुंजी का इस्तेमाल सिर्फ़ उस संपर्क के लिए किया गया है जिसके लिए इसे बनाया गया था.

Android Key Verification ऐप्लिकेशन, इस जानकारी को डिवाइस पर सेव करता है. साथ ही, इसे सिर्फ़ उन एपीआई कॉलर के साथ शेयर करता है जिनके पास READ_CONTACTS अनुमति है.

पैरामीटर
lookupKey: String

वह वैल्यू जो संपर्क को रेफ़रंस करती है
deviceId: String

ऐप्लिकेशन के लिए डिवाइस का आइडेंटिफ़ायर
accountId: String

खाते के लिए, ऐप्लिकेशन के हिसाब से तय किया गया आइडेंटिफ़ायर
keyValue: ByteArray

कुंजी के लिए रॉ बाइट (ज़्यादा से ज़्यादा साइज़ getMaxKeySizeBytes बाइट है)

updateOrInsertE2eeContactKey

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

यह फ़ंक्शन, एंड-टू-एंड एन्क्रिप्शन वाली संपर्क कुंजियों की टेबल में नई एंट्री डालता है. अगर कोई एंट्री पहले से मौजूद है, तो उसे अपडेट करता है. एंड-टू-एंड एन्क्रिप्शन के लिए डाली गई/अपडेट की गई संपर्क कुंजी का मालिकाना हक, कॉल करने वाले ऐप्लिकेशन के पास है.

इस एपीआई में, दी गई हर लुकअप कुंजी के लिए, संपर्क का नाम, फ़ोन नंबर, और ईमेल पता भी सेव किया जाएगा. यह जानकारी, Contacts Provider से मिलेगी. कुंजी को वापस पाने के दौरान, संपर्क जानकारी मैनेज करने वाले ऐप्लिकेशन को इस जानकारी का इस्तेमाल करना चाहिए. इससे यह पक्का किया जा सकेगा कि कुंजी का इस्तेमाल सिर्फ़ उस संपर्क के लिए किया गया है जिसके लिए इसे बनाया गया था.

Android Key Verification ऐप्लिकेशन, इस जानकारी को डिवाइस पर सेव करता है. साथ ही, इसे सिर्फ़ उन एपीआई कॉलर के साथ शेयर करता है जिनके पास READ_CONTACTS अनुमति है.

अगर लुकअप कुंजियों की सूची खाली है, तो यह एपीआई ऐसी कुंजी सेव करेगा जो किसी संपर्क से जुड़ी नहीं है.

एक या उससे ज़्यादा लुकअप कुंजियों के साथ इस एपीआई को कॉल करने पर, कुंजी का मेटाडेटा अपडेट हो जाएगा. इससे इसे दिए गए संपर्कों से जोड़ा जा सकेगा. हालांकि, सूची में शामिल नहीं किए गए संपर्कों के लिए, मौजूदा असोसिएशन नहीं हटाए जाएंगे. किसी संपर्क और कुंजी के बीच का लिंक हटाने के लिए, सही लुकअप कुंजी के साथ removeE2eeContactKey को कॉल करें.

पैरामीटर
lookupKeys: List<String>

CP2 लुकअप कुंजियों की ऐसी सूची जिसमें उन संपर्कों का रेफ़रंस दिया गया हो जिनसे कुंजी जुड़ी है. हालांकि, ऐसा हो सकता है कि यह सूची खाली हो
deviceId: String

ऐप्लिकेशन के लिए डिवाइस का आइडेंटिफ़ायर
accountId: String

खाते के लिए, ऐप्लिकेशन के हिसाब से तय किया गया आइडेंटिफ़ायर
keyValue: ByteArray

कुंजी के लिए रॉ बाइट (ज़्यादा से ज़्यादा साइज़ getMaxKeySizeBytes बाइट है)

updateOrInsertE2eeSelfKey

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

यह कुकी, एंड-टू-एंड एन्क्रिप्शन की सुविधा के लिए इस्तेमाल की जाने वाली सेल्फ़ की टेबल में नई एंट्री डालती है. अगर कोई एंट्री पहले से मौजूद है, तो यह उसे अपडेट करती है.

पैरामीटर
deviceId: String

ऐप्लिकेशन के लिए डिवाइस का आइडेंटिफ़ायर
accountId: String

खाते के लिए, ऐप्लिकेशन के हिसाब से तय किया गया आइडेंटिफ़ायर
keyValue: ByteArray

कुंजी के लिए रॉ बाइट (ज़्यादा से ज़्यादा साइज़ getMaxKeySizeBytes बाइट है)