ContactKeyClient

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

অ্যাকাউন্ট কন্টাক্ট কী-গুলোর আপডেটের একটি প্রবাহ ফেরত দেয়।

প্রদত্ত যেকোনো accountId-এর কোনো কী আপডেট, যোগ বা অপসারণ করা হলে ফ্লোটি ইমিট করবে। এটি শুধুমাত্র আপডেট করা কী-গুলো নয়, বরং প্রদত্ত accountId-গুলোর জন্য সমস্ত কী-এর তালিকা ইমিট করবে।

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

কলারের কাছে দৃশ্যমান অ্যাপগুলোর অন্তর্গত সমস্ত এন্ড-টু-এন্ড এনক্রিপশন কন্টাক্ট কী এন্ট্রি পুনরুদ্ধার করে। কীগুলো থেকে deviceId , timeUpdated এবং keyValue ডেটা মুছে ফেলা হবে।

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

কলকারীর কাছে দৃশ্যমান অ্যাপগুলোর অন্তর্গত সমস্ত এন্ড-টু-এন্ড এনক্রিপশন সেলফ-কী এন্ট্রি ফেরত দেয়। কীগুলো থেকে deviceId , timeUpdated এবং keyValue ডেটা বাদ দেওয়া হবে।

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

কলার অ্যাপের অন্তর্গত সমস্ত এন্ড-টু-এন্ড এনক্রিপশনযুক্ত অ্যাকাউন্ট কন্ট্যাক্ট কী পুনরুদ্ধার করে, সেগুলি কোনো কন্ট্যাক্টের সাথে যুক্ত থাকুক বা না থাকুক।

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

কলার অ্যাপের অন্তর্গত সমস্ত কন্ট্যাক্টের এন্ড-টু-এন্ড এনক্রিপশন কন্ট্যাক্ট কী পুনরুদ্ধার করে।

এই পদ্ধতিটি শুধুমাত্র সেইসব কী (key) পুনরুদ্ধার করতে ব্যবহার করা উচিত, যেগুলোর সাথে অন্তত একটি কন্ট্যাক্ট যুক্ত আছে। যদি আপনার এমন কী পুনরুদ্ধার করার প্রয়োজন হয় যা কোনো কন্ট্যাক্টের সাথে যুক্ত নয়, তাহলে এর পরিবর্তে getAllOwnerE2eeAccountContactKeys ব্যবহার করুন।

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

কলার অ্যাপ এবং কলারের অ্যাকাউন্টের অন্তর্গত সমস্ত কন্ট্যাক্ট থেকে এন্ড-টু-এন্ড এনক্রিপশন কন্ট্যাক্ট কী-এর এন্ট্রিগুলো পুনরুদ্ধার করে। এতে এমন কী-গুলোও অন্তর্ভুক্ত থাকে যা কোনো কন্ট্যাক্টের সাথে যুক্ত নয়।

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

lookupKey , deviceId , accountId এবং অনুমানকৃত কলার প্যাকেজ নেম ব্যবহার করে একটি এন্ড-টু-এন্ড এনক্রিপশন কন্টাক্ট কী এন্ট্রি পুনরুদ্ধার করে।

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

কলকারীর deviceId , accountId এবং অনুমানকৃত প্যাকেজ নেম দেওয়া থাকলে, এটি একটি এন্ড-টু-এন্ড এনক্রিপশন সেলফ-কী এন্ট্রি ফেরত দেয়।

fun getMaxKeySizeBytes(): Task<Int>

কোনো কী-এর সর্বোচ্চ অনুমোদিত আকার বাইটে ফেরত দেয়।

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

অনবোর্ডিং অ্যাক্টিভিটি দেখানোর জন্য একটি ইন্টেন্ট রিটার্ন করে এবং এই ডিভাইসে অনবোর্ডিং দেখানো হয়েছে তা চিহ্নিত করে। এর জন্য একটি nextActivity প্রয়োজন, যা ` show অথবা scan স্ট্রিং হতে পারে। যদি scan , তবে যে কন্ট্যাক্টকে স্ক্যান করতে হবে তার ` lookupKey প্রয়োজন।

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

একটি প্রদত্ত lookupKey এর জন্য কলার অ্যাপের অন্তর্গত সমস্ত এন্ড-টু-এন্ড এনক্রিপশন কন্টাক্ট কী এন্ট্রি পুনরুদ্ধার করে।

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

কলার অ্যাপের মালিকানাধীন সমস্ত এন্ড-টু-এন্ড এনক্রিপশন সেলফ-কী এন্ট্রি ফেরত দেয়।

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

'কিউআর কোড স্ক্যান করুন' অ্যাক্টিভিটির জন্য একটি ইন্টেন্ট ফেরত দেয়।

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

একটি নির্দিষ্ট অ্যাকাউন্টের জন্য 'কিউআর কোড স্ক্যান করুন' অ্যাক্টিভিটির একটি ইন্টেন্ট ফেরত দেয়।

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

'কিউআর কোড দেখান' অ্যাক্টিভিটিতে একটি ইন্টেন্ট ফেরত দেয়।

fun isEnabled(): Task<Boolean>

এমন একটি টাস্ক রিটার্ন করে যা এপিআই উপলব্ধ থাকুক বা না থাকুক, সফলভাবে সম্পন্ন হয়।

এপিআইটি উপলব্ধ থাকলে, ফেরত আসা টাস্কটির ফলাফল 'ট্রু' হবে, অন্যথায় 'ফলস' হবে।

এপিআই অনুপলব্ধ থাকলে সাধারণত যে এক্সেপশনগুলো থ্রো হয়, সেগুলো ক্যাচ করা হবে এবং তার পরিবর্তে সফলভাবে 'ফলস' রিটার্ন করা একটি টাস্ক ফেরত দেওয়া হবে।

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

অ্যাকাউন্টের কন্টাক্ট কী-গুলোর আপডেটের জন্য একটি লিসেনার রেজিস্টার করে।

প্রদত্ত যেকোনো accountId-এর কোনো কী আপডেট, যোগ বা অপসারণ করা হলে লিসেনারটি কল করা হবে। এটি শুধুমাত্র আপডেট হওয়া কীগুলো নয়, বরং প্রদত্ত accountId-গুলোর সমস্ত কী-এর তালিকা সহ কল ​​করা হবে।

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

কলার অ্যাপের অন্তর্গত একটি এন্ড-টু-এন্ড এনক্রিপশন অ্যাকাউন্ট কন্টাক্ট কী এন্ট্রি মুছে দেয়।

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

কলার অ্যাপের অন্তর্গত একটি এন্ড-টু-এন্ড এনক্রিপশন কন্টাক্ট কী এন্ট্রি মুছে দেয়।

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

কলারের ডিভাইস আইডি এবং অনুমানকৃত প্যাকেজ নামের ভিত্তিতে একটি এন্ড-টু-এন্ড এনক্রিপশন সেলফ-কী এন্ট্রি মুছে ফেলে।

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

অ্যাকাউন্ট কন্টাক্ট কী আপডেটের জন্য একটি লিসেনার অনিবন্ধিত করে।

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

একসাথে একাধিক অ্যাকাউন্ট যোগাযোগের কী সন্নিবেশ করে।

এটি updateOrInsertE2eeContactKey এর মতোই কাজ করে, তবে এর মাধ্যমে একই সাথে একাধিক কী ইনসার্ট বা আপডেট করা যায়। প্রতিটি কী তার নিজস্ব ট্রানজ্যাকশনে ইনসার্ট করা হয়, তাই টাস্কটি কোনো এক্সেপশন দেখালেও কিছু কী ইনসার্ট হয়ে যেতে পারে।

ক্লায়েন্টরা সাময়িক ব্যর্থতা সামাল দেওয়ার জন্য সম্পূর্ণ ব্যাচটি পুনরায় পাঠাতে পারেন, কারণ এই এপিআইটি ইতিমধ্যে প্রবেশ করানো কী-গুলোর স্থিতিকে প্রভাবিত করবে না।

প্রতিটি কী-এর জন্য, যদি একটি লুকআপ কী (lookupKey) প্রদান করা হয় কিন্তু কন্ট্যাক্টের মৌলিক তথ্য (ডিসপ্লে নেম, ফোন নম্বর, ইমেল অ্যাড্রেস) না দেওয়া থাকে, তাহলে এই এপিআইটি কন্ট্যাক্টস প্রোভাইডার থেকে কন্ট্যাক্টটির নাম, ফোন নম্বর এবং ইমেল অ্যাড্রেস পুনরুদ্ধার করার চেষ্টা করবে। কী পুনরুদ্ধার করার সময়, কন্ট্যাক্ট ম্যানেজমেন্ট অ্যাপগুলোর এই তথ্য ব্যবহার করে নিশ্চিত করা উচিত যে কী-টি শুধুমাত্র সেই কন্ট্যাক্টের জন্যই ব্যবহৃত হচ্ছে যার জন্য এটি তৈরি করা হয়েছিল।

অ্যান্ড্রয়েড কী ভেরিফিকেশন অ্যাপ এই তথ্য ডিভাইসে সংরক্ষণ করে এবং শুধুমাত্র সেইসব এপিআই কলারদের কাছে তা প্রকাশ করে যাদের READ_CONTACTS পারমিশন রয়েছে।

যদি কোনো কী-এর জন্য কোনো lookupKey প্রদান করা না হয়, তাহলে এই API এমন একটি কী সংরক্ষণ করবে যা কোনো কন্ট্যাক্টের সাথে সংযুক্ত নয়।

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

এন্ড-টু-এন্ড এনক্রিপশন কন্টাক্ট কী টেবিলে একটি নতুন এন্ট্রি যোগ করে অথবা আগে থেকে বিদ্যমান থাকলে তা আপডেট করে। যোগ করা/আপডেট করা এন্ড-টু-এন্ড এনক্রিপশন কন্টাক্ট কী-টির মালিকানা কলার অ্যাপের থাকে।

এই এপিআইটি কী-এর পাশাপাশি কন্ট্যাক্টস প্রোভাইডার থেকে কন্ট্যাক্টের নাম, ফোন নম্বর এবং ইমেল অ্যাড্রেসও সংরক্ষণ করবে। কী পুনরুদ্ধার করার সময়, কন্ট্যাক্ট ম্যানেজমেন্ট অ্যাপগুলোর এই তথ্য ব্যবহার করে নিশ্চিত করা উচিত যে কী-টি শুধুমাত্র সেই কন্ট্যাক্টের জন্যই ব্যবহৃত হচ্ছে যার জন্য এটি তৈরি করা হয়েছিল।

অ্যান্ড্রয়েড কী ভেরিফিকেশন অ্যাপ এই তথ্য ডিভাইসে সংরক্ষণ করে এবং শুধুমাত্র সেইসব এপিআই কলারদের কাছে তা প্রকাশ করে যাদের 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>

এন্ড-টু-এন্ড এনক্রিপশন কন্টাক্ট কী টেবিলে একটি নতুন এন্ট্রি যোগ করে অথবা আগে থেকে বিদ্যমান থাকলে তা আপডেট করে। যোগ করা/আপডেট করা এন্ড-টু-এন্ড এনক্রিপশন কন্টাক্ট কী-টির মালিকানা কলার অ্যাপের থাকে।

প্রদত্ত প্রতিটি লুকআপ কী-এর জন্য, এই এপিআইটি কী-টির পাশাপাশি কন্ট্যাক্টস প্রোভাইডার থেকে কন্ট্যাক্টটির নাম, ফোন নম্বর এবং ইমেল অ্যাড্রেসও সংরক্ষণ করবে। কী-টি পুনরুদ্ধার করার সময়, কন্ট্যাক্ট ম্যানেজমেন্ট অ্যাপগুলোর এই তথ্য ব্যবহার করে নিশ্চিত করা উচিত যে কী-টি শুধুমাত্র সেই কন্ট্যাক্টের জন্যই ব্যবহৃত হচ্ছে যার জন্য এটি তৈরি করা হয়েছিল।

অ্যান্ড্রয়েড কী ভেরিফিকেশন অ্যাপ এই তথ্য ডিভাইসে সংরক্ষণ করে এবং শুধুমাত্র সেইসব এপিআই কলারদের কাছে তা প্রকাশ করে যাদের READ_CONTACTS পারমিশন রয়েছে।

যদি লুকআপ কী-গুলির তালিকা খালি থাকে, তাহলে এই এপিআই এমন একটি কী সংরক্ষণ করবে যা কোনো কন্ট্যাক্টের সাথে যুক্ত নয়।

এক বা একাধিক লুকআপ কী দিয়ে এই API-টি কল করলে, কী-এর মেটাডেটা আপডেট হয়ে সেটিকে প্রদত্ত কন্ট্যাক্টগুলোর সাথে যুক্ত করবে, কিন্তু তালিকায় নেই এমন কন্ট্যাক্টগুলোর জন্য বিদ্যমান কোনো সংযোগ মুছে ফেলবে না। কোনো কন্ট্যাক্ট এবং কী-এর মধ্যেকার সংযোগ মুছে ফেলার জন্য, উপযুক্ত লুকআপ কী-টি দিয়ে removeE2eeContactKey কল করুন।

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

এন্ড-টু-এন্ড এনক্রিপশন সেলফ-কী টেবিলে একটি নতুন এন্ট্রি যোগ করে অথবা আগে থেকে বিদ্যমান থাকলে তা আপডেট করে।