اعلان‌های Pub/Sub را تنظیم کنید، اعلان‌های Pub/Sub را تنظیم کنید

اعلان‌های Pub/Sub راهی برای دریافت هشدارهای مربوط به دستگاه‌های ثبت‌نام‌شده جدید، گزارش‌های دستگاه، و فرمان‌های اخیراً صادر شده برای شما فراهم می‌کنند.

برای تنظیم اعلان‌های Pub/Sub، باید Pub/Sub API را فعال کنید و یک موضوع ایجاد کنید. برای دریافت پیام های منتشر شده در یک موضوع، یک اشتراک برای آن موضوع ایجاد کنید. اشتراک موضوع را به یک برنامه مشترک متصل می کند که پیام های منتشر شده برای موضوع را دریافت و پردازش می کند. پس از ایجاد اشتراک، باید به Android Device Policy اجازه انتشار در موضوع خود بدهید.

1. Pub/Sub API را برای پروژه خود فعال کنید

برای دستورالعمل‌های نحوه فعال کردن Pub/Sub API، راهنمای شروع سریع کنسول را ببینید. اطمینان حاصل کنید که همان پروژه ای را انتخاب کنید که Android Management API برای آن فعال است .

2. یک موضوع ایجاد کنید

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

آ. به صورت دستی در کنسول Google Cloud Platform .
ب با استفاده از Pub/Sub API ( به ایجاد موضوع روش مراجعه کنید).

پس از ایجاد یک موضوع، نام موضوع را یادداشت کنید.

3. یک اشتراک ایجاد کنید

اشتراک، جریان پیام‌های منتشر شده برای یک موضوع مشخص را ضبط می‌کند. دو راه برای ایجاد اشتراک وجود دارد:

آ. به صورت دستی در کنسول Google Cloud Platform .
ب با استفاده از Pub/Sub API (به روش ایجاد اشتراک مراجعه کنید).

4. به Android Device Policy حق انتشار در موضوع خود را بدهید

شما باید به android-cloud-policy@system.gserviceaccount.com اجازه دهید تا موضوع خود را منتشر کند. دو راه برای اعطای حقوق انتشار وجود دارد:

آ. به صورت دستی در کنسول Google Cloud Platform .

  • android-cloud-policy@system.gserviceaccount.com را به عنوان عضو به موضوع خود اضافه کنید.
  • روی انتخاب نقش > Pub/Sub > Pub/Sub Publisher کلیک کنید.

ب استفاده از Pub/Sub API ( به کنترل دسترسی از طریق Google Cloud Pub/Sub IAM API مراجعه کنید)

  • serviceAccount:android-cloud-policy@system.gserviceaccount.com به members اضافه کنید.
  • role روی roles/pubsub.publisher تنظیم کنید.

5. شرکت را برای پشتیبانی از اعلان ها به روز کنید

برای اتصال اعلان‌های یک شرکت به موضوعی که ایجاد کرده‌اید، با enterprises.patch تماس بگیرید و پارامترهای زیر را مشخص کنید:

  • pubsubTopic : نام میخانه/موضوع فرعی شما در فرم projects/{project}/topics/{topic} .
  • enabledNotificationTypes : شامل تمام انواع اعلان هایی که می خواهید دریافت کنید. از ENROLLMENT ، STATUS_REPORT ، و COMMAND انتخاب کنید.

6. از Pub/Sub API برای دریافت اعلان ها استفاده کنید

یک اشتراک می تواند از مکانیزم فشار یا کشش برای تحویل پیام استفاده کند. دستورالعمل‌ها و دستورالعمل‌های نحوه دریافت اعلان‌ها از طریق هر دوی این مکانیسم‌ها در راهنمای مشترک Pub/Sub موجود است.

فرمت پیام

پیام ها به شکل PubsubMessage هستند. فیلد attributes پیام حاوی یک مشخصه با کلید notificationType و مقدار تنظیم شده برای نوع اعلانی است که پیام را راه‌اندازی می‌کند (مثلاً ENROLLMENT ). فیلد data پیام حاوی نمایش JSON از منبعی است که به روز شده است و به عنوان رشته UTF-8 کدگذاری شده است. اعلان ها و انواع منابع مربوط به آنها به شرح زیر است:

  • اعلان‌های COMMAND از نوع منبع Operation استفاده می‌کنند.
  • اعلان‌های USAGE_LOGS از نوع منبع UsageLogEvent استفاده می‌کنند.
  • اعلان‌های ENROLLMENT و STATUS_REPORT از نوع منبع Device استفاده می‌کنند.

هنگام تنظیم pubsubTopic در یک شرکت، یک پیام اولیه با notificationType که روی test تنظیم شده است منتشر می شود. این پیام برای تأیید اینکه سیاست دستگاه Android دارای مجوز انتشار در مورد موضوع است ارسال شده است و باید نادیده گرفته شود.