Enterprises: pullNotificationSet

Şununla ilişkili kuruluşlar için bir bildirim grubu alır ve döndürür: istek için kimliği doğrulanan hizmet hesabı. Ayarlanan bildirimin Bekleyen bildirim yoksa boş bırakılmalıdır.
Döndürülen bildirimin 20 saniye içinde onaylanması gerekir Enterprises.AcknowledgeBildirimSet'i çağırarak bildirim grubu boş.
20 saniye içinde onaylanmayan bildirimler daha sonra başka bir PushBildirimSet'e verilen yanıta tekrar dahil edilir. ve asla kabul edilmeyenler de nihayetinde silinir. Google Cloud Platform Pub/Sub sistem politikasına göre.
Almak için eşzamanlı olarak birden fazla istek gerçekleştirilebilir Bu durumda, bekleyen bildirimler (varsa) ve bekleyenler arasında bölüşün.
Herhangi bir bildirim yoksa boş bir bildirim listesi döndürülür. Sonraki istekler, aşağıdaki istekler olduğunda daha fazla bildirim döndürebilir: kullanılabilir.

İstek

HTTP isteği

POST https://www.googleapis.com/androidenterprise/v1/enterprises/pullNotificationSet

Parametreler

Parametre adı Değer Açıklama
İsteğe bağlı sorgu parametreleri
requestMode string Bildirimleri almak için istek modu.
waitForNotifications değerinin belirtilmesi, isteğin engellemek ve bir veya daha fazla bildirim mevcut olana kadar bekleyin veya bir bir süre sonra bildirim olmazsa boş bildirim listesinden çıkar.
returnImmediately değerinin belirtilmesi, isteğin bekleyen bildirimlere hemen dönebilir ya da bildirim yoksa boş bir liste oluşturabilirsiniz. bildirim olduğundan emin olun.
Atlanırsa varsayılan olarak waitForNotifications değerine ayarlanır.

Kabul edilen değerler şunlardır:
  • "returnImmediately"
  • "waitForNotifications"

Yetkilendirme

Bu istek, aşağıdaki kapsamla yetkilendirme gerektiriyor:

Kapsam
https://www.googleapis.com/auth/androidenterprise

Daha fazla bilgi edinmek için kimlik doğrulama ve yetkilendirme sayfasına göz atın.

İstek içeriği

Bu yöntemle istek gövdesi göndermeyin.

Yanıt

Başarılı olursa bu yöntem, aşağıdaki yapıya sahip bir yanıt gövdesi döndürür:

