Önemli: Artık Play EMM API için yeni kayıtlar kabul edilmemektedir. Daha fazla bilgi edinin.

Bu sayfa, Cloud Translation API ile çevrilmiştir.

Enterprises: pullNotificationSet
Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

İstek için kimlik doğrulaması yapılan hizmet hesabıyla ilişkili kuruluşlar için bir bildirim grubunu alır ve döndürür. Bekleyen bildirim yoksa bildirim grubu boş olabilir.
İade edilen bir bildirim grubunun, bildirim grubu boş olmadığı sürece 20 saniye içinde Enterprises.AcknowledgeNotificationSet çağrısı yapılarak onaylanması gerekir.
20 saniye içinde onaylanmayan bildirimler, başka bir PullNotificationSet isteğinin yanıtına tekrar dahil edilir. Hiçbir zaman onaylanmayan bildirimler ise Google Cloud Platform Pub/Sub sistem politikasına göre silinir.
Bildirimleri almak için eşzamanlı olarak birden fazla istek gönderilebilir. Bu durumda, bekleyen bildirimler (varsa) her bir arayanın arasında paylaştırılır.
Bildirim yoksa boş bir bildirim listesi döndürülür. Daha sonra yapılan istekler, kullanılabilir hale geldiklerinde 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`	Bildirimleri çekme isteği modu. `waitForNotifications` belirtildiğinde istek engellenir ve bir veya daha fazla bildirim gelene kadar beklenir ya da bir süre sonra bildirim gelmezse boş bir bildirim listesi döndürülür. `returnImmediately` belirtildiğinde istek, bekleyen bildirimleri hemen döndürür veya bildirim yoksa boş bir liste döndürür. Boş bırakılırsa varsayılan olarak `waitForNotifications` olur. Kabul edilen değerler şunlardır: "`returnImmediately`" "`waitForNotifications`"

Yetkilendirme

Bu istek için aşağıdaki kapsamda yetkilendirme gerekir:

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

Daha fazla bilgi için kimlik doğrulama ve yetkilendirme sayfasına bakı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 metni 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
                }
              ]
            }
          ]
        }
      },
      "enterpriseUpgradeEvent": {
        "upgradeState": string
      }
    }
  ]
}

Mülk adı	Değer	Açıklama
`notificationSetId`	`string`	Bildirimi Enterprises.AcknowledgeNotification API ile alındı olarak işaretlemek için gereken bildirim grubu kimliği. Bildirim yoksa bu alan atlanır.
`notification[]`	`list`	Alınan bildirimler veya bildirim yoksa boş.
`notification[].enterpriseId`	`string`	Bildirimin gönderildiği kuruluşun kimliği. Bu her zaman mevcuttur.
`notification[].timestampMillis`	`long`	Bildirimin yayınlandığı zaman (1970-01-01T00:00:00Z'den itibaren milisaniye cinsinden). Bu her zaman mevcuttur.
`notification[].productApprovalEvent`	`nested object`	Bir ü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 mevcuttur.
`notification[].productApprovalEvent.approved`	`string`	Ürünün onaylanıp onaylanmadığı. Bu alan her zaman mevcuttur. 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 mevcuttur.
`notification[].installFailureEvent.deviceId`	`string`	Cihazın Android kimliği. Bu alan her zaman mevcuttur.
`notification[].installFailureEvent.userId`	`string`	Kullanıcının kimliği. Bu alan her zaman mevcuttur.
`notification[].installFailureEvent.failureReason`	`string`	Yükleme hatasının nedeni. Bu alan her zaman mevcuttur. 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üncellemeleriyle ilgili bildirimler.
`notification[].appUpdateEvent.productId`	`string`	Güncellenen ürünün kimliği (ör. "app:com.google.android.gm"). Bu alan her zaman mevcuttur.
`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 mevcuttur.
`notification[].newPermissionsEvent.requestedPermissions[]`	`list`	Uygulamanın şu anda istediği izinler. Bu izinlerle ilgili ayrıntıları almak için EMM API'de Permissions.Get'i kullanın.
`notification[].newPermissionsEvent.approvedPermissions[]`	`list`	Kuruluş yöneticisinin bu uygulama için daha önce onayladığı izinler grubu. Bu izinlerle ilgili ayrıntıları almak için EMM API'de Permissions.Get'i kullanın.
`notification[].appRestrictionsSchemaChangeEvent`	`nested object`	Yeni uygulama kısıtlamaları şemasıyla ilgili değişikliklerle ilgili bildirimler.
`notification[].appRestrictionsSchemaChangeEvent.productId`	`string`	Uygulama kısıtlaması şemasının değiştiği ürünün kimliği (ör. "app:com.google.android.gm"). Bu alan her zaman mevcuttur.
`notification[].productAvailabilityChangeEvent`	`nested object`	Ürün stok durumu değişiklikleriyle ilgili bildirimler.
`notification[].productAvailabilityChangeEvent.productId`	`string`	Stok durumu değişen ürünün kimliği (ör. "app:com.google.android.gm"). Bu alan her zaman mevcuttur.
`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 mevcuttur.
`notification[].newDeviceEvent.deviceId`	`string`	Cihazın Android kimliği. Bu alan her zaman mevcuttur.
`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 belirtir. Olası değerler şunları içerir: "`managedDevice`", DPC'nin cihaz sahibi olarak ayarlandığı cihaz, "`managedProfile`", İTŞ'nin profil sahibi olarak ayarlandığı cihaz. Kabul edilen değerler şunlardır: "`managedDevice`" "`managedProfile`"
`notification[].notificationType`	`string`	Bildirimin türü. Kabul edilen değerler şunlardır: "`appRestricionsSchemaChange`" "`appUpdate`" "`deviceReportUpdate`" "`enterpriseUpgrade`" "`installFailure`" "`newDevice`" "`newPermissions`" "`productApproval`" "`productAvailabilityChange`" "`testNotification`" "`unknown`"
`notification[].newDeviceEvent.dpcPackageName`	`string`	Politika uygulaması.
`notification[].deviceReportUpdateEvent`	`nested object`	Cihaz raporu güncellemeleri hakkında bildirimler.
`notification[].deviceReportUpdateEvent.userId`	`string`	Kullanıcının kimliği. Bu alan her zaman mevcuttur.
`notification[].deviceReportUpdateEvent.deviceId`	`string`	Cihazın Android kimliği. Bu alan her zaman mevcuttur.
`notification[].deviceReportUpdateEvent.report`	`nested object`	Cihaz raporu, en son uygulama durumlarıyla güncellendi. Bu alan her zaman mevcuttur.
`notification[].deviceReportUpdateEvent.report.lastUpdatedTimestampMillis`	`long`	Unix başlangıç tarihinden itibaren milisaniye cinsinden son rapor güncellemesinin zaman damgası. Bu alan her zaman mevcuttur.
`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 mevcuttur.
`notification[].deviceReportUpdateEvent.report.appState[].packageName`	`string`	Uygulamanın paket adı. Bu alan her zaman mevcuttur.
`notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[]`	`list`	Anahtarlanmış uygulama durumlarının listesi. Bu alan her zaman mevcuttur.
`notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[].key`	`string`	Uygulamanın hangi durum için durum bilgisi sağladığını belirten anahtar. Anahtarın içeriği, uygulamanın geliştiricisi tarafından belirlenir. XSS'yi önlemek için anahtarı göstermeden önce anahtardan tüm HTML'leri kaldırmanızı öneririz. Bu alan her zaman mevcuttur.
`notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[].stateTimestampMillis`	`long`	Uygulamanın durumu ayarlamasının zaman damgası (epoch'tan itibaren milisaniye cinsinden). Bu alan her zaman mevcuttur.
`notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[].severity`	`string`	Uygulama durumunun önem derecesi. Bu alan her zaman mevcuttur. Kabul edilen değerler şunlardır: "`severityError`" "`severityInfo`"
`notification[].deviceReportUpdateEvent.report.appState[].keyedAppState[].message`	`string`	Uygulama durumunu açıklayan, serbest biçimli, kullanıcıların okuyabileceği bir 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 verileri göstermeden önce verilerden HTML'yi kaldırmanızı öneririz.
`kind`	`string`
`notification[].enterpriseUpgradeEvent`	`nested object`	Kurumsal yükseltmeyle ilgili bildirimler.
`notification[].enterpriseUpgradeEvent.upgradeState`	`string`	Yükseltme durumu. Kabul edilen değerler şunlardır: "`upgradeStateSucceeded`" "`upgradeStateUnspecified`"