Enterprises: pullNotificationSet

İstek için kimliği doğrulanmış hizmet hesabıyla ilişkili kuruluşlar için ayarlanan bir bildirimi çeker ve döndürür. Bekleyen bildirim yoksa bildirim grubu boş olabilir.
Bildirim grubunun boş olmaması şartıyla, döndürülen bildirim kümelerinin Enterprises.AcknowledgeNotificationSet çağrılarken 20 saniye içinde onaylanması gerekir.
20 saniye içinde kabul edilmeyen bildirimler, başka bir PullNotificationSet isteğine yanıt olarak sonunda tekrar dahil edilir ve hiçbir zaman onaylanmayan bildirimler, Google Cloud Platform Pub/Sub sistem politikasına göre silinir.
Bildirimleri almak için aynı anda birden fazla istek gerçekleştirilebilir. Bu durumda, bekleyen bildirimler (varsa) her bir arayan arasında bölünerek beklemedeki tüm bildirimlere bölünür.
Bildirim yoksa boş bir bildirim listesi döndürülür. Sonraki istekler, kullanılabilir olduğunda daha fazla bildirim döndürebilir.

İ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 Bildirim alma istek modu.
waitForNotifications öğesinin belirtilmesi, isteğin engellenmesine ve bir veya daha fazla bildirimin mevcut olmasına kadar beklemeye neden olur. Bir süre sonra bildirim yoksa boş bildirim listesi döndürülür.
returnImmediately istemek isteğin beklemedeki bildirimleri veya bildirim yoksa boş bir liste döndürmesine neden olur.
Atlanırsa varsayılan olarak waitForNotifications olur.

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ını inceleyin.

İstek metni

Bu yöntemi içeren bir istek gövdesi sağlamayın.

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 Bildirimi Enterprises.AcknowledgeNotification API ile alındı olarak işaretlemek için gereken bildirim kümesi kimliği. Bildirim yoksa bu filtre çıkarılır.
notification[] list Alınan bildirimler veya hiç bildirim yoksa boş.
notification[].enterpriseId string Bildirimin gönderildiği kuruluşun kimliği. Bu her zaman mevcut olacaktır.
notification[].timestampMillis long 1970-01-01T00:00:00Z tarihinden bu yana bildirimin milisaniye cinsinden yayınlanma zamanı. Bu her zaman mevcut olacaktır.
notification[].productApprovalEvent nested object Ürünün onay durumundaki 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 mevcut olacaktır.
notification[].productApprovalEvent.approved string Ürünün onaylanıp onaylanmadığını gösterir. Bu alan her zaman mevcut olacaktır.

Kabul edilen değerler şunlardır:
  • "approved"
  • "unapproved"
  • "unknown"
notification[].installFailureEvent nested object Uygulama yükleme hatası ile 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 Varsa hatayla ilgili ek ayrıntılar.
notification[].appUpdateEvent nested object Uygulama güncellemeleri hakkında 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 izinleri hakkında 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'lerini kullanın.
notification[].newPermissionsEvent.approvedPermissions[] list Kurumsal yöneticinin bu uygulama için onaylamış olduğu izin grubu. Bu izinlerle ilgili ayrıntıları almak için EMM API'lerini kullanın.
notification[].appRestrictionsSchemaChangeEvent nested object Yeni uygulama kısıtlamaları şema değişiklikleriyle ilgili bildirimler.
notification[].appRestrictionsSchemaChangeEvent.productId string Uygulama kısıtlama şemasının değiştirildiğ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ü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 mevcut olacaktır.

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 Cihazın çeşitli dağıtım yapılandırmalarında 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ığı "managedDevice",
  • DPC'nin profil sahibi olarak ayarlandığı bir cihaz olan "managedProfile".


Kabul edilen 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 Cihazdaki 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ı ile güncellendi. Bu alan her zaman mevcut olacaktır.
notification[].deviceReportUpdateEvent.report.lastUpdatedTimestampMillis long Son raporun zaman damgası, epoch'tan beri geçen milisaniye cinsinden güncellenir. 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 mevcut olur.
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 eyalet sağladığını belirten anahtar. Anahtarın içeriği, uygulamanın geliştiricisi tarafından belirlenir. XSS'yi önlemek için, görüntülemeden önce anahtardan HTML'yi kaldırmanızı öneririz. Bu alan her zaman mevcut olacaktır.
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[].stateTimestampMillis long Uygulamanın Epoch'tan beri 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 serbest biçimli, okunabilir metin. Örneğin, bir hata mesajı. XSS'yi önlemek için, görüntülemeden önce iletideki HTML'nin kaldırılmasını öneririz.
notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[].data string Makine tarafından okunabilir veriler için ek alan. Örneğin, bir sayı veya JSON nesnesi. XSS'yi önlemek için, göstermeden önce HTML'yi verilerden kaldırmanızı öneririz.
kind string