הגדרת התראות ל-EMM

מערכת Google Play יוצרת התראות, שנקראות התראות EMM, תגובה לאירועים שונים שמשפיעים על ארגון. לדוגמה, כאשר אפליקציה אושר, המערכת תשלח התראה ProductApprovalEvent.

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

ההתראות של EMM נשלחות באמצעות Google Cloud Pub/Sub. לקבלת מידע מפורט על מגדירים התראות Pub/Sub, בודקים את המנויים סקירה כללית ומנוי ב-Pull מדריך.

כדי לאשר שהגדרת בהצלחה את המערכת לקבל EMM התראות מ-Google Play ולאחזור השם של Cloud Pub/Sub שצריך לקשר את המינוי אליו, להתקשר Enterprises.sendTestPushNotification

שליחה של הודעת בדיקה מאמתת את שילוב ה-EMM עם Google Cloud שירות Pub/Sub לארגון. אם התראות ה-EMM תקינות מוגדר, ה-API מחזיר את הדברים הבאים:

    {
        topic_name: "/projects/project-name/topics/play-work-012345",
        message_id: "128976912439"
    }

שליפת התראות

ב-Google Cloud Pub/Sub יש תמיכה בשני מנגנוני התראות שונים: pull ו בדחיפה. עם זאת, מומלץ להשתמש רק בהתראות משיכה. גישת המשיכה לא מחייב הגדרה של שרת חיצוני, ופועל גם באופן פרוגרמטי ומודעות ESA שנוצרו באופן ידני. יתרון נוסף של התראות משיכה הוא שהן דורשים מעט מאוד הגדרות או תחזוקה מצד הלקוחות. להשתמש Enterprises.pullNotificationSet וגם Enterprises.acknowledgeNotificationSet לקבל ולאשר התראות EMM בשיחות יוצאות לאורך זמן בחיבורים.

בשיחה Enterprises.pullNotificationSet מומלץ להשאיר את ערך ברירת המחדל של requestMode (waitForNotifications). הדבר יגרום לבקשה להמתין עד שאחד או יותר התראות מופיעות לפני החזרת תגובה. אם לא נשלחות התראות קיימת אחרי זמן מה, הבקשה מחזירה רשימת התראות ריקה, אפשר לנסות לשלוח את הבקשה שוב.

אחרי קבלת ההתראות, אפשר להתקשר Enterprises.acknowledgeNotificationSet כדי לוודא שאותן התראות לא יוחזרו בפעם הבאה שתתקשרו Enterprises.pullNotificationSet

אפשר גם להגדיר את requestMode לערך returnImmediately כאשר מתקשרת אל Enterprises.pullNotificationSet. תישלח אליך תשובה בקשה מיידית, שתכיל התראות בהמתנה או רשימה ריקה, אם לא התראות קיימות. האפשרות requestMode יכולה להיות שימושית כאשר מומלץ לבדוק תחילה את ההטמעה של ההתראות.

דוגמאות להתראות EMM

הנה כמה דוגמאות לאירועים וסוגי ההתראות שהם יוצרים:

הערה: סוגי ההתראות הבאים הוצאו משימוש: ProductApprovalEvent, AppUpdateEvent, NewPermissionsEvent, AppRestrictionsSchemaChangeEvent, ProductAvailabilityChangeEvent וגם NewDeviceEvent. עבור AppUpdateEvent, חובה להשתמש מצב עדכון בעדיפות גבוהה בתור בהתאם להמלצות שלנו.

תיאורהתראה
נשלחה בקשה לקבלת התראה לבדיקה דרך API של Google Play EMM. צריך לשלוח התראת בדיקה כדי לאשר המערכת יכולה לקבל את ההתראות ש-Google Play מפרסמת, למדו את שם הנושא המשמש לכל ההתראות המשויכות ל-Google Play. TestPushNotification
מכשיר שהוקצה לאחרונה מוכן לניהול על ידי API של Google Play ל-EMM. מעכשיו אפשר קוראים לממשקי API שנדרשים להם deviceId של המכשיר (התקנות, לדוגמה) וגם ממשקי API שמחזירים מכשירים משאב. ההודעה הזו נשלחת רק אחרי הקצאת החשבון הראשון במכשיר מנוהל. הוצא משימוש NewDeviceEvent
אדמין מסמן אפליקציה כאושרה או לא אושרה מסוף Google Play לארגונים. הוצא משימוש ProductApprovalEvent
הזמן הקצוב לתפוגה של התקנה בהמתנה במכשיר פג. לדוגמה, דחיפה התקבלה, אבל המכשיר לא נגיש לכמה אנשים ימים, לכן לא ניתן לאשר את ההתקנה. המערכת שולחת זמן קצוב לתפוגה של התקנה התראה.InstallFailureEvent
פורסמה גרסה חדשה של האפליקציה. העדכון זמין לאחד או יותר, אבל לא בהכרח את כל המכשירים. הוצא משימוש AppUpdateEvent
עדכון לאפליקציה מחייב הרשאה חדשה שהאדמין יאשר, לכן שעדכון או התקנה חדשה יכולים להתרחש. ההתראה הזו נשלחת כאשר קבוצת ההרשאות של האפליקציות שהתקבלו שונה מהאפליקציות הוגדרו ההרשאות הנדרשות. הוצא משימוש NewPermissionsEvent
פורסמה גרסה חדשה של אפליקציה שכוללת גרסה חדשה או גרסה שעברה שינוי סכימת הגדרות מנוהלות. כאשר מפתח מעלה APK חדש, Google Play משווה את הסכימה במניפסט אל את הסכימה בגרסה הקודמת של האפליקציה. אם הסכימה השתנתה, היא מודיע לארגונים שאישרו את האפליקציה. הוצא משימוש AppRestrictionsSchemaChangeEvent
אפליקציה זמינה מפסיקה להיות זמינה, או שאפליקציה לא זמינה מתווספת מחדש אל Google Play. הזמינות של האפליקציה משתנה אם המפתח מבטל את הפרסום אותו, או שהוא יוסר מ-Google Play. סטטוס הזמינות משתנה גם במקרים שבהם אפליקציה שאינה זמינה מתווספת מחדש ל-Google Play. הוצא משימוש ProductAvailabilityChangeEvent