اعلان‌های فشار EMM را فعال کنید

هشدار: این صفحه فقط برای اهداف تاریخی است. به جای آن از اعلان‌های کششی استفاده کنید.

این راهنما فرض می کند که شما قبلا یک ESA به صورت دستی ایجاد کرده اید و به شما نشان می دهد که چگونه آن را برای استفاده با اعلان های فشار EMM پیکربندی کنید. کارها توسط مالک ESA (شما به عنوان ارائه دهنده راه حل EMM یا مشتری شما) با استفاده از Google API Console تکمیل می شوند:

توجه: روش پیشنهادی استفاده از اعلان‌های کششی است که نیازی به این تنظیمات ندارند. برای جزئیات، به تنظیم اعلان EMM مراجعه کنید.

1. دسترسی Google Cloud Pub/Sub API را در Google API Console برای یک پروژه ابری فعال کنید.

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 را انتخاب کنید و سپس روی Enable کلیک کنید.

بعد از اینکه یک API را فعال کردید، از منوی APIs & Services ، روی داشبورد کلیک کنید تا لیستی از همه API های فعال شده خود را ببینید. قبل از اینکه بتوان از Cloud Pub/Sub API برای ارسال پیام به مشتری خود استفاده کرد، باید مجوزهای ویرایشگر را به حساب خدمات مشتری (ESA آن) بدهید.

2. مجوزهای ویرایشگر را به ESA اعطا کنید

از کنسول API، مجوزهای لازم را اعطا کنید:

1. از منوی APIs & Services ، روی Credentials کلیک کنید. باید ESA مشتری خود را در فهرست کلیدهای حساب سرویس ببینید.
2. روی Manage service accounts کلیک کنید تا تمام حساب های سرویس مرتبط با پروژه باز شود.
3. از لیست، حساب ESA مناسب را انتخاب کنید و سپس روی مجوزها کلیک کنید.
4. در قسمت افزودن اعضا :
   • آدرس ایمیل مرتبط با ESA را وارد کنید.
   • از انتخابگر کشویی، ویرایشگر (در کنار فیلد ورودی) را انتخاب کنید.
5. برای ذخیره مجوزها روی Add کلیک کنید.

3. یک پروژه برای دریافت اعلان های EMM راه اندازی کنید

با فعال بودن Cloud Pub/Sub API و ESA که با مجوزهای ویرایشگر پیکربندی شده است، می‌توانید پروژه‌ای را برای دریافت اعلان‌های EMM پیکربندی کنید، همانطور که در تنظیم اعلان‌های فشار EMM توضیح داده شده است. به طور خلاصه، فرآیند راه‌اندازی شامل پیکربندی یک نقطه پایانی سرور HTTP برای ارسال اعلان‌ها به مشترکان است.

اعلان‌های EMM به‌عنوان پروتوباف‌ها (بافرهای پروتکل، قالبی ساده برای سریال‌سازی داده‌های ساخت‌یافته) ارائه می‌شوند که به‌عنوان پیام‌های آرایه بایت کدگذاری‌شده بایت ۶۴ در بسته‌های JSON بسته‌بندی می‌شوند. در کد خود، باید این JSON را تجزیه و محتوای بافر پروتکل را رمزگشایی کنید. در اینجا نمونه‌ای از پروتوباف کدگذاری شده با URL ایمن base64 برای اعلان 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 با موفقیت تنظیم کرده اید و همچنین به شما امکان می دهد نام موضوع را یاد بگیرید (از همان نام موضوع برای ارائه همه اعلان های EMM Google Play استفاده می شود).

با استفاده از Play EMM API، با روش sendTestPushNotification در منبع Enterprises تماس بگیرید.

فراخوانی این عملیات باعث ارسال اعلان EMM آزمایشی می شود. اگر اعلان‌های EMM به درستی پیکربندی شده باشند، API موارد زیر را برمی‌گرداند:

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

5. در موضوع مشترک شوید

با استفاده از کد نمونه ارائه شده در اجرای کد آزمایشی ناشر (در راهنمای Set up EMM push notifications )، در موضوع مشخص شده مشترک شوید. باید اعلان EMM آزمایشی را به همراه هر اعلان واقعی که از زمان شروع فرآیند پیکربندی ایجاد شده است، دریافت کنید.