Pub/Sub bildirimlerini ayarlama

Pub/Sub bildirimleri; yeni kaydedilen cihazlar, cihaz raporları ve yakın zamanda verilen komutlar hakkında uyarı almanızı sağlayan bir yöntem sunar.

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 abonelik oluşturun. Abonelik, konuyu, konuda yayınlanan mesajları alan ve işleyen bir abone uygulamasına bağlar. Abonelik oluşturduktan sonra, Android Device Policy'nin konunuzla ilgili yayın yapmasına izin vermeniz gerekir.

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

Pub/Sub API'yi nasıl etkinleştireceğinizle ilgili talimatlar için konsol hızlı başlangıç kılavuzuna 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. Bir konu oluşturmanın iki yolu vardır:

a. Google Cloud Platform Console'da manuel olarak.
b. Pub/Sub API'yi kullanma (topicmethod oluşturma 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 Platform 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ını vermenin iki yolu vardır:

a. Google Cloud Platform 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 (Google Cloud Pub/Sub IAM API aracılığıyla erişim denetimi bölümüne bakın)

  • members hesabına serviceAccount:android-cloud-policy@system.gserviceaccount.com 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: projects/{project}/topics/{topic} biçimindeki pub/sub konunuzun 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 bildirim almayla ilgili yönergeler ve talimatları Pub/Sub Abone Kılavuzu'nda bulabilirsiniz.

Mesaj biçimi

Mesajlar PubsubMessage biçiminde olur. Mesajın attributes alanında, anahtara sahip notificationType bir özellik ve mesajı tetikleyen bildirim türüne ayarlanmış değer bulunur (ör. ENROLLMENT). Mesajın data alanı, güncellenen dizenin UTF-8 olarak kodlanmış JSON gösterimini içerir. Bildirimler ve bunlarla ilgili 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.

Bir kuruluşta pubsubTopic ayarlanırken notificationType değeri test olarak ayarlanmış bir ilk mesaj yayınlanır. Bu mesaj, Android Device Policy'nin konuda yayınlama iznine sahip olduğunu ve yoksayılacağını doğrulamak için gönderilmiştir.