İ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:
|
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:
|
|
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:
|
|
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:
|
|
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:
Kabul edilen değerler şunlardır:
|
|
notification[].notificationType |
string |
Bildirimin türü.
Kabul edilen değerler şunlardır:
|
|
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:
|
|
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 |