iframe מנוהל של Google Play

בעזרת ה-iframe של Google Play לארגונים, אפשר להטמיע את Google Play לארגונים ישירות במסוף ה-EMM, וכך להציע ללקוחות חוויה מאוחדת של ניהול ניידות.

iframe של Google Play לארגונים
איור 1. ה-iframe של Google Play לארגונים שבו מוצג הדף 'חיפוש אפליקציות'.

ה-iframe מכיל סרגל כותרת ותפריט צדדי מתרחב. מהתפריט, המשתמשים יכולים לנווט לדפים שונים:

  • חיפוש אפליקציות: אדמין ב-IT יכול לחפש אפליקציות ב-Google Play ולעיין בהן, להציג את פרטי האפליקציות ולבחור אפליקציות.
  • אפליקציות פרטיות: מאפשרות לאדמינים ב-IT לפרסם ולנהל אפליקציות פרטיות לארגון שלהם.
  • אפליקציות אינטרנט: מאפשרות לאדמינים ב-IT לפרסם ולהפיץ קיצורי דרך לאתרים בתור אפליקציות.
  • ארגון אפליקציות: מאפשרת לאדמינים ב-IT להגדיר איך האפליקציות יאורגנו באפליקציה של חנות Play במכשירים של המשתמשים.

כל הדפים מופעלים ב-iframe כברירת מחדל, אבל אפשר להשבית אותם בנפרד (ראו הוספת ה-iframe למסוף).

תכונות

בקטע הזה מתוארות התכונות הזמינות ב-iframe של Google Play לארגונים. למידע נוסף על הטמעת ה-iframe ועל ההטמעה של התכונות האלו, ראו הוספת ה-iframe למסוף.

הוספת ה-iframe למסוף

שלב 1. יצירת אסימון אינטרנט

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

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

public AdministratorWebToken getAdministratorWebToken(
        String enterpriseId) throws IOException {
    AdministratorWebTokenSpec tokenSpec = new AdministratorWebTokenSpec();
    tokenSpec.setParent("https://my-emm-console.com");
    tokenSpec.setPlaySearch(new AdministratorWebTokenSpecPlaySearch());
    tokenSpec.setPrivateApps(new AdministratorWebTokenSpecPrivateApps().setEnabled(false));
    tokenSpec.setWebApps(new AdministratorWebTokenSpecWebApps().setEnabled(false));
    tokenSpec.setStoreBuilder(new AdministratorWebTokenSpecStoreBuilder().setEnabled(false));
    return androidEnterprise
        .enterprise()
        .createWebToken(enterpriseId, tokenSpec)
        .execute();
}

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

שלב 2. עיבוד ה-iframe

הדוגמה הבאה מראה איך לעבד את ה-iframe של Play לארגונים:

<script src="https://apis.google.com/js/api.js"></script>
<div id="container"></div>
<script>
  gapi.load('gapi.iframes', function() {
    var options = {
      'url': 'https://play.google.com/work/embedded/search?token=web_token&mode=SELECT',
      'where': document.getElementById('container'),
      'attributes': { style: 'width: 600px; height:1000px', scrolling: 'yes'}
    }

    var iframe = gapi.iframes.getContext().openChild(options);
  });
</script>

הקוד הזה יוצר iframe בתוך הקונטיינר div. את המאפיינים שצריך להחיל על תג ה-iframe אפשר להגדיר באמצעות האפשרות 'מאפיינים', כפי שמתואר למעלה.

פרמטרים של כתובת אתר

בטבלה הבאה מפורטים כל הפרמטרים הזמינים ל-iframe שאפשר להוסיף לכתובת ה-URL כפרמטרים של כתובת URL, לדוגמה:

'url': 'https://play.google.com/work/embedded/search?token=web_token&mode=SELECT&showsearchbox=TRUE',
פרמטר דף נדרש תיאור
token לא רלוונטי כן האסימון שהוחזר משלב 1.
iframehomepage לא רלוונטי לא הדף הראשוני שמוצג במהלך עיבוד ה-iframe. הערכים האפשריים הם PLAY_SEARCH, WEB_APPS, PRIVATE_APPS ו-STORE_BUILDER (ארגון האפליקציות). אם לא מציינים זאת, סדר הקדימות הבא קובע איזה דף יוצג: 1. PLAY_SEARCH, 2. PRIVATE_APPS, 3. WEB_APPS, 4. STORE_BUILDER.
locale לא רלוונטי לא תג שפה BCP 47 בפורמט תקין שמשמש להתאמה לשוק המקומי של התוכן ב-iframe. אם לא מציינים אותו, ערך ברירת המחדל הוא en_US.
mode חיפוש אפליקציות לא SELECT: מאפשרת לאדמינים ב-IT לבחור אפליקציות.
APPROVE (ברירת המחדל): מאפשרת לאדמינים ב-IT לבחור אפליקציות, לאשר אותן ולבטל את האישור שלהן.
showsearchbox חיפוש אפליקציות לא TRUE (ברירת מחדל): הצגת תיבת החיפוש והפעלה של שאילתת החיפוש מתוך ה-iframe.
FALSE: שתיבת החיפוש לא מוצגת.
search חיפוש אפליקציות לא מחרוזת חיפוש. אם צוין, ה-iframe יפנה את האדמין ב-IT לתוצאות חיפוש עם המחרוזת שצוינה.

שלב 3. טיפול באירועי iframe

צריך לטפל גם באירועים הבאים כחלק מהשילוב.

אירועתיאור
onproductselect המשתמש בוחר או מאשר אפליקציה. הפעולה הזו מחזירה אובייקט שמכיל:
{
    "packageName": The package name of the app, e.g. "com.google.android.gm",
    "productId": The product ID of the app, e.g. "app:com.google.android.gm",
    "action": The type of action performed on the document. Possible values are:
    "approved", "unapproved" or "selected." If you implement the iframe in SELECT
    mode, the only possible value is "selected".
}
הדוגמה הבאה מראה איך להאזין ל-onproductselect: 
iframe.register('onproductselect', function(event) {
  console.log(event);
}, gapi.iframes.CROSS_ORIGIN_IFRAMES_FILTER);