iframe מנוהל של Google Play

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

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

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

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

כברירת מחדל, כל הדפים מופעלים ב-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);