DpcMigrationClient

Kotlin |Java

public interface DpcMigrationClient

---

לקוח לבצע בקשות הקשורות להעברת dpc.

סיכום

שיטות ציבוריות
abstract @NonNull ListenableFuture<DpcMigrationAttempt>	getMigrationAttempt(     @NonNull GetDpcMigrationAttemptRequest getMigrationAttemptRequest ) מקבל ניסיון העברה.
abstract DpcMigrationAttempt	getMigrationAttemptAwait(     @NonNull GetDpcMigrationAttemptRequest getMigrationAttemptRequest ) מקבל ניסיון העברה.
abstract @NonNull ListenableFuture<@NonNull List<@NonNull DpcMigrationAttempt>>	listMigrationAttempts() מחזירה רשימה של כל ניסיונות ההעברה.
abstract @NonNull List<@NonNull DpcMigrationAttempt>	listMigrationAttemptsAwait() מחזירה רשימה של כל ניסיונות ההעברה.
abstract @NonNull ListenableFuture<@NonNull DpcMigrationAttempt>	migrateDeviceManagementToAndroidManagementApi(     @NonNull ComponentName notificationServiceComponentName,     @NonNull ComponentName adminComponentName,     @NonNull DpcMigrationRequest migrationRequest ) העברת המכשיר הזה לניהול באמצעות Android Management API.
abstract @NonNull DpcMigrationAttempt	migrateDeviceManagementToAndroidManagementApiAwait(     @NonNull ComponentName notificationServiceComponentName,     @NonNull ComponentName adminComponentName,     @NonNull DpcMigrationRequest migrationRequest ) העברת המכשיר הזה לניהול באמצעות Android Management API.

שיטות ציבוריות

getMigrationAttempt

abstract @NonNull ListenableFuture<DpcMigrationAttempt> getMigrationAttempt(
    @NonNull GetDpcMigrationAttemptRequest getMigrationAttemptRequest
)

מקבל ניסיון העברה.

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

רק בעלי המכשיר או בעלי הפרופיל יכולים לקרוא לשיטה הזו, או בעלים קודמים של המכשיר או בעלי פרופיל שהועברו ל-Android Management API.

החזרות

@NonNull ListenableFuture<DpcMigrationAttempt>

ListenableFuture ממיר את התוצאה. סוג הפריט יכול להיות עתיד מוצלח של הייצוא של DpcMigrationAttempt, אם יהיה הצלחה. null גלישת טקסט עתידית מוצלחת, למקרה שה-DpcMigrationAttempt לא נמצא. ניסיון גלישה עתידי של SecurityException נכשל, אם המתקשר/ת הוא לא בעלי המכשיר או בעלי הפרופיל, או אם היו בעבר בעלי מכשיר או בעלי פרופיל שהועברו ל-Android Management API. אריזה עתידית שנכשלה DpcMigrationException אם קריאה שקשורה להעברת dpc נכשלה. ההודעה וסוג המשנה של החריגה מכילים פרטים נוספים לגבי הכשל.

getMigrationAttemptAwait

abstract DpcMigrationAttempt getMigrationAttemptAwait(
    @NonNull GetDpcMigrationAttemptRequest getMigrationAttemptRequest
)

מקבל ניסיון העברה.

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

רק בעלי המכשיר או בעלי הפרופיל יכולים לקרוא לשיטה הזו, או בעלים קודמים של המכשיר או בעלי פרופיל שהועברו ל-Android Management API.

החזרות
DpcMigrationAttempt	הערך בשדה DpcMigrationAttempt או ערך null המבוקש, אם לא ניתן למצוא אותו

קליעות
java.lang.SecurityException	אם המתקשר הוא לא בעלי המכשיר או בעלי הפרופיל, או בעלים קודמים של המכשיר או בעלי פרופיל שהועברו ל-Android Management API.
com.google.android.managementapi.dpcmigration.DpcMigrationException	אם הקריאה הקשורה להעברת dpc נכשלה. ההודעה וסוג המשנה של החריגה מכילים פרטים נוספים לגבי הכשל.

listMigrationAttempts

abstract @NonNull ListenableFuture<@NonNull List<@NonNull DpcMigrationAttempt>> listMigrationAttempts()

מחזירה רשימה של כל ניסיונות ההעברה.

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

החזרות

@NonNull ListenableFuture<@NonNull List<@NonNull DpcMigrationAttempt>>

