ContactKeyClient

public interface ContactKeyClient extends HasApiKey

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

खास जानकारी

पब्लिक मेथड
abstract @NonNull Flow<@NonNull List<@NonNull E2eeAccountContactKeyParcelable>>
@RequiresPermission(value = "android.permission.READ_CONTACTS")
getAccountContactKeysFlow(@NonNull List<@NonNull String> accountIds)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

पब्लिक मेथड

getAccountContactKeysFlow

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

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

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

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

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

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

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

getAllE2eeContactKeys

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

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

पैरामीटर
@NonNull String lookupKey

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

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

getAllE2eeSelfKeys

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

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

रिटर्न
@NonNull Task<@NonNull E2eeSelfKeyListParcelable>

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

getAllOwnerE2eeAccountContactKeys

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

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

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

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

getAllOwnerE2eeContactKeys

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

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

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

रिटर्न
@NonNull Task<@NonNull E2eeContactKeyListParcelable>

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

getE2eeAccountKeysForAccount

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

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

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

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

getE2eeContactKey

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

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

पैरामीटर
@NonNull String lookupKey

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

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

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

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

getE2eeSelfKey

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

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

पैरामीटर
@NonNull String deviceId

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

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

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

getMaxKeySizeBytes

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

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

getOnboardingIntent

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

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

पैरामीटर
@NonNull OnboardingNextActivity nextActivity

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

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

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

getOwnerE2eeContactKeys

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

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

पैरामीटर
@NonNull String lookupKey

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

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

getOwnerE2eeSelfKeys

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

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

रिटर्न
@NonNull Task<@NonNull E2eeSelfKeyListParcelable>

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

getScanQrCodeIntent

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

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

पैरामीटर
@NonNull String lookupKey

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

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

getScanQrCodeIntentForAccount

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

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

पैरामीटर
@NonNull String packageName

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

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

getShowQrCodeIntent

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

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

पैरामीटर
String packageName

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

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

isEnabled

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

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

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

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

registerAccountContactKeysListener

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

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

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

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

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

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

removeE2eeAccountContactKey

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

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

पैरामीटर
@NonNull String deviceId

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

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

removeE2eeContactKey

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

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

पैरामीटर
@NonNull String lookupKey

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

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

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

removeE2eeSelfKey

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

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

पैरामीटर
@NonNull String deviceId

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

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

unregisterAccountContactKeysListener

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

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

पैरामीटर
@NonNull OnAccountContactKeysUpdatedListener listener

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

updateAllE2eeAccountKeys

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

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

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

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

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

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

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

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

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

updateOrInsertE2eeContactKey

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

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

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

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

पैरामीटर
@NonNull String lookupKey

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

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

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

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

updateOrInsertE2eeContactKey

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

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

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

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

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

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

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

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

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

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

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

updateOrInsertE2eeSelfKey

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

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

पैरामीटर
@NonNull String deviceId

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

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

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