Masaüstü uygulamanız için yükseltme bloklarını alma

Masaüstü uygulamanızın Windows 10 veya Windows 11 yükseltmesini engellediği Windows 10 ve Windows 11 cihazları hakkında bilgi edinmek için bu REST URI'yi kullanın. Bu URI'yi yalnızcaWindows Masaüstü Uygulaması programına eklediğiniz masaüstü uygulamaları için kullanabilirsiniz. İş Ortağı Merkezi'ndeki masaüstü uygulamaları için Uygulama blokları raporu'de bu bilgiler de mevcuttur.

Masaüstü uygulamanızdaki belirli bir yürütülebilir dosyanın cihaz bloklarıyla ilgili ayrıntıları almak için bkz. Masaüstü uygulamanızın yükseltme bloğu ayrıntılarını alma.

Önkoşullar

Bu yöntemi kullanmak için önce aşağıdakileri yapmanız gerekir:

  • Henüz yapmadıysanız Microsoft Store analiz API'si için tüm önkoşulları tamamlayın.
  • Bu yöntemin istek üst bilgisinde kullanmak üzere bir Azure AD erişim belirteci alın. Erişim belirtecini aldıktan sonra süresi dolmadan önce kullanmak için 60 dakikanız olur. Belirtecin süresi dolduktan sonra yenisini alabilirsiniz.

İstek

İstek söz dizimi

Yöntem İstenilen URI
AL https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/blockhits

İstek başlığı

Başlık Türü Açıklama
İzin String Gerekli. Azure AD erişim belirteci Bearer<token> biçimindedir.

İstek parametreleri

Parametre Türü Açıklama Gerekli
applicationId (Uygulama Kimliği) String Blok verilerini almak istediğiniz masaüstü uygulamasının ürün kimliği. Masaüstü uygulamasının ürün kimliğini almak için İş Ortağı Merkezi'nde masaüstü uygulamanızın analiz raporunu açın (Blokları raporugibi) ve URL'den ürün kimliğini alın. Evet
başlangıçTarihi tarih Alınacak blok verilerinin tarih aralığındaki başlangıç tarihi. Varsayılan değer, geçerli tarihten 90 gün öncedir. Hayı
Bitiş Tarihi tarih Alınacak blok verilerinin tarih aralığındaki bitiş tarihi. Varsayılan değer geçerli tarihtir. Hayı
Üst Int İstekte döndürülecek veri satırlarının sayısı. En büyük değer ve belirtilmezse varsayılan değer 10000'dir. Sorguda daha fazla satır varsa, yanıt gövdesi bir sonraki veri sayfasını istemek için kullanabileceğiniz bir sonraki bağlantı içerir. Hayı
geçmek Int Sorguda atlanacak satırların sayısı. Büyük veri kümelerini sayfalandırmak için bu parametreyi kullanın. Örneğin, top=10000 ve skip=0 ilk 10000 veri satırını alır; top=10000 ve skip=10000 sonraki 10000 veri satırını alır, vb. Hayı
filtre String Bir veya daha fazla ifade, yanıtın satırlarını filtreler. Her ifade, yanıt gövdesindeki eq veya ne operatörleriyle ilişkili bir alan adı ve değer içerir ve ifadeler ve veya veya kullanılarak birleştirilebilir. Dize değerleri, filtresinin parametresinde tek tırnakla çevrelenmelidir. Yanıt gövdesinden aşağıdaki alanları belirtebilirsiniz:

  • uygulamaVersiyonu
  • mimari
  • blokTürü
  • cihaz türü
  • Dosyaadı
  • pazar
  • işletim sistemi sürümü
  • İşletim Sistemi Sürümü
  • ürünAdı
  • hedef
Hayı
sıralama String Her blok için sonuç veri değerlerini sıralayan bir deyim. Söz dizimi orderby=field [order],field [order],...şeklindedir. alan parametresi yanıt gövdesinden aşağıdaki alanlardan biri olabilir:

  • uygulamaVersiyonu
  • mimari
  • blokTürü
  • tarih
  • cihaz türü
  • Dosyaadı
  • pazar
  • işletim sistemi sürümü
  • İşletim Sistemi Sürümü
  • ürünAdı
  • hedef
  • cihazSayısı

Order parametresi isteğe bağlıdır ve her alan için artan veya azalan düzen belirtmek için asc veya desc olabilir. Varsayılan değer asc'dir.

Aşağıda örnek bir orderby dizesi verilmiştir: orderby=date,market

 Hayı
Gruplandırma ölçütü String Yalnızca belirtilen alanlara veri toplama uygulayan bir deyim. Yanıt gövdesinden aşağıdaki alanları belirtebilirsiniz:

  • uygulamaVersiyonu
  • mimari
  • blokTürü
  • cihaz türü
  • Dosyaadı
  • pazar
  • işletim sistemi sürümü
  • İşletim Sistemi Sürümü
  • hedef

Döndürülen veri satırları groupby parametresinde belirtilen alanları ve aşağıdakileri içerir:

  • applicationId (Uygulama Kimliği)
  • tarih
  • ürünAdı
  • cihazSayısı

 Hayı

Örnek talep

