Android पर संपर्क जोड़ने और उनमें बदलाव करने का ज़्यादा भरोसेमंद तरीका

क्या बदलाव होंगे

Android के आने वाले वर्शन को टारगेट करने वाले ऐप्लिकेशन, अब WRITE_CONTACTS अनुमति का इस्तेमाल करके, संपर्कों में सीधे तौर पर बदलाव नहीं कर पाएंगे. इसके बजाय, स्टैंडर्ड कॉन्टैक्ट इंटेंट (ACTION_INSERT, ACTION_EDIT, और ACTION_INSERT_OR_EDIT) का इस्तेमाल किया जा सकता है. रेफ़रंस के तौर पर लागू करने के बारे में पूरी जानकारी पाने के लिए, डेवलपर गाइड देखें. इसमें इंटेंट का इस्तेमाल करके संपर्कों में बदलाव करने का तरीका बताया गया है. 

Android के आने वाले वर्शन पर चलने वाले डिवाइसों पर, संपर्क से जुड़े ये तीनों इंटेंट एक जैसे काम करेंगे. साथ ही, इनके लिए किसी अनुमति की ज़रूरत नहीं होगी. अगर आपका ऐप्लिकेशन, Android के आने वाले वर्शन या उसके बाद के वर्शन को टारगेट करता है और सीधे तौर पर संपर्कों में बदलाव करने की कोशिश करता है, तो उन बदलावों को अस्वीकार कर दिया जाएगा. साथ ही, आपको SecurityException या अनुमति न मिलने की गड़बड़ी दिखेगी. संपर्क बनाने और उनमें बदलाव करने के लिए, कुछ ऐप्लिकेशन को ज़्यादा ऐक्सेस की ज़रूरत होती है. ऐसे ऐप्लिकेशन के लिए, Android 17 QPR2 (2026 की चौथी तिमाही) में, ऐप्लिकेशन को खास ऐक्सेस देने की नई अनुमति, MANAGE_CONTACTS उपलब्ध होगी. Google Play, संपर्क जानकारी के ऐक्सेस के लिए अपडेट किए गए दिशा-निर्देश आज पब्लिश कर रहा है. इनमें MANAGE_CONTACTS भी शामिल है.

हम ऐसा क्यों कर रहे हैं

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

हालांकि, इसके विकल्प मौजूद हैं, लेकिन हमें आपसे पता चला है कि उन्हें पूरे नेटवर्क में ज़्यादा स्टैंडर्ड बनाने की ज़रूरत है. पहले, संपर्क इंटेंट अलग-अलग डिवाइसों पर अलग-अलग तरह से काम करते थे. कुछ एडिटर ने आपके पास मौजूद डेटा को हटा दिया है, जैसे कि संपर्क की फ़ोटो. कुछ डिवाइसों पर, 'वापस जाएं' बटन दबाने पर संपर्क सेव हो जाता था, भले ही उपयोगकर्ता ऐसा न करना चाहता हो. इसके अलावा, "नया संपर्क बनाएं" विकल्प को ढूंढना मुश्किल था. इसलिए, अनुमति मांगना ही सही विकल्प था. हम Android के आने वाले वर्शन में इन सभी समस्याओं को ठीक कर रहे हैं. साथ ही, इस वर्शन पर चलने वाले डिवाइसों के लिए, एक जैसे स्टैंडर्ड का पालन करना ज़रूरी बना रहे हैं.

इसके बजाय क्या इस्तेमाल करें

कोई संपर्क जोड़ना या उसमें बदलाव करना: संपर्क इंटेंट का इस्तेमाल करना

