חשוב: אנחנו לא מקבלים יותר רישומים חדשים עבור Play EMM API. מידע נוסף

דף זה תורגם על ידי Cloud Translation API.

iframe מנוהל של Google Play

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

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

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

כברירת מחדל, כל הדפים מופעלים ב-iframe, אבל אפשר להשבית אותם בנפרד (מידע נוסף זמין במאמר הוספת ה-iframe למסוף).

תכונות

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

חיפוש אפליקציות

בדף 'חיפוש אפליקציות' (שמוצג באיור 1) האדמינים יכולים לחפש אפליקציות ב-Google Play, לעיין בהן ולבחור אותן.

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

אפליקציות פרטיות

בדף Private apps (אפליקציות פרטיות), מנהלי IT יכולים לפרסם ולנהל אפליקציות פרטיות ישירות מהמסוף של ה-EMM. כדי לפשט את פרסום האפליקציות הפרטיות למנהלי IT, הדף:

יצירת חשבון Play Console בשקט בשם הארגון והענקת הרשאת אדמין לאדמינים ב-IT.
ביטול דמי הרישום בסך 25 $ב-Play Console שנדרשו בעבר לפרסום אפליקציות.
נדרשים רק קובץ ה-APK והשם של האפליקציה.
פרסום אפליקציות תוך 10 דקות לכל היותר (לעומת שעתיים ב-Play Console).
הערה: אי אפשר להפוך לאפליקציות גלויות לכולם אפליקציות שפורסמו מהדף 'אפליקציות פרטיות'.

בפעם הראשונה שמנהל IT מפרסם אפליקציה ב-iframe, ה-iframe יוצר חשבון Play Console בשקט בשם הארגון. אם הם יבצעו עריכות מתקדמות, הם יתבקשו להיכנס באמצעות חשבון Google – יכול להיות שזה יהיה כל חשבון Google (למשל, Gmail,‏ Cloud Identity). חשבון Google הזה מתווסף כאדמין של חשבון Play Console של הארגון. לאחר מכן, אדמין IT יכול להשתמש בחשבון Google שלו כדי להיכנס ישירות ל-Play Console, שם הוא יכול:

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

הוראות לאדמינים ב-IT בנושא השימוש בדף 'אפליקציות פרטיות' זמינות במרכז העזרה של Google Play לארגונים.

לחצן הבחירה

אחרי פרסום האפליקציה, אדמין IT יכול לערוך את השם ואת קובץ ה-APK שלה בדף פרטי האפליקציה. בדף הפרטים של האפליקציה מוצג גם לחצן SELECT (ראו איור 2). צריך לציין את הפעולה שתתבצע כשאדמין ה-IT ילחץ על הלחצן הזה (ראו onproductselect בשלב 3. טיפול באירועים של iframe).

אפליקציות אינטרנט

בדף 'אפליקציות אינטרנט', אדמינים ב-IT יכולים לפרסם קיצורי דרך לאתרים כאפליקציות פרטיות ב-Google Play לארגונים. אפליקציות אינטרנט מזוהות לפי שם החבילה שלהן (productId), והן מתפרסמות בדרך כלל תוך 10 דקות. אחרי הפרסום, האפליקציות מאושרות באופן אוטומטי לארגון שלכם, וניתן להפיץ אותן למשתמשים כמו כל אפליקציה אחרת שאושרה. אפליקציות אינטרנט תואמות לתכונות אחרות של iframe מנוהל ב-Play: אפשר לחפש אותן בדף החיפוש ב-Play ולהוסיף אותן לאוספים.

טופס היצירה של אפליקציית האינטרנט כולל את הפרטים הבאים: שם, כתובת URL מסוג HTTPS או HTTP ותמונה של סמל (JPG בגודל 512x512 או PNG ב-32 ביט). בנוסף, אדמינים ב-IT יכולים לבחור מבין שלוש אפשרויות התצוגה:

מסך מלא: האפליקציה נפתחת במסך מלא, וסרגל הסטטוס וסרגל הניווט של המכשיר מוסתרים.
עצמאית (ברירת המחדל): האפליקציה מציגה את שורת הסטטוס ואת סרגל הניווט של המכשיר.
ממשק משתמש מינימלי: באפליקציה מוצגים סרגל הסטטוס וסרגל הניווט של המכשיר, כתובת ה-URL של האפליקציה ואפשרות לרענון. בכתובות URL מסוג HTTP, זו האפשרות היחידה שזמינה.

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

לחצן הבחירה

אחרי שפורסמת אפליקציית אינטרנט, דף הפרטים שלה כולל לחצן בחירה. צריך לציין את הפעולה (לדוגמה, הפצת האפליקציה) שתתבצע כשאדמין ה-IT ילחץ על הלחצן הזה (ראו onproductselect בקטע שלב 3. טיפול באירועים של iframe).

ארגון אפליקציות

בדף 'ארגון האפליקציות', אדמינים ב-IT יכולים לארגן אפליקציות באוספים (שנקראים גם אשכולות). לדוגמה, אדמין IT יכול ליצור אוסף בשם Essentials לאפליקציות שבהן משתמשים לעיתים קרובות, או אוסף בשם Expenses לאפליקציות שקשורות למעקב אחרי הוצאות, לתיעוד נסיעות וכו'. האוספים מוצגים בדף הבית של Play Store במכשירים של המשתמשים.

פלטפורמות EMM צריכות להשתמש ב- SELECT mode בפרמטרים של כתובת ה-URL של ה-iframe כדי לאפשר חיפוש של אפליקציות והוספה שלהן לאוספים.

במכשירים של המשתמשים, באפליקציית Play Store מוצגות רק אפליקציות מהאוסף שזמינות למשתמש (או למכשיר). אם האוסף לא כולל אפליקציות שזמינות למשתמש (או למכשיר), האוסף לא יופיע בחנות Play.

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

הוספת ה-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 לבחור אפליקציות, לאשר אותן ולבטל את האישור שלהן. הוצאה משימוש: המצב הזה הוצא משימוש. במקום זאת, צריך להשתמש ב-`SELECT`. לאף אחד לא תהיה גישה לשיטה הזו אחרי 30 בספטמבר 2025. המודל `APPROVE` פועל רק אם הערך של `PlaySearch.ApproveApps` מוגדר ל-`true` באסימון האינטרנט.
`showsearchbox`	חיפוש אפליקציות	לא	`TRUE` (ברירת המחדל): הצגת תיבת החיפוש והפעלת שאילתת החיפוש מתוך מסגרת ה-iframe. `FALSE`: תיבת החיפוש לא מוצגת.
`search`	חיפוש אפליקציות	לא	מחרוזת חיפוש. אם מצוין, ה-iframe מפנה את מנהל ה-IT לתוצאות חיפוש עם המחרוזת שצוינה. הערה: יש לכלול את הפרמטר הזה רק כאשר תיבת החיפוש ממוקמת מחוץ ל-iframe (`showsearchbox = FALSE`).

שלב 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

המשתמש בוחר או מאשר אפליקציה. הפונקציה מחזירה אובייקט שמכיל את הפרטים הבאים:

{
    "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);