Aşağıdaki örnekte, masaüstü uygulaması blok verilerini almaya yönelik çeşitli istekler gösterilmektedir. applicationId değerini masaüstü uygulamanızın Ürün Kimliği ile değiştirin.

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/blockhits?applicationId=5126873772241846776&startDate=2018-05-01&endDate=2018-06-07&skip=0 HTTP/1.1
Authorization: Bearer <your access token>

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/blockhits?applicationId=5126873772241846776&startDate=2018-05-01&endDate=2018-06-07&filter=market eq 'US' and deviceType eq 'PC' HTTP/1.1
Authorization: Bearer <your access token>

Yanıt

Yanıtın içeriği

Değer Türü Açıklama
Değer dizi Toplam blok verilerini içeren bir nesne dizisi. Her nesnedeki veriler hakkında daha fazla bilgi için aşağıdaki tabloya bakın.
@nextLink String Ek veri sayfaları varsa, bu dize sonraki veri sayfasını istemek için kullanabileceğiniz bir URI içerir. Örneğin, isteğin üst parametresi 10000 olarak ayarlanmışsa ancak sorgu için 10000'den fazla blok veri satırı varsa bu değer döndürülür.
ToplamSayı Int Sorgunun veri sonucundaki toplam satır sayısı.

Değer dizisindeki öğeler aşağıdaki değerleri içerir.

Değer Türü Açıklama
applicationId (Uygulama Kimliği) String Blok verilerini aldığınız masaüstü uygulamasının ürün kimliği.
tarih String Blok vuruş değeriyle ilişkili tarih.
ürünAdı String Masaüstü uygulamasının ilişkili yürütülebilir dosyalarının meta verilerinden türetilerek belirlenen görünen adı.
Dosyaadı String Engellenen yürütülebilir dosya.
uygulamaVersiyonu String Engellenen yürütülebilir uygulama dosyasının sürümü.
işletim sistemiSürümü String Masaüstü uygulamasının çalışmakta olduğu işletim sistemi sürümünü belirten aşağıdaki dizelerden biri:

  • Windows 7
  • Windows 8.1
  • Windows 10
  • Windows 11
  • Windows Server 2016
  • Windows Sunucusu 1709
  • Bilinmiyor
işletim sistemi sürümü String Masaüstü uygulamasının şu anda çalıştığı işletim sistemi sürümünü veya test halkasını (işletim sistemi sürümünün alt grubu olarak) belirten aşağıdaki dizelerden biri.

Windows 11 için: Sürüm 2110

Windows 10 için:

  • Sürüm 1507
  • Sürüm 1511
  • Sürüm 1607
  • Sürüm 1703
  • Sürüm 1709
  • Sürüm Önizleme
  • İçeriden Hızlı
  • Insider Yavaş

Windows Server 1709 için:

  • RTM

Windows Server 2016 için:

  • Sürüm 1607

Windows 8.1 için:

  • Güncelleştirme 1

Windows 7 için:

  • Hizmet Paketi 1

İşletim sistemi sürümü veya uçuş halkası bilinmiyorsa, bu alan Bilinmeyendeğerine sahiptir.
pazar String Masaüstü uygulamasının engellendiği pazarın ISO 3166 ülke kodu.
cihazTürü String Masaüstü uygulamasının engellendiği cihaz türünü belirten aşağıdaki dizelerden biri:

  • Kişisel bilgisayar
  • Sunucu
  • Tablet
  • Bilinmiyor
blokTürü String Cihazda bulunan blok türünü belirten aşağıdaki dizelerden biri:

  • Olası Sediment
  • Geçici Çökeltme
  • Çalışma Zamanı Bildirimi

Bu blok türleri ve bunların geliştiriciler ve kullanıcılar için anlamı hakkında daha fazla bilgi içinUygulama blokları raporunun açıklamasına bakın.
mimarlık String Bloğun bulunduğu cihazın mimarisi:

  • ARM64
  • X86
hedefOs String Masaüstü uygulamasının çalışmasının engellendiği Windows 10 veya Windows 11 işletim sistemi sürümünü belirten aşağıdaki dizelerden biri:

  • Sürüm 1709
  • Sürüm 1803
cihazSayısı Numara Belirtilen toplama düzeyinde blokları olan ayrı cihazların sayısı.

Yanıt örneği

Aşağıdaki örnekte bu istek için örnek bir JSON yanıt gövdesi gösterilmektedir.

{
  "Value": [
    {
     "applicationId": "10238467886765136388",
     "date": "2018-06-03",
     "productName": "Contoso Demo",
     "fileName": "contosodemo.exe",
     "applicationVersion": "2.2.2.0",
     "osVersion": "Windows 8.1",
     "osRelease": "Update 1",
     "market": "ZA",
     "deviceType": "All",
     "blockType": "Runtime Notification",
     "architecture": "X86",
     "targetOs": "RS4",
     "deviceCount": 120
    }
  ],
  "@nextLink": "desktop/blockhits?applicationId=123456789&startDate=2018-01-01&endDate=2018-02-01&top=10000&skip=10000&groupby=applicationVersion,deviceType,osVersion,osRelease",
  "TotalCount": 23012
}
  • Last updated on