יצירת קישור ל-Enterprise

Enterprise המשאב מקשר ארגון לפתרון הניהול של Android. Devices ו-Policies ושניהם שייכים לארגון. אפשר להגדיר כמה קישורי Enterprise שמשויכים לארגון אחד. לדוגמה, ייתכן שארגון ירצה קישורים ארגוניים נפרדים למחלקות או לאזורים השונים בו.

השלבים הבסיסיים ליצירת קישור ארגוני מתוארים מדריך למתחילים. דף זה מתאר את התהליך בפירוט רב יותר.

1. אחזור כתובת ה-URL להרשמה

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

  • callbackUrl: כתובת URL מסוג HTTP שאליה אשף ההגדרה מפנה לאחר מכן ההרשמה הושלמה. בדרך כלל זה מסוף הניהול.
  • projectId: מזהה הפרויקט.

התשובה מכילה url ו-name. פותחים את url ורושמים את name.

2. אדמין ב-IT בארגון משלים את תהליך ההרשמה

המדריך url מנחה את האדמין ב-IT בתהליך ההרשמה. אם ה-EMM לא מופעלת לתהליך ההרשמה ל-BTE, ואז להודיע לאדמין ב-IT חשבון Gmail שלא משויך כבר לקישור ארגוני. אחרי שהארגון רושם את הארגון, תהליך ההרשמה מפנה לכתובת callbackUrl. enterpriseToken מצורף אל callbackUrl.

דוגמה

https://example.com/?enterpriseToken=EAH2pBTtGCs2K28dqhq5uw0uCyVzYMqGivap4wdlH7KNlPtCmlC8uyl

3. יצירת קישור לארגון

כדי ליצור קישור ארגוני, צריך להפעיל enterprises.create בנוסף ליצירת מזהה קישור ייחודי לארגון, השיטה הזו מאפשרת לך כדי לקבוע הגדרות ספציפיות לקישור. לדוגמה, אפשר להגדיר את הצבע העיקרי מוצג במהלך הקצאת המכשיר (primaryColor), לצד עם השם או הכותרת (enterpriseDisplayName) והלוגו (logo) שמוצגת למשתמשי הקצה.

דוגמה

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

private String createEnterprise(AndroidManagement androidManagementClient)
    throws IOException {
  SignupUrl signupUrl =
      androidManagementClient
          .signupUrls()
          .create()
          .setProjectId("myProject")
          .setCallbackUrl("https://example.com/myEmmConsole")
          .execute();

  String enterpriseToken = displayUrlToAdmin(signupUrl.getUrl());

  Enterprise enterprise =
      androidManagementClient
          .enterprises()
          .create(new Enterprise())
          .setProjectId("myProject")
          .setSignupUrlName(signupUrl.getName())
          .setEnterpriseToken(enterpriseToken)
          .execute();

  return enterprise.getName();
}

/**
 * Displays the signup URL to the admin and returns the enterprise token which
 * is generated after the admin goes through the signup flow. This functionality
 * must be implemented by your management console.
 */
private String displayUrlToAdmin(String url) {
  ...
}