Pub/Sub bildirimlerini ayarlama

Not: Programla 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 kaydetmesi gerekir. Daha fazla bilgi için Mevcut EMM iş ortakları için kılavuz başlıklı makaleyi inceleyin.

Pub/Sub bildirimleri, yeni kayıtlı cihazlar, cihaz raporları ve yakın zamanda verilen komutlar hakkında uyarı 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ştirme

Pub/Sub API'yi etkinleştirmeyle ilgili talimatlar için Console hızlı başlangıç kılavuzuna bakın. Android Management API'nin etkinleştirildiği 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 kullanarak (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 kullanarak (create subscription yöntemine bakın).

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

[e-mail] hesabına, konunuzda yayın yapma izni vermeniz gerekir. Yayınlama hakları verme işlemini iki şekilde yapabilirsiniz:

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 kullanarak (IAM API aracılığıyla erişimi kontrol etme başlıklı makaleyi inceleyin)

• serviceAccount:[e-mail]'ü members'a ekleyin.
• role değerini roles/pubsub.publisher olarak ayarlayın.

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

Destek almak istediğiniz bildirim ENTERPRISE_UPGRADE ise (her zaman desteklenir) bu adımı atlayın.

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

• pubsubTopic: projects/{project}/topics/{topic} biçiminde pub/sub konunuzun adı.
• enabledNotificationTypes: Almaya istediğiniz tüm bildirim türlerini ekleyin. ENROLLMENT, STATUS_REPORT ve COMMAND arasından seçim yapın.

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

Abonelikler, ileti yayınlamak için push veya pull mekanizmasını kullanabilir. Bu iki mekanizmadan da bildirim almayla ilgili kurallar ve talimatlar Pub/Sub abonesi kılavuzunda yer almaktadır.

Mesaj biçimi

Mesajlar PubsubMessage biçimindedir. İletinin attributes alanında, notificationType anahtarına sahip ve iletinin tetiklendiği bildirim türüne (ör. ENROLLMENT) ayarlanmış bir özellik bulunur. İletinin data alanında, güncellenen kaynağın UTF-8 dizesi olarak kodlanmış JSON temsili bulunur. Bildirimler ve bunlara karşılık gelen kaynak türleri şunlardır:

• 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.
• ENTERPRISE_UPGRADE bildirimleri EnterpriseUpgradeEvent kaynak türünü kullanır.

Bir Enterprise'da pubsubTopic ayarlanırken notificationType test olarak ayarlanmış ilk mesaj yayınlanır. Bu mesaj, Android Device Policy'nin konuyla ilgili 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'u almak için önce data içeriğinde Base64 kod çözme işlemini gerçekleştirin, ardından elde edilen baytları UTF-8 dizesi olarak yorumlayın.

Beklenen gecikme

Enterprise yükseltme etkinliklerinin hemen gönderilmesi beklenir.

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

Etkinlik türü	Cihaz üzerindeki etkinlik ile ilgili EMM bildirimi arasındaki beklenen gecikme^1
Yüksek öncelikli anahtarlanmış uygulama durumları	Hemen, en fazla dakikada bir rapor
Standart öncelikli anahtarlanmış uygulama durumları	Bir dakika içinde
BT yöneticisi tarafından tanımlanan yükleme durumlarına sahip uygulamalar için temel hazırlama sırasında uygulamayla ilgili etkinlikler^2	İlgili diğer temel hazırlama etkinliklerinin yanı sıra bir dakika içinde
BT yöneticisi tarafından tanımlanan yükleme durumlarına sahip uygulamalar için, temel hazırlığın ardından uygulamayla ilgili etkinlikler.	5 dakika içinde
Çalışan tarafından tanımlanan yükleme durumlarının olduğu uygulamalar için hem temel hazırlama sırasında hem de sonrasında uygulamayla ilgili etkinlikler^3	60 dakika içinde
Cihaz üzerindeki diğer uygulama etkinlikleri	60 dakika içinde

---

1. Kontrollü koşullara dayalı en iyi girişim hedefleri. Gerçek gecikme, çeşitli cihaz ve çevresel faktörlere göre değişiklik gösterebilir. ↩

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

3. Mevcut uygulamalardan InstallType: AVAILABLE, INSTALL_TYPE_UNSPECIFIED. ↩