באמצעות ה-iframe של Google Play לארגונים, אפשר להטמיע את Google Play לארגונים ישירות במסוף ה-EMM כדי להציע ללקוחות ניהול ניידות מאוחדות חוויה אישית.
![iframe של Google Play לארגונים](https://developers-dot-devsite-v2-prod.appspot.com/static/android/work/play/emm-api/images/managed-google-play-iframe.png?authuser=1&hl=he)
ה-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
|
onproductselect
:
iframe.register('onproductselect', function(event) { console.log(event); }, gapi.iframes.CROSS_ORIGIN_IFRAMES_FILTER);