הפעלת התראות של EMM

במדריך הזה יוצאים מנקודת הנחה שכבר יצרתם ESA באופן ידני ומראה לכם איך להגדיר אותו לשימוש באמצעות התראות של EMM. המשימות בוצעו על ידי בעלי ה-ESA (את/ה, ספק פתרונות ה-EMM או הלקוח שלך) באמצעות Google API Console:

1. להפעיל גישה ל-Google Cloud Pub/Sub API במסוף Google API עבור של פרויקט בענן.

2. מעניקים הרשאות עריכה ל-ESA.

3. צריך להגדיר פרויקט כדי לקבל התראות EMM.

4. שליחת התראת EMM לבדיקה.

5. הרשמה לנושא.

השלבים האלה מתוארים בצורה מלאה יותר בקטעים הבאים.

1. הפעלת גישה ל-Cloud Pub/Sub API בפרויקט

כדי להפעיל את Cloud Pub/Sub API בפרויקט:

  1. במסוף ה-API, פותחים את ספריית ה-API. יש לבחור באחת מהאפשרויות הבאות את הפרויקט (או ליצור פרויקט חדש, אם יש צורך). בספריית ה-API יש רשימה של כל הפריטים ממשקי ה-API הזמינים שמקובצים לפי משפחת המוצרים והפופולריות שלהם.
  2. בקטע Google Cloud APIs, מאתרים את Cloud Pub/Sub API. (אם לא) מופיע ברשימה, השתמש בחיפוש כדי למצוא אותו).
  3. בוחרים באפשרות Cloud Pub/Sub API ולוחצים על הפעלה.

אחרי שתפעילו ממשק API, עוברים לקטע APIs & תפריט שירותים, לחיצה במרכז השליטה תוכלו לראות רשימה של כל ממשקי ה-API שהופעלו. לפני הענן אפשר להשתמש ב-Pub/Sub API לשליחת הודעות ללקוח, עליך להעניק ל-Editor הרשאות לחשבון השירות של הלקוח הזה (ה-ESA שלו).

2. מתן הרשאות עריכה ל-ESA

ממסוף ה-API, מעניקים את ההרשאות הדרושות:

  1. מתוך ממשקי API בתפריט שירותים, לוחצים על פרטי כניסה. אתם צריכים ראה את ה-ESA של הלקוח שלך מופיע בקטע 'מפתחות של חשבון שירות'.
  2. לוחצים על Manage service accounts כדי לפתוח את כל חשבונות השירות. שמשויך לפרויקט.
  3. בוחרים את חשבון ה-ESA המתאים מהרשימה ולוחצים על הרשאות.
  4. בשדה הוספת חברים:
    • מזינים את כתובת האימייל שמשויכת ל-ESA.
    • מהבורר הנפתח, בוחרים באפשרות עריכה (לצד שדה להזנת כניסה).
  5. לוחצים על הוספה כדי לשמור את ההרשאות.

3. הגדרת פרויקט לקבלת התראות EMM

כש-Cloud Pub/Sub API מופעל ו-ESA מוגדר באמצעות Editor הרשאות, אפשר להגדיר שפרויקט יקבל התראות של EMM כמפורט בקטע הגדרה התראות של EMM. בקצרה, תהליך ההגדרה כולל הגדרת נקודת קצה (endpoint) של שרת HTTP לשליחת התראות למנויים.

התראות EMM נשלחות כ- protobufs (מאגרי פרוטוקולים, פורמט פשוט לשינוי סריאלי של נתונים מובְנים) שארוז כ הודעות עם מערך בייטים בקידוד byte64 בתוך חבילות JSON. בקוד שלכם, צריך ניתוח JSON ופענוח תוכן מאגר הנתונים הזמני של הפרוטוקול. הנה דוגמה של Protobuf בקידוד Base64 בקידוד כתובת URL בטוחה עבור NewPermissionsEvent התראה:


CglDMTIzNDU2NzgQgM-C6sMqOooBChdhcHA6Y29tLmZha2VhcHAuZXhhbXBsZRIpYW5kcm9pZ
C5wZXJtaXNzaW9uLldSSVRFX0VYVEVSTkFMX1NUT1JBR0UaKGFuZHJvaWQucGVybWlzc2lvbi5SRUF
EX0VYVEVSTkFMX1NUT1JBR0UaGmFuZHJvaWQucGVybWlzc2lvbi5WSUJSQVRF

הוא מפענח ל:


{
 enterprise_id: "C12345678"
 event_notification_sent_timestamp_millis: 1461316528000 # 1.33Ti;
    [as milliseconds]: 2016-04-22 10:15:28 +0100
 new_permissions_event: {
   product_id: "app:com.fakeapp.example"
   requested_permissions: [ "android.permission.WRITE_EXTERNAL_STORAGE" ]
   approved_permissions : [ "android.permission.READ_EXTERNAL_STORAGE",
    "android.permission.VIBRATE" ]
  }
}

כדי לפענח את התראות ה-EMM בפורמט Protobuf, ניתן להשתמש קובץ אחד (emm_pubsub.proto) נמצא ב- ה מאגר google/play-work ב-GitHub. מתי סוגים חדשים של התראות נוסף, הקובץ יורחב בסוג החדש והקוד לדוגמה יעודכן. השינויים האלה צריכים להיות תואמים לאחור, אבל צריך לוודא שהקוד יכול להתמודד עם קבלת התראות מסוגים לא ידועים, שמפורטות בקובץ ה- .proto.

4. שליחת התראת EMM לבדיקה

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

באמצעות ה-API של Play EMM, קוראים ל-method sendTestPushNotification במשאב Enterprises.

הפעלת הפעולה הזו תגרום לשליחת התראת EMM לבדיקה. אם EMM שההתראות מוגדרות כראוי, ה-API מחזיר את הדברים הבאים:

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

5. הרשמה לנושא

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