ListenableFuture ממיר את התוצאה. סוג הפריט יכול להיות סיכום עתיד מוצלח של רשימה של DpcMigrationAttempt, במקרה של הצלחה. ניסיון גלישה עתידי של SecurityException נכשל, אם המתקשר/ת הוא לא בעלי המכשיר או בעלי הפרופיל, או אם היו בעבר בעלי מכשיר או בעלי פרופיל שהועברו ל-Android Management API. אריזה עתידית שנכשלה DpcMigrationException אם קריאה שקשורה להעברת dpc נכשלה. ההודעה וסוג המשנה של החריגה מכילים פרטים נוספים לגבי הכשל.

listMigrationAttemptsAwait

abstract @NonNull List<@NonNull DpcMigrationAttempt> listMigrationAttemptsAwait()

מחזירה רשימה של כל ניסיונות ההעברה.

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

החזרות
@NonNull List<@NonNull DpcMigrationAttempt>	רשימה של DpcMigrationAttempt

קליעות
java.lang.SecurityException	אם המתקשר הוא לא בעלי המכשיר או בעלי הפרופיל, או בעלים קודמים של המכשיר או בעלי פרופיל שהועברו ל-Android Management API.
com.google.android.managementapi.dpcmigration.DpcMigrationException	אם הקריאה הקשורה להעברת dpc נכשלה. ההודעה וסוג המשנה של החריגה מכילים פרטים נוספים לגבי הכשל.

migrateDeviceManagementToAndroidManagementApi

abstract @NonNull ListenableFuture<@NonNull DpcMigrationAttempt> migrateDeviceManagementToAndroidManagementApi(
    @NonNull ComponentName notificationServiceComponentName,
    @NonNull ComponentName adminComponentName,
    @NonNull DpcMigrationRequest migrationRequest
)

העברת המכשיר הזה לניהול באמצעות Android Management API.

בסיום ההעברה, האפליקציה לשיחות תאבד את ההרשאות 'בעלי המכשיר' או 'בעלי הפרופיל', כי הן מועברות ל-Android Device Policy.

אזהרה: לא ניתן לבטל את הפעולה הזו. פעולת ה-ListenableFuture שמוחזרת מסתיים כאשר Android Device Policy מקבל את הבקשה ומשלים את הבדיקות הראשוניות של אסימון ההעברה. במקרה של כשל, ListenableFuture יכסה Exception.

רק בעלי המכשיר או בעלי הפרופיל יכולים לקרוא לשיטה הזו. ב-Android מגרסה 10 ומטה, אסור להפעיל את האפשרות הזו במכשיר שיש לו גם בעלי מכשיר וגם בעלי פרופיל.

בעלי הפרופיל (למעט ב-Android 12) נדרשים להעביר את רשתות ה-Wi-Fi שהוגדרו בDpcMigrationRequest במכשיר בבעלות אישית, אם הוגדרו בו רשתות Wi-Fi כלשהן. אין להעביר את המסמכים האלה למכשיר בבעלות החברה. חשוב לזכור שרשתות ה-Wi-Fi האלה יוסרו ממש לפני שניהול המכשירים יועבר ל-Android Device Policy. במקרה של כשל בהסרת רשת, גם ההעברה תיכשל. מאחר שהסרת הרשתות אינה פעולה אטומית, ייתכן שחלק מהרשתות כבר הוסרו.

במכשירים בבעלות אישית עם פרופיל עבודה שפועלת בהם מערכת ההפעלה Android 12, כל רשתות ה-Wi-Fi שהוגדרו על ידי ה-DPC שמתקשר יוסרו ממש לפני שניהול המכשירים יועבר ל-Android Device Policy, ללא קשר לרשתות ה-Wi-Fi שמועברות בmigrationRequest.

פרמטרים
@NonNull ComponentName notificationServiceComponentName	ComponentName של השירות להרחבה של NotificationReceiverService. הרכיב חייב להיות רכיב חוקי ששייך לאפליקציית הקריאה, ויש לייצא אותו במניפסט. אחרת, יושמע השדה IllegalArgumentException.
@NonNull ComponentName adminComponentName	ComponentName של האדמין DeviceAdminReceiver בבקר ה-DPC שמתקשר.
@NonNull DpcMigrationRequest migrationRequest	DpcMigrationRequest שמכיל את אסימון ההעברה ורשתות Wi-Fi מוגדרות. האפשרות השנייה נדרשת רק אם המתקשר הוא בעל הפרופיל במכשיר בבעלות אישית והוא הגדיר רשתות כלשהן.

החזרות

@NonNull ListenableFuture<@NonNull DpcMigrationAttempt>

