Pub/Sub bildirimlerini ayarlama

Pub/Sub bildirimleri sayesinde yeni kaydedilen cihazlar, cihaz raporları ve yakın zamanda verilen komutlar hakkında uyarılar alabilirsiniz.

Pub/Sub bildirimlerini ayarlamak için Pub/Sub API'yi etkinleştirmeniz ve bir konu oluşturmanız gerekir. Bir konuda yayınlanan mesajları almak için söz konusu konuya abonelik oluşturun. Abonelik, konuyu konuya yayınlanan mesajları alan ve işleyen bir abone uygulamasına bağlar. Abonelik oluşturduktan sonra, Android Device Policy'ye konunuzda yayın yapma izni vermeniz gerekir.

1. Projeniz için Pub/Sub API'yi etkinleştirin

Pub/Sub API'yi etkinleştirme talimatları için konsol hızlı başlangıç kılavuzuna bakın. Android Management API'nin etkinleştirildiği projeyle aynı projeyi seçtiğinizden emin olun.

2. Konu oluşturma

API'yi etkinleştirdikten sonra, Android Device Policy'nin bildirim yayınlayabileceği bir konu oluşturmanız gerekir. Konu oluşturmanın iki yolu vardır:

a. Google Cloud Console'da manuel olarak.
b. Pub/Sub API'yi kullanma (konu oluşturma yöntemi bölümüne bakın).

Bir konu oluşturduktan sonra konu adını not edin.

3. Abonelik oluşturma

Abonelik, belirli bir konuda yayınlanan mesajların akışını yakalar. Abonelik oluşturmanın iki yolu vardır:

a. Google Cloud Console'da manuel olarak.
b. Pub/Sub API'yi kullanma (abonelik oluşturma yöntemi bölümüne bakın).

4. Android Device Policy'ye konunuzu yayınlama hakkı verin

android-cloud-policy@system.gserviceaccount.com adresine konunuzu yayınlama izni vermeniz gerekir. Yayıncılık hakları vermenin iki yolu vardır:

a. Google Cloud Console'da manuel olarak.

  • android-cloud-policy@system.gserviceaccount.com adresini konunuza üye olarak ekleyin.
  • Rol seçin > Pub/Sub > Pub/Sub Yayıncısı'nı tıklayın.

b. Pub/Sub API'yi kullanma (bkz. IAM API'si aracılığıyla erişimi kontrol etme)

  • serviceAccount:android-cloud-policy@system.gserviceaccount.com adlı kullanıcıyı members hesabına ekleyin.
  • role öğesini roles/pubsub.publisher olarak ayarlayın.

5. Bildirimleri desteklemek için kuruluşu güncelleyin

Bir kuruluşla ilgili bildirimleri, oluşturduğunuz konuya bağlamak için enterprises.patch numaralı telefonu arayın ve aşağıdaki parametreleri belirtin:

  • pubsubTopic: Pub/Sub konunuzun projects/{project}/topics/{topic} biçimindeki adı.
  • enabledNotificationTypes: Almak istediğiniz tüm bildirim türlerini dahil edin. ENROLLMENT, STATUS_REPORT ve COMMAND arasından seçim yapın.

6. Bildirim almak için Pub/Sub API'yi kullanma

Aboneliklerde ileti teslimi için itme veya çekme mekanizması kullanılabilir. Bu iki mekanizma aracılığıyla nasıl bildirim alacağınızla ilgili yönergeler ve talimatları Pub/Sub Abone Kılavuzu'nda bulabilirsiniz.

Mesaj biçimi

İletiler PubsubMessage biçimindedir. Mesajın attributes alanında, mesajı tetikleyen bildirim türü olarak notificationType anahtarı ve değeri ayarlanmış bir özellik (ör. ENROLLMENT) bulunur. Mesajın data alanında, güncellenen kaynağın UTF-8 dizesi olarak kodlanmış JSON gösterimi yer alır. Bildirimler ve karşılık gelen kaynak türleri aşağıdaki gibidir:

  • COMMAND bildirimleri, İşlem kaynak türünü kullanır.
  • USAGE_LOGS bildirimleri, UsageLogEvent kaynak türünü kullanır.
  • ENROLLMENT ve STATUS_REPORT bildirimleri, Cihaz kaynak türünü kullanır.

pubsubTopic bir kuruluşta ayarlanırken notificationType öğesinin test olarak ayarlandığı bir ilk mesaj yayınlanır. Bu mesaj, Android Device Policy'nin konu hakkında yayınlama iznine sahip olduğunu ve yoksayılacağını doğrulamak için gönderilir.

Beklenen gecikme

Hızlı bir şekilde art arda gerçekleşen yerel cihaz etkinlikleri toplu hale getirilir ve EMM'lere tek bir Pub/Sub mesajıyla bildirilir.

Etkinlik türü Cihaz üzerindeki etkinlik ve ilgili EMM bildirimi arasında beklenen gecikme1
Yüksek öncelikli anahtarlı uygulama durumları Hemen, dakikada en fazla bir rapor
Standart öncelikli anahtarlı uygulama durumları Bir dakika içinde
BT yöneticisi tarafından tanımlanmış yükleme durumlarına sahip uygulamalar için temel hazırlık sırasında uygulamayla ilgili etkinlikler2 Bir dakika içinde, diğer ilgili sağlama etkinliklerine ek olarak
BT yöneticisi tarafından tanımlanmış yükleme durumlarına sahip uygulamalar için temel hazırlığın ardından uygulamayla ilgili etkinlikler. 5 dakika içinde
Yükleme durumu çalışan tarafından tanımlanan uygulamalar için temel hazırlık sırasında ve sonrasında uygulamayla ilgili etkinlikler3 60 dakika içinde
Diğer cihaz üzerinde uygulama etkinlikleri 60 dakika içinde

  1. Kontrol edilen koşullara dayalı en iyi çaba hedefleri. Gerçek gecikme, çeşitli cihazlara ve çevresel faktörlere bağlı olarak değişiklik gösterebilir. ↩

  2. Politikada zorunlu kılınan uygulamaların InstallType kadarı: FORCE_INSTALLED, BLOCKED, REQUIRED_FOR_SETUP, PREINSTALLED ve KIOSK.↩

  3. Kullanılabilir uygulamaların InstallType kadarı: AVAILABLE, INSTALL_TYPE_UNSPECIFIED.↩