Pub/Sub bildirimlerini ayarlama

Not: Programatik olarak oluşturulmuş ESA'ları olan mevcut EMM iş ortaklarının, Android Management API için Pub/Sub bildirimlerini ayarlamadan önce tercih ettikleri Cloud projesini Google'a kaydettirmeleri gerekir. Daha fazla bilgi için Mevcut EMM iş ortakları için rehber başlıklı makaleyi inceleyin.

Pub/Sub bildirimleri, yeni kaydedilen cihazlar, cihaz raporları ve son yayınlanan komutlar hakkında uyarılar almanızı sağlar.

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 ilgili konuya abone olun. 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 Console Hızlı Başlangıç Kılavuzu'na bakın. Android Management API'nin etkinleştirildiği 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 (create topic yöntemine bakın).

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 (create subscription method bölümüne bakın).

4. Android Device Policy'ye konunuza yayınlama izni verin

[e-mail] hesabına konunuzda yayınlama izni vermeniz gerekir. Yayınlama haklarını vermenin iki yolu vardır:

a. Google Cloud Console'da manuel olarak.

• [e-mail] 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 ile erişimi kontrol etme)

• serviceAccount:[e-mail] öğesini members listesine ekleyin.
• role değerini roles/pubsub.publisher olarak ayarlayın.

5. Bildirimleri desteklemek için işletmeyi güncelleyin

Desteklemek istediğiniz bildirim ENTERPRISE_UPGRADE ise bu adımı atlayın. Bu bildirim her zaman desteklenir.

Bir işletmeyle ilgili bildirimleri oluşturduğunuz konuya bağlamak için enterprises.patch çağrısını yapı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 ekleyin.

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

Abonelikler, ileti teslimi için push veya pull mekanizmasını kullanabilir. Bu iki mekanizma aracılığıyla nasıl bildirim alacağınıza dair yönergeler ve talimatlar Pub/Sub Abone Kılavuzu'nda yer almaktadır.

İleti biçimi

İletiler PubsubMessage biçimindedir. Mesajın attributes alanı, anahtarı notificationType olan ve değeri mesajı tetikleyen bildirim türü olarak ayarlanan bir özellik içerir (ör. ENROLLMENT). Mesajın data alanı, güncellenen kaynağın UTF-8 dizesi olarak kodlanmış JSON gösterimini içerir. Bildirimler ve ilgili kaynak türleri şunlardır:

• COMMAND bildirimleri, Operation kaynak türünü kullanır.
• USAGE_LOGS bildirimlerinde UsageLogEvent kaynak türü kullanılır.
• ENROLLMENT ve STATUS_REPORT bildirimlerinde kaynak türü olarak Cihaz kullanılır.
• ENTERPRISE_UPGRADE bildirimleri, EnterpriseUpgradeEvent kaynak türünü kullanır.

Bir Enterprise'da pubsubTopic ayarlanırken notificationType, test olarak ayarlanmış şekilde ilk mesaj yayınlanır. Bu mesaj, Android Device Policy'nin konu üzerinde yayınlama iznine sahip olduğunu doğrulamak için gönderilir ve yoksayılmalıdır.

Not: Pub/Sub REST API kullanılırken data alanı base64 dizesi olarak kodlanır. Kaynak JSON'ını almak için önce data içeriğinde base64 kod çözme işlemi yapın, ardından ortaya çıkan baytları UTF-8 dizesi olarak yorumlayın.

Beklenen gecikme

Enterprise yükseltme etkinliklerinin hemen gönderilmesi beklenir.

Hızlı bir şekilde gerçekleşen yerel cihaz etkinlikleri, EMM'lere tek bir Pub/Sub mesajında gruplandırılmış ve bildirilmiş olarak gönderilir.

Etkinlik türü	Cihazdaki etkinlik ile ilgili EMM bildirimi arasındaki beklenen gecikme^1
Yüksek öncelikli anahtarlı uygulama durumları	Hemen, en fazla dakikada bir rapor
Standart öncelikli anahtarlı uygulama durumları	Bir dakika içinde
BT yöneticisi tarafından tanımlanan yükleme durumlarına sahip uygulamalar için sağlama sırasında uygulamayla ilgili etkinlikler ^2	Diğer ilgili sağlama etkinliklerinin üzerine bir dakika içinde
BT yöneticisi tarafından yükleme durumları tanımlanan uygulamalar için, sağlama işleminden sonra uygulamayla ilgili etkinlikler.	5 dakika içinde
Uygulama ile ilgili etkinlikler (hem sağlama sırasında hem de sonrasında), yükleme durumları çalışan tarafından tanımlanan uygulamalar için^3	60 dakika içinde
Cihazdaki diğer uygulama etkinlikleri	60 dakika içinde

---

1. Kontrollü koşullara dayalı en iyi çaba hedefleri. Gerçek gecikme süresi, çeşitli cihaz ve çevre faktörlerine göre değişebilir. ↩

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

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