ACTION_INSERT, ACTION_EDIT, और ACTION_INSERT_OR_EDIT इंटेंट का इस्तेमाल करने पर, सिस्टम मुश्किल काम को आसान बना देता है. इसके लिए, वह संपर्क की जानकारी में बदलाव करने के लिए, साफ़-सुथरा और स्टैंडर्ड अनुभव देता है. इससे नई एंट्री के लिए, हाफ़-शीट वाला फ़ॉर्म तुरंत खुल जाता है. इसके अलावा, उपयोगकर्ता किसी मौजूदा संपर्क को आसानी से खोज सकता है और उसमें जानकारी जोड़ सकता है. उपयोगकर्ता, इस फ़ॉर्म को आसानी से फ़ुल-पेज एडिटर में बड़ा कर सकते हैं, ताकि वे ज़्यादा जानकारी भर सकें. इसके लिए, आपके ऐप्लिकेशन को फ़ाइल या एंट्री में बदलाव करने की अनुमति की ज़रूरत नहीं होती. नीचे दिए गए यूएक्स मॉक देखें: 

पहली इमेज: नया संपर्क बनाएं  *उपयोगकर्ता अनुभव फ़ाइनल नहीं है*

दूसरी इमेज: किसी मौजूदा संपर्क में जानकारी जोड़ना *उपयोगकर्ता अनुभव फ़ाइनल नहीं है*

ध्यान दें: डिवाइस बनाने वाली अलग-अलग कंपनियां, उपयोगकर्ता अनुभव में बदलाव कर सकती हैं, ताकि वह उनके ओएस स्टाइल से मैच करे. हालांकि, इसका व्यवहार एक जैसा ही रहेगा.

इंटेंट के साथ-साथ, डेटा पेलोड के तौर पर अतिरिक्त डेटा पास करके, इंटेंट बनाने की प्रोसेस को और आसान बनाया जा सकता है. इस अतिरिक्त डेटा को एक्स्ट्रा कहा जाता है:

• EXTRA_ACCOUNT यह सुझाव देता है कि संपर्क किस खाते में सेव किया जाए. इससे, आपके ऐप्लिकेशन को संपर्क सिंक करने में मदद मिलती है. यह सुविधा पहले से मौजूद थी, लेकिन यह हर डिवाइस पर काम नहीं करती थी. Android के आने वाले वर्शन से, सभी डिवाइसों पर एक जैसी सुविधाएं मिलेंगी.
• EXTRA_PHOTO_URI, संपर्क की फ़ोटो को ऑटोमैटिक तरीके से भरने के लिए एक फ़ोटो पास करता है. एडिटर, आपके लिए यूआरआई को पढ़ने की अनुमति मैनेज करता है. यह सुविधा, Android के आने वाले वर्शन में उपलब्ध होगी. साथ ही, यह पूरे नेटवर्क पर काम करेगी.

// Requires android.permission.WRITE_CONTACTS
fun saveContactDirectly(context: Context, name: String, phone: String, account: Account) {
    val ops = arrayListOf(
        ContentProviderOperation.newInsert(ContactsContract.RawContacts.CONTENT_URI)
            .withValue(ContactsContract.RawContacts.ACCOUNT_TYPE, account.type)
            .withValue(ContactsContract.RawContacts.ACCOUNT_NAME, account.name)
            .build(),
        ContentProviderOperation.newInsert(ContactsContract.Data.CONTENT_URI)
            .withValueBackReference(ContactsContract.Data.RAW_CONTACT_ID, 0)
            .withValue(
                ContactsContract.Data.MIMETYPE,
                ContactsContract.CommonDataKinds.StructuredName.CONTENT_ITEM_TYPE
            )
            .withValue(ContactsContract.CommonDataKinds.StructuredName.DISPLAY_NAME, name)
            .build(),
        ContentProviderOperation.newInsert(ContactsContract.Data.CONTENT_URI)
            .withValueBackReference(ContactsContract.Data.RAW_CONTACT_ID, 0)
            .withValue(
                ContactsContract.Data.MIMETYPE,
                ContactsContract.CommonDataKinds.Phone.CONTENT_ITEM_TYPE
            )
            .withValue(ContactsContract.CommonDataKinds.Phone.NUMBER, phone)
            .build()
    )
    context.contentResolver.applyBatch(ContactsContract.AUTHORITY, ops)
}