ListenableFuture ממיר את התוצאה. סוג הפריט יכול להיות עתיד מוצלח של הייצוא של DpcMigrationAttempt, אם יהיה הצלחה. גלישה עתידית של SecurityException נכשלה, אם המתקשר/ת הוא לא בעלי המכשיר או בעלי הפרופיל. אריזה עתידית של IllegalArgumentException נכשלה, אם אסימון ההעברה ריק, או אם notificationServiceComponentName לא מתייחס לרכיב חוקי שמקיף את NotificationReceiverService שיוצא במניפסט, או אם adminComponentName לא מוגדר כאדמין פעיל ששייך לחבילה הנוכחית. נכשלה האריזה של DpcMigrationException עתידית, אם קריאה שקשורה להעברת dpc נכשלה. ההודעה וסוג המשנה של החריגה מכילים פרטים נוספים לגבי הכשל.

migrateDeviceManagementToAndroidManagementApiAwait

abstract @NonNull DpcMigrationAttempt migrateDeviceManagementToAndroidManagementApiAwait(
    @NonNull ComponentName notificationServiceComponentName,
    @NonNull ComponentName adminComponentName,
    @NonNull DpcMigrationRequest migrationRequest
)

העברת המכשיר הזה לניהול באמצעות Android Management API.

בסיום ההעברה, האפליקציה לשיחות תאבד את ההרשאות 'בעלי המכשיר' או 'בעלי הפרופיל', כי הן מועברות ל-Android Device Policy.

אזהרה: לא ניתן לבטל את הפעולה הזו. המשעשע את ההשעיה חוזר כאשר Android Device Policy מקבל את הבקשה ומשלים את הבדיקות הראשוניות של אסימון ההעברה. במקרה של כשל, זריקה Exception.

רק בעלי המכשיר או בעלי הפרופיל יכולים לקרוא לשיטה הזו. ב-Android מגרסה 10 ומטה, אסור להפעיל את האפשרות הזו במכשיר שיש לו גם בעלי מכשיר וגם בעלי פרופיל.

בעלי הפרופיל (למעט ב-Android 12) נדרשים להעביר את רשתות ה-Wi-Fi שהוגדרו בDpcMigrationRequest במכשיר בבעלות אישית, אם הוגדרו בו רשתות Wi-Fi כלשהן. אין להעביר את המסמכים האלה למכשיר בבעלות החברה. חשוב לזכור שרשתות ה-Wi-Fi האלה יוסרו ממש לפני שניהול המכשירים יועבר ל-Android Device Policy. במקרה של כשל בהסרת רשת, גם ההעברה תיכשל. מאחר שהסרת הרשתות אינה פעולה אטומית, ייתכן שחלק מהרשתות כבר הוסרו.

במכשירים בבעלות אישית עם פרופיל עבודה שפועלת בהם מערכת ההפעלה Android 12, כל רשתות ה-Wi-Fi שהוגדרו על ידי ה-DPC שמתקשר יוסרו ממש לפני שניהול המכשירים יועבר ל-Android Device Policy, ללא קשר לרשתות ה-Wi-Fi שמועברות בmigrationRequest.

פרמטרים
@NonNull ComponentName notificationServiceComponentName	ComponentName של השירות להרחבה של NotificationReceiverService. הרכיב חייב להיות רכיב חוקי ששייך לאפליקציית הקריאה, ויש לייצא אותו במניפסט. אחרת, יושמע השדה IllegalArgumentException.
@NonNull ComponentName adminComponentName	ComponentName של האדמין DeviceAdminReceiver בבקר ה-DPC שמתקשר.
@NonNull DpcMigrationRequest migrationRequest	DpcMigrationRequest שמכיל את אסימון ההעברה ורשתות Wi-Fi מוגדרות. האפשרות השנייה נדרשת רק אם המתקשר הוא בעל הפרופיל במכשיר בבעלות אישית והוא הגדיר רשתות כלשהן.

החזרות
@NonNull DpcMigrationAttempt	DpcMigrationException עם הסטטוס הנוכחי של ההעברה.

קליעות
java.lang.SecurityException	אם המתקשר הוא לא בעלי המכשיר או בעלי הפרופיל.
java.lang.IllegalArgumentException	אם אסימון ההעברה ריק, או אם notificationServiceComponentName לא מתייחס לרכיב חוקי שמקיף את NotificationReceiverService שיוצא במניפסט, או אם adminComponentName אינו אדמין פעיל ששייך לחבילה הנוכחית.
com.google.android.managementapi.dpcmigration.DpcMigrationException	אם הקריאה הקשורה להעברת dpc נכשלה. ההודעה וסוג המשנה של החריגה מכילים פרטים נוספים לגבי הכשל.