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. הדוגמה הבאה מראה איך לאחזר את האסימון באמצעות ספריית הלקוח של API של Google Play EMM עבור Java.

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

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 אפשר להגדיר באמצעות האפשרות Attributes (מאפיינים), כפי שמתואר למעלה.

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

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

'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 יכולים לבחור אפליקציות, לאשר אותן או לבטל אותן. המצב הזה הוצא משימוש. במקומו צריך להשתמש באפשרות SELECT. מצב APPROVE פועל רק אם המדיניות PlaySearch.ApproveApps מוגדרת לערך true באסימון האינטרנט.
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);