iframe מנוהל של Google Play

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

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

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

  • חיפוש אפליקציות: מאפשר לאדמינים ב-IT לחפש ולגלוש ב-Google ניתן להפעיל אפליקציות, להציג את פרטי האפליקציה ולבחור אפליקציות.
  • אפליקציות פרטיות: הרשאה לאדמינים ב-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, אפשר להגדיר באמצעות המאפיין 'Attributes' כאפשרות, בתור למעלה.

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

בטבלה הבאה מפורטים כל הפרמטרים הזמינים ל-iframe שניתן להוסיף לכתובת ה-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);