fun saveContactWithEditor(
    context: Context,
    name: String,
    phone: String,
    account: Account,
    photoUri: Uri
) {
    val intent = Intent(Intent.ACTION_INSERT, ContactsContract.Contacts.CONTENT_URI).apply {
        putExtra(ContactsContract.Intents.Insert.NAME, name)
        putExtra(ContactsContract.Intents.Insert.PHONE, phone)
        // Suggest which account the contact is saved to
        putExtra(ContactsContract.Intents.Insert.EXTRA_ACCOUNT, account)
        // New in the upcoming Android release: pre-fill the contact photo
        putExtra(ContactsContract.Intents.Insert.EXTRA_PHOTO_URI, photoUri)
        clipData = ClipData.newRawUri("", photoUri)
        addFlags(Intent.FLAG_GRANT_READ_URI_PERMISSION)
    }
    context.startActivity(intent)
}

// Requires android.permission.WRITE_CONTACTS
fun addPhoneDirectly(context: Context, rawContactId: Long, phone: String) {
    val values = ContentValues().apply {
        put(ContactsContract.Data.RAW_CONTACT_ID, rawContactId)
        put(ContactsContract.Data.MIMETYPE, ContactsContract.CommonDataKinds.Phone.CONTENT_ITEM_TYPE)
        put(ContactsContract.CommonDataKinds.Phone.NUMBER, phone)
    }
    context.contentResolver.insert(ContactsContract.Data.CONTENT_URI, values)
}

fun addPhoneWithEditor(context: Context, phone: String) {
    val intent = Intent(Intent.ACTION_INSERT_OR_EDIT).apply {
        type = ContactsContract.Contacts.CONTENT_ITEM_TYPE
        putExtra(ContactsContract.Intents.Insert.PHONE, phone)
    }
    context.startActivity(intent)
}

fun editKnownContact(context: Context, contactUri: Uri, phone: String) {
    val intent = Intent(Intent.ACTION_EDIT, contactUri).apply {
        putExtra(ContactsContract.Intents.Insert.PHONE, phone)
    }
    context.startActivity(intent)
}

कोई संपर्क चुनना: कॉन्टैक्ट पिकर का इस्तेमाल करना

अगर आपको सिर्फ़ उपयोगकर्ता के चुने गए संपर्कों को पढ़ने की ज़रूरत है, तो कॉन्टैक्ट पिकर का इस्तेमाल करें. यह Android 17 के बाद से उपलब्ध है. इसके लिए किसी अनुमति की ज़रूरत नहीं होती.

कॉलिंग और मैसेजिंग ऐप्लिकेशन: People Directory का इस्तेमाल करना

कुछ ऐप्लिकेशन, संपर्कों में "…से कॉल करें" या "…से मैसेज करें" कार्रवाइयां जोड़ते हैं. इससे लोग, फ़ोन या संपर्क ऐप्लिकेशन से कॉल या चैट शुरू कर सकते हैं. अगर आपका ऐप्लिकेशन, उपयोगकर्ता के संपर्कों में अतिरिक्त एंट्री लिखकर ऐसा करता है, तो People Directory पर जाएं. यह सुविधा, Android QPR2 (2026 की चौथी तिमाही) में उपलब्ध होगी. यह एक नई सिस्टम डायरेक्ट्री है, जहां आपका ऐप्लिकेशन यह पब्लिश करता है कि लोग आपके ऐप्लिकेशन में एक-दूसरे से कैसे संपर्क कर सकते हैं. इसके लिए, उपयोगकर्ता की संपर्क जानकारी में बदलाव करने की ज़रूरत नहीं होती.

ऐप्लिकेशन को माइग्रेट करने के उदाहरण

इन विकल्पों के काम करने का तरीका जानने के लिए, यहां कुछ उदाहरण दिए गए हैं. इनसे पता चलता है कि अलग-अलग तरह के ऐप्लिकेशन, संपर्क जानकारी को ऐक्सेस करने के लिए किस तरह के तरीके अपना सकते हैं:

इन बदलावों को देखें

• एडिटर में कस्टम डेटा टाइप का इस्तेमाल नहीं किया जा सकता. अगर स्टैंडर्ड ContactsContract.CommonDataKinds टाइप के अलावा, अन्य एमआईएमई टाइप वाली Insert.DATA लाइनें पास की जाती हैं, तो एडिटर उन एमआईएमई टाइप को अनदेखा कर देगा.
• SHOW_OR_CREATE_CONTACT को सिस्टम एडिटर मैनेज नहीं करता. डिवाइस में पहले से मौजूद संपर्क ऐप्लिकेशन, अब भी इसे मैनेज कर सकते हैं. सभी डिवाइसों पर एक जैसा अनुभव देने के लिए, ACTION_INSERT_OR_EDIT का इस्तेमाल करें.
• डिफ़ॉल्ट रूप से, डेटा सेव नहीं होता. Android के आने वाले वर्शन को टारगेट करने के बाद, MANAGE_CONTACTS के बिना सीधे तौर पर डेटा सेव करने पर, SecurityException or permission denial दिखेगा. इसकी जांच करें.

क्या मुझे MANAGE_CONTACTS की ज़रूरत है?

शायद नहीं. अगर आपका ऐप्लिकेशन किसी उपयोगकर्ता के अनुरोध पर संपर्कों को सेव करता है या उनमें बदलाव करता है, तो ऊपर दिए गए इंटेंट आपके काम आ सकते हैं. इनके लिए, न तो अनुमति की ज़रूरत होती है और न ही Play Console में एलान करने की.

MANAGE_CONTACTS उन ऐप्लिकेशन के लिए है जिनका मुख्य मकसद संपर्कों को मैनेज करना है. साथ ही, जिनके लिए इंटेंट काफ़ी नहीं हैं. उदाहरण के लिए:

यह कैसे काम करता है:

• MANAGE_CONTACTS, ऐप्लिकेशन को ऐक्सेस देने के लिए दी जाने वाली एक खास अनुमति है. यह रनटाइम डायलॉग नहीं है. उपयोगकर्ता इसे सेटिंग > ऐप्लिकेशन के लिए खास ऐक्सेस > संपर्क मैनेज करें में जाकर चालू करते हैं.

// Opens Settings > Apps > Special app access > Manage contacts
val intent = Intent(Settings.ACTION_MANAGE_CONTACTS, Uri.fromParts("package", packageName, null))
context.startActivity(intent)

• इसमें संपर्कों, खातों, और People Directory के डेटा को पढ़ना, जोड़ना, उसमें बदलाव करना, और उसे मिटाना शामिल है. आपको READ_CONTACTS का अनुरोध करने की भी ज़रूरत नहीं है.
• MANAGE_CONTACTS के साथ Google Play पर ऐप्लिकेशन पब्लिश करने के लिए, आपको Play Console में एक एलान सबमिट करना होगा. इसमें आपको यह बताना होगा कि आपके ऐप्लिकेशन के मुख्य फ़ंक्शन के लिए, इंटेंट काफ़ी क्यों नहीं हैं.

माइग्रेशन के चरण

• संपर्क ढूंढना. अपने कोड में WRITE_CONTACTS, ContactsContract.RawContacts.CONTENT_URI, ContactsContract.Data.CONTENT_URI, और applyBatch(ContactsContract.AUTHORITY, …) खोजें.
• उपयोगकर्ता के हर राइट ऑपरेशन को इंटेंट से बदलें: नए संपर्कों के लिए ACTION_INSERT और अपडेट के लिए ACTION_EDIT या ACTION_INSERT_OR_EDIT.
• Insert.DATA में सिर्फ़ स्टैंडर्ड डेटा टाइप का इस्तेमाल करें. कॉल या मैसेज से जुड़ी कार्रवाइयों को People Directory में ले जाना.
• तय करें कि आपको वाकई MANAGE_CONTACTS की ज़रूरत है या नहीं. इसके लिए, ऊपर दी गई टेबल का इस्तेमाल करें. अगर ऐसा है, तो Play Console में एलान वाला फ़ॉर्म भरने की तैयारी करें.
• जब किसी कोड पाथ को WRITE_CONTACTS की ज़रूरत न हो, तो उसे अपने मेनिफ़ेस्ट से हटाएं .

टाइमलाइन

अक्सर पूछे जाने वाले सवाल

• क्या इसका असर हर ऐप्लिकेशन पर पड़ता है?
  • WRITE_CONTACTS को बंद करने का बदलाव, सिर्फ़ उन ऐप्लिकेशन पर लागू होता है जो Android की आने वाली रिलीज़ और उसके बाद के वर्शन को टारगेट करते हैं. पुराने वर्शन को टारगेट करने वाले ऐप्लिकेशन, मौजूदा तरीके से काम करते रहेंगे. हालांकि, नए ओएस पर काम करने वाले सभी ऐप्लिकेशन के लिए, संपर्क की जानकारी में बदलाव करने की नई सुविधा उपलब्ध होगी. भले ही, उनका टारगेट एसडीके कुछ भी हो.
• क्या मेरा ऐप्लिकेशन, इंटेंट का इस्तेमाल करके संपर्कों को मिटा सकता है?
  • नहीं. संपर्कों को मिटाने का कोई इरादा नहीं है. उपयोगकर्ता, अपने संपर्क ऐप्लिकेशन में जाकर संपर्कों को मिटाते हैं. जिन ऐप्लिकेशन के पास MANAGE_CONTACTS की अनुमति होती है वे संपर्कों को सीधे तौर पर मिटा सकते हैं.
• मेरे पास पहले से ही संपर्क में बदलाव करने की स्क्रीन है. क्या मैं इसे रख सकता हूं?
  • सिर्फ़ तब, जब आपका ऐप्लिकेशन MANAGE_CONTACTS की ज़रूरी शर्तें पूरी करता हो. कस्टम डिज़ाइन को बनाए रखने की इच्छा, अपने-आप में कोई मान्य वजह नहीं है.
• क्या MANAGE_CONTACTS, READ_CONTACTS की जगह लेगा?
  • MANAGE_CONTACTS में, डेटा को पढ़ने का ऐक्सेस शामिल होता है. इसलिए, आपको दोनों के लिए अनुरोध करने की ज़रूरत नहीं है. हालांकि, कई ऐप्लिकेशन READ_CONTACTS के लिए ज़रूरी शर्तें पूरी करते हैं. ऐसे ऐप्लिकेशन को संपर्कों में बदलाव करने की ज़रूरत नहीं होती. ये ऐप्लिकेशन, READ_CONTACTS का अनुरोध करना जारी रख सकते हैं.
• Android के पुराने वर्शन इस्तेमाल करने वाले उपयोगकर्ताओं का क्या होगा?
  • संपर्क इंटेंट, पुराने वर्शन पर भी काम करते हैं. इन्हें डिवाइस का संपर्क ऐप्लिकेशन मैनेज करता है. ज़्यादातर ऐप्लिकेशन, इन इंटेंट का इस्तेमाल करके सभी डिवाइसों पर अच्छी तरह से काम करेंगे. अगर आपके ऐप्लिकेशन पर एक जैसी परफ़ॉर्मेंस न मिलने की समस्या का असर पड़ा है और इसे सिर्फ़ नए वर्शन में हल किया जा सकता है, तो अपने मेनिफ़ेस्ट में WRITE_CONTACTS अनुमति को सही maxSdkVersion के साथ रखा जा सकता है.