בעזרת ה-iframe של Google Play לארגונים, אפשר להטמיע את Google Play לארגונים ישירות במסוף ה-EMM, וכך להציע ללקוחות חוויה מאוחדת של ניהול ניידות.
ה-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
|
onproductselect
:
iframe.register('onproductselect', function(event) { console.log(event); }, gapi.iframes.CROSS_ORIGIN_IFRAMES_FILTER);