{
  "kind": "androidenterprise#notificationSet",
  "notificationSetId": string,
  "notification": [
    {
      "enterpriseId": string,
      "timestampMillis": long,
      "notificationType": string,
      "productApprovalEvent": {
        "productId": string,
        "approved": string
      },
      "installFailureEvent": {
        "productId": string,
        "deviceId": string,
        "userId": string,
        "failureReason": string,
        "failureDetails": string
      },
      "appUpdateEvent": {
        "productId": string
      },
      "newPermissionsEvent": {
        "productId": string,
        "requestedPermissions": [
          string
        ],
        "approvedPermissions": [
          string
        ]
      },
      "appRestrictionsSchemaChangeEvent": {
        "productId": string
      },
      "productAvailabilityChangeEvent": {
        "productId": string,
        "availabilityStatus": string
      },
      "newDeviceEvent": {
        "userId": string,
        "deviceId": string,
        "managementType": string,
        "dpcPackageName": string
      },
      "deviceReportUpdateEvent": {
        "userId": string,
        "deviceId": string,
        "report": {
          "lastUpdatedTimestampMillis": long,
          "appState": [
            {
              "packageName": string,
              "keyedAppState": [
                {
                  "key": string,
                  "stateTimestampMillis": long,
                  "severity": string,
                  "message": string,
                  "data": string
                }
              ]
            }
          ]
        }
      }
    }
  ]
}
Mülk adı Değer Açıklama Notlar
notificationSetId string Enterprises.Acknowledge Notification API ile bildirimi alındı olarak işaretlemek için gereken bildirim grubu kimliği. Herhangi bir bildirim yoksa bu adım atlanır.
notification[] list Alınan bildirimler boş bırakılır veya bildirim yoksa boş bırakılır.
notification[].enterpriseId string Bildirimin gönderildiği kuruluşun kimliği. Bu ad her zaman mevcuttur.
notification[].timestampMillis long Bildirimin yayınlandığı zaman (1970-01-01T00:00:00Z'den itibaren milisaniye cinsinden). Bu ad her zaman mevcuttur.
notification[].productApprovalEvent nested object Bir ürünün onay durumunda yapılan değişikliklerle ilgili bildirimler.
notification[].productApprovalEvent.productId string Onay durumunun değiştiği ürünün kimliği (ör. "app:com.google.android.gm"). Bu alan her zaman mevcuttur.
notification[].productApprovalEvent.approved string Ürünün onaylı olup olmadığı. Bu alan her zaman mevcut olacaktır.

Kabul edilen değerler şunlardır:
  • "approved"
  • "unapproved"
  • "unknown"
notification[].installFailureEvent nested object Uygulama yükleme hatasıyla ilgili bildirimler.
notification[].installFailureEvent.productId string Yükleme hatası etkinliğinin gerçekleştiği ürünün kimliği (ör. "app:com.google.android.gm). Bu alan her zaman mevcut olacaktır.
notification[].installFailureEvent.deviceId string Cihazın Android kimliği. Bu alan her zaman mevcut olacaktır.
notification[].installFailureEvent.userId string Kullanıcının kimliği. Bu alan her zaman mevcut olacaktır.
notification[].installFailureEvent.failureReason string Yükleme hatasının nedeni. Bu alan her zaman mevcut olacaktır.

Kabul edilen değerler şunlardır:
  • "timeout"
  • "unknown"
notification[].installFailureEvent.failureDetails string Hatayla ilgili ek ayrıntılar (varsa).
notification[].appUpdateEvent nested object Uygulama güncellemeleriyle ilgili bildirimler.
notification[].appUpdateEvent.productId string Güncellenen ürünün kimliği (ör. "app:com.google.android.gm"). Bu alan her zaman mevcut olacaktır.
notification[].newPermissionsEvent nested object Yeni uygulama izinleriyle ilgili bildirimler.
notification[].newPermissionsEvent.productId string Yeni izinlerin eklendiği ürünün kimliği (ör. "app:com.google.android.gm"). Bu alan her zaman mevcut olacaktır.
notification[].newPermissionsEvent.requestedPermissions[] list Uygulamanın şu anda istediği izin grubu. Bu izinlerle ilgili ayrıntıları almak için EMM API'de Permissions.Get'i kullanın.
notification[].newPermissionsEvent.approvedPermissions[] list Kurumsal yöneticinin bu uygulama için önceden onayladığı izin grubu. İzinleri kullanın.Bu izinlerle ilgili ayrıntıları almak için EMM API'yi kullanın.
notification[].appRestrictionsSchemaChangeEvent nested object Yeni uygulama kısıtlamaları şemasındaki değişikliklerle ilgili bildirimler.
notification[].appRestrictionsSchemaChangeEvent.productId string Uygulama kısıtlama şemasının değiştiği ürünün kimliği (ör. "app:com.google.android.gm"). Bu alan her zaman mevcut olacaktır.
notification[].productAvailabilityChangeEvent nested object Ürün stok durumu değişiklikleriyle ilgili bildirimler.
notification[].productAvailabilityChangeEvent.productId string Ürün stok durumunun değiştiği ürünün kimliği (ör. "app:com.google.android.gm"). Bu alan her zaman mevcut olacaktır.
notification[].productAvailabilityChangeEvent.availabilityStatus string Ürünün yeni durumu. Bu alan her zaman mevcuttur.

Kabul edilen değerler şunlardır:
  • "available"
  • "removed"
  • "unknown"
  • "unpublished"
notification[].newDeviceEvent nested object Yeni cihazlarla ilgili bildirimler.
notification[].newDeviceEvent.userId string Kullanıcının kimliği. Bu alan her zaman mevcut olacaktır.
notification[].newDeviceEvent.deviceId string Cihazın Android kimliği. Bu alan her zaman mevcut olacaktır.
notification[].newDeviceEvent.managementType string Çeşitli dağıtım yapılandırmalarında cihazın bir Android EMM tarafından ne ölçüde kontrol edildiğini tanımlar.

Olası değerler şunları içerir:
  • DPC'nin cihaz sahibi olarak ayarlandığı bir cihaz olan "managedDevice",
  • "managedProfile", İTŞ'nin profil sahibi olarak ayarlandığı cihaz.


Kabul edilebilir değerler şunlardır:
  • "managedDevice"
  • "managedProfile"
notification[].notificationType string Bildirimin türü.

Kabul edilen değerler şunlardır:
  • "appRestricionsSchemaChange"
  • "appUpdate"
  • "deviceReportUpdate"
  • "installFailure"
  • "newDevice"
  • "newPermissions"
  • "productApproval"
  • "productAvailabilityChange"
  • "testNotification"
  • "unknown"
notification[].newDeviceEvent.dpcPackageName string Politika uygulaması.
notification[].deviceReportUpdateEvent nested object Cihaz raporu güncellemeleriyle ilgili bildirimler.
notification[].deviceReportUpdateEvent.userId string Kullanıcının kimliği. Bu alan her zaman mevcut olacaktır.
notification[].deviceReportUpdateEvent.deviceId string Cihazın Android kimliği. Bu alan her zaman mevcut olacaktır.
notification[].deviceReportUpdateEvent.report nested object Cihaz raporu en son uygulama durumlarıyla güncellendi. Bu alan her zaman mevcut olacaktır.
notification[].deviceReportUpdateEvent.report.lastUpdatedTimestampMillis long Dönemden beri geçen son rapor güncellemesinin milisaniye cinsinden zaman damgası. Bu alan her zaman mevcut olacaktır.
notification[].deviceReportUpdateEvent.report.appState[] list Cihazdaki yönetilen uygulamalar tarafından ayarlanan uygulama durumlarının listesi. Uygulama durumları, uygulamanın geliştiricileri tarafından tanımlanır. Bu alan her zaman mevcut olacaktır.
notification[].deviceReportUpdateEvent.report.appState[].packageName string Uygulamanın paket adı. Bu alan her zaman mevcuttur.
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[] list Anahtarlı uygulama durumlarının listesi. Bu alan her zaman mevcut olacaktır.
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[].key string Uygulamanın ne için durum sağladığını gösteren anahtar. Anahtarın içeriği, uygulamanın geliştiricisi tarafından ayarlanır. XSS'yi önlemek için, görüntülemeden önce anahtardaki tüm HTML'leri kaldırmanızı öneririz. Bu alan her zaman mevcuttur.
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[].stateTimestampMillis long Uygulamanın, epoch'tan bu yana durumu milisaniye cinsinden ayarladığı zaman damgası. Bu alan her zaman mevcut olacaktır.
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[].severity string Uygulama durumunun önem derecesi. Bu alan her zaman mevcut olacaktır.

Kabul edilen değerler şunlardır:
  • "severityError"
  • "severityInfo"
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[].message string Uygulama durumunu açıklayan, kullanıcıların okuyabileceği serbest biçimli mesaj. Örneğin, bir hata mesajı. XSS'yi önlemek için mesajı göstermeden önce mesajdaki tüm HTML'leri kaldırmanızı öneririz.
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[].data string Makine tarafından okunabilir veriler için tasarlanmış ek alan. Örneğin, bir sayı veya JSON nesnesi. XSS'yi önlemek için, görüntülemeden önce verilerden tüm HTML'leri kaldırmanızı öneririz.
kind string