ContactKeyClient

public interface ContactKeyClient extends HasApiKey

לקוח ל-Contact Key API.

סיכום

‫methods ציבוריים
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 ושם החבילה המשוער של המתקשר.
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)

מחזירה כוונה לפעילות 'סריקת קוד QR'.
abstract @NonNull Task<@NonNull PendingIntent>
getScanQrCodeIntentForAccount(
    @NonNull String packageName,
    @NonNull String accountId
)

מחזירה כוונה לפעילות 'סריקת קוד QR' עבור חשבון ספציפי.
abstract @NonNull Task<@NonNull PendingIntent>
getShowQrCodeIntent(String packageName, boolean skipOnboarding)

מחזירה כוונה לפעילות 'הצגת קוד QR'.
abstract @NonNull Task<@NonNull Boolean>

מחזירה Task שמושלם בהצלחה, בין אם ה-API זמין ובין אם לא.
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
)

מסירה רשומה של מפתח ליצירת קשר עם הצפנה מקצה לקצה ששייכת לאפליקציה של המתקשר.
abstract @NonNull Task<@NonNull Void>
@RequiresPermission(value = "android.permission.WRITE_CONTACTS")
removeE2eeSelfKey(@NonNull String deviceId, @NonNull String accountId)

מסיר רשומה של מפתח עצמי להצפנה מקצה לקצה, בהינתן deviceId ושם החבילה המשוער של המתקשר.
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
)

מוסיף רשומה חדשה לטבלה של מפתחות עצמיים להצפנה מקצה לקצה או מעדכן רשומה קיימת.

‫methods ציבוריים

getAccountContactKeysFlow

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

מחזירה זרם של עדכונים של מפתחות אנשי קשר בחשבון.

האירוע יופעל כשמפתח כלשהו של כל accountId שסופק יעודכן, יתווסף או יוסר. הפונקציה תחזיר את רשימת כל המפתחות של מזהי החשבונות שצוינו, ולא רק את המפתחות שעודכנו.

פרמטרים
@NonNull List<@NonNull String> accountIds

רשימת מספרי החשבונות שרוצים לקבל עדכונים לגביהם.
החזרות
@NonNull Flow<@NonNull List<@NonNull E2eeAccountContactKeyParcelable>>

תהליך שפולט את הרשימות של E2eeAccountContactKeyParcelable עבור מזהי החשבונות שצוינו בכל פעם שמפתח כלשהו מתעדכן, מתווסף או מוסר.
הקפצת הודעות שגיאה (throw)
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>

‫E2eeContactKeyParcelable שמכיל את פרטי המפתח של איש הקשר, או null אם לא נמצא מפתח של איש קשר.

getE2eeSelfKey

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

מחזירה רשומה של מפתח עצמי להצפנה מקצה לקצה בהינתן deviceId, ‏ accountId ושם החבילה המשוער של המתקשר.

פרמטרים
@NonNull String deviceId

מזהה שצוין באפליקציה למכשיר
@NonNull String accountId

מזהה שצוין באפליקציה לחשבון
החזרות
@NonNull Task<E2eeSelfKeyParcelable>

‫E2eeSelfKeyParcelable שמכיל את פרטי המפתח העצמי של ההצפנה מקצה לקצה, או null אם לא נמצא מפתח עצמי.

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)

מחזירה כוונה לפעילות 'סריקת קוד QR'.

פרמטרים
@NonNull String lookupKey

הערך שמפנה לאיש הקשר
boolean skipOnboarding

כרגע לא בשימוש.

getScanQrCodeIntentForAccount

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

מחזירה כוונה לפעילות 'סריקת קוד QR' עבור חשבון ספציפי.

פרמטרים
@NonNull String packageName

שם החבילה שמשויך לחשבון שהמשתמש רוצה לאמת
@NonNull String accountId

מזהה החשבון שמשויך לחשבון שהמשתמש רוצה לאמת

getShowQrCodeIntent

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

מחזירה כוונה לפעילות 'הצגת קוד QR'.

פרמטרים
String packageName

שם החבילה שמשויך לאפליקציה שנדרשים המפתחות שלה (אופציונלי)
boolean skipOnboarding

כרגע לא בשימוש.

isEnabled

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

מחזירה Task שמושלם בהצלחה, בין אם ה-API זמין ובין אם לא.

אם ה-API זמין, המשימה שמוחזרת תהיה עם תוצאה true, אחרת false.

חריגים שמופעלים בדרך כלל כשה-API לא זמין ייבדקו, ובמקום זאת יוחזר ערך false של משימה שהושלמה בהצלחה.

registerAccountContactKeysListener

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

רושם מאזין לעדכונים של מפתחות אנשי קשר בחשבון.

המערכת תקרא ל-listener כשהמפתח של כל accountId שצוין יעודכן, יתווסף או יוסר. הפונקציה הזו תופעל עם רשימה של כל המפתחות של מזהי החשבונות שצוינו, ולא רק עם המפתחות שעודכנו.

פרמטרים
@NonNull List<@NonNull String> accountIds

רשימת מספרי החשבונות שרוצים לרשום את מאזין האירועים עבורם.
@NonNull OnAccountContactKeysUpdatedListener listener

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

מסירה רשומה של מפתח ליצירת קשר עם הצפנה מקצה לקצה ששייכת לאפליקציה של המתקשר.

פרמטרים
@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)

מסיר רשומה של מפתח עצמי להצפנה מקצה לקצה, בהינתן deviceId ושם החבילה המשוער של המתקשר.

פרמטרים
@NonNull String deviceId

מזהה שצוין באפליקציה למכשיר
@NonNull String accountId

מזהה שצוין באפליקציה לחשבון

unregisterAccountContactKeysListener

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

ביטול הרישום של מאזין לעדכונים של מפתחות אנשי קשר בחשבון.

פרמטרים
@NonNull OnAccountContactKeysUpdatedListener listener

ה-listener שרוצים לבטל את הרישום שלו.

updateAllE2eeAccountKeys

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

הוספה של קבוצת מפתחות של אנשי קשר בחשבון.

ההתנהגות דומה ל-updateOrInsertE2eeContactKey, אבל אפשר להוסיף או לעדכן כמה מפתחות בבת אחת. כל מפתח מוכנס בעסקה משלו, כך שחלק מהמפתחות עשויים להיות מוכנסים גם אם המשימה יוצרת חריגה.

לקוחות יכולים לבחור לטפל בכשלים זמניים על ידי שליחה מחדש של כל האצווה, כי ה-API הזה לא ישפיע על הסטטוס של מפתחות שכבר הוכנסו.

לכל מפתח, אם מסופק lookupKey אבל לא מסופקים הפרטים הבסיסיים של איש הקשר (displayName,‏ phoneNumber,‏ emailAddress), ה-API הזה ינסה גם לאחזר את השם, מספר הטלפון וכתובת האימייל של איש הקשר מניהול אנשי הקשר. כשמאחזרים את המפתח, אפליקציות לניהול אנשי קשר צריכות להשתמש במידע הזה כדי לוודא שהמפתח משמש רק לאיש הקשר שאליו הוא מיועד.

אפליקציית אימות המפתחות ל-Android מאחסנת את המידע הזה במכשיר וחושפת אותו רק למבצעי קריאות ל-API שמחזיקים בהרשאה READ_CONTACTS.

אם לא מספקים מפתח lookupKey למפתח, ה-API הזה ישמור מפתח שלא מקושר לאיש מאנשי הקשר.

פרמטרים
@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
)

הפונקציה מוסיפה רשומה חדשה לטבלה של מפתחות אנשי הקשר להצפנה מקצה לקצה, או מעדכנת רשומה קיימת. מפתח איש הקשר בהצפנה מקצה לקצה שנוסף או עודכן הוא בבעלות האפליקציה של המתקשר.

בנוסף, ה-API הזה ישמור את השם, מספר הטלפון וכתובת האימייל של איש הקשר מניהול אנשי הקשר, לצד המפתח. כשמאחזרים את המפתח, אפליקציות לניהול אנשי קשר צריכות להשתמש במידע הזה כדי לוודא שהמפתח משמש רק לאיש הקשר שאליו הוא מיועד.

אפליקציית אימות המפתחות ל-Android מאחסנת את המידע הזה במכשיר וחושפת אותו רק למבצעי קריאות ל-API שמחזיקים בהרשאה 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
)

הפונקציה מוסיפה רשומה חדשה לטבלה של מפתחות אנשי הקשר להצפנה מקצה לקצה, או מעדכנת רשומה קיימת. מפתח איש הקשר בהצפנה מקצה לקצה שנוסף או עודכן הוא בבעלות האפליקציה של המתקשר.

לכל מפתח חיפוש שסופק, ה-API הזה גם ישמור את השם, מספר הטלפון וכתובת האימייל של איש הקשר מניהול אנשי הקשר, לצד המפתח. כשמאחזרים את המפתח, אפליקציות לניהול אנשי קשר צריכות להשתמש במידע הזה כדי לוודא שהמפתח משמש רק לאיש הקשר שאליו הוא מיועד.

אפליקציית אימות המפתחות ל-Android מאחסנת את המידע הזה במכשיר וחושפת אותו רק למבצעי קריאות ל-API שמחזיקים בהרשאה READ_CONTACTS.

אם רשימת מפתחות החיפוש ריקה, ה-API הזה ישמור מפתח שלא משויך לאיש איש קשר.

אם תפעילו את ה-API הזה עם מפתח חיפוש אחד או יותר, המטא-נתונים של המפתח יעודכנו כך שהמפתח ישויך לאנשי הקשר שצוינו, אבל לא יוסרו שיוכים קיימים של אנשי קשר שלא צוינו ברשימה. כדי להסיר שיוך בין איש קשר לבין מפתח, מתקשרים אל 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 בייטים)