Abrufen von Details zur Upgradeblockierung für Ihre Desktopanwendung

  • Artikel

Verwenden Sie diesen REST-URI, um Details zu Windows 10 und Windows 11 Geräten abzurufen, auf denen eine bestimmte ausführbare Datei in Ihrer Desktopanwendung die Ausführung eines Windows 10 oder Windows 11 Upgrades blockiert. Sie können diesen URI nur für Desktopanwendungen verwenden, die Sie dem Windows-Desktopanwendungsprogramm hinzugefügt haben. Diese Informationen sind auch im Bericht Anwendungsblöcke für Desktopanwendungen in Partner Center verfügbar.

Dieser URI ähnelt dem Abrufen von Upgradeblöcken für Ihre Desktopanwendung, gibt jedoch Geräteblockinformationen für eine bestimmte ausführbare Datei in Ihrer Desktopanwendung zurück.

Voraussetzungen

Zur Verwendung dieser Methode sind folgende Schritte erforderlich:

  • Wenn Sie dies noch nicht getan haben, erfüllen Sie alle Voraussetzungen für die Microsoft Store-Analyse-API.
  • Rufen Sie ein Azure AD-Zugriffstoken ab, das im Anforderungsheader für diese Methode verwendet wird. Nachdem Sie ein Zugriffstoken erhalten haben, haben Sie 60 Minuten Zeit, es zu verwenden, bevor es abläuft. Wenn das Token abgelaufen ist, können Sie ein neues abrufen.

Anforderung

Anforderungssyntax

Methode Anforderungs-URI
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/blockdetails

Anforderungsheader

Header type BESCHREIBUNG
Authorization Zeichenfolge Erforderlich. Das Azure AD-Zugriffstoken im Format Bearertoken<>.

Anforderungsparameter

Parameter Typ BESCHREIBUNG Erforderlich
applicationId Zeichenfolge Die Produkt-ID der Desktopanwendung, für die Sie Blockdaten abrufen möchten. Um die Produkt-ID einer Desktopanwendung abzurufen, öffnen Sie einen beliebigen Analysebericht für Ihre Desktopanwendung in Partner Center (z. B. den Bericht Blocks), und rufen Sie die Produkt-ID aus der URL ab. Ja
fileName Zeichenfolge Der Name der blockierten ausführbaren Datei
startDate date Das Startdatum im Datumsbereich der abzurufenden Blockdaten. Der Standardwert ist 90 Tage vor dem aktuellen Datum. Nein
endDate date Das Enddatum im Datumsbereich der abzurufenden Blockdaten. Als Standardeinstellung wird das aktuelle Datum festgelegt. Nein
top INT Die Anzahl der Datenzeilen, die in der Anforderung zurückgegeben werden sollen. Der Maximal- und Standardwert ist 10.000, wenn nicht anders angegeben. Sind in der Abfrage keine weiteren Zeilen, enthält der Antworttext den Link „Weiter“, über den Sie die nächste Seite mit Daten anfordern können. Nein
skip INT Die Anzahl der Zeilen, die in der Abfrage übersprungen werden sollen. Verwenden Sie diesen Parameter, um große Datensätze durchzublättern. Beispielsweise rufen „top=10000“ und „skip=0“ die ersten 10.000 Datenzeilen ab, „top=10000“ und „skip=10000“ die nächsten 10.000 Datenzeilen usw. Nein
filter Zeichenfolge Mindestens eine Anweisung, die die Zeilen in der Antwort filtert. Jede Anweisung enthält einen Feldnamen aus dem Antworttext und -wert, die den Operatoren eq oder ne zugeordnet sind, und Anweisungen können mit undoder kombiniert werden. Zeichenfolgenwerte im Parameter filter müssen von einfachen Anführungszeichen eingeschlossen werden. Sie können die folgenden Felder im Antworttext angeben:

  • applicationVersion
  • architecture
  • blockType
  • Devicetype
  • Markt
  • osRelease
  • osVersion
  • Productname
  • targetOs
 Nein
orderby Zeichenfolge Eine Anweisung, die die Ergebnisdatenwerte für jeden Block anordnet. Die Syntax lautet orderby=field [order],field [order],.... Der Feldparameter kann eines der folgenden Felder aus dem Antworttext sein:

  • applicationVersion
  • architecture
  • blockType
  • date
  • Devicetype
  • Markt
  • osRelease
  • osVersion
  • Productname
  • targetOs
  • deviceCount

Der Parameter order ist optional und kann asc oder desc sein, um die auf- oder absteigende Anordnung der einzelnen Felder anzugeben. Der Standardwert ist asc.

Hier sehen Sie eine Orderby-Beispielzeichenfolge : orderby=date,market

 Nein
groupby Zeichenfolge Eine Anweisung, die nur auf die angegebenen Felder Datenaggregationen anwendet. Sie können die folgenden Felder im Antworttext angeben:

  • applicationVersion
  • architecture
  • blockType
  • Devicetype
  • Markt
  • osRelease
  • osVersion
  • targetOs

Die zurückgegebenen Datenzeilen enthalten die Felder, die im Parameter groupby angegeben sind, sowie die folgenden:

  • applicationId
  • date
  • Productname
  • deviceCount

 Nein

Anforderungsbeispiel

Das folgende Beispiel veranschaulicht mehrere Anforderungen zum Abrufen von Blockdaten für Desktopanwendungen. Ersetzen Sie den Wert applicationId durch die Produkt-ID für Ihre Desktopanwendung.

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/blockdetails?applicationId=10238467886765136388&fileName=contoso.exe&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/blockdetails?applicationId=10238467886765136388&fileName=contoso.exe&startDate=2018-05-01&endDate=2018-06-07&filter=market eq 'US' and deviceType eq 'PC' HTTP/1.1
Authorization: Bearer <your access token>

Antwort

Antworttext

Wert Typ BESCHREIBUNG
Wert array Ein Array von Objekten, die aggregierte Blockdaten enthalten. Weitere Informationen zu den Daten in den einzelnen Objekten finden Sie in der folgenden Tabelle.
@nextLink Zeichenfolge Wenn weitere Seiten mit Daten vorhanden sind, enthält diese Zeichenfolge einen URI, mit dem Sie die nächste Seite mit Daten anfordern können. Dieser Wert wird beispielsweise zurückgegeben, wenn der oberste Parameter der Anforderung auf 10000 festgelegt ist, aber mehr als 1.000 Zeilen mit Blockdaten für die Abfrage vorhanden sind.
TotalCount INT Die Gesamtzahl der Zeilen im Datenergebnis für die Abfrage.

Elemente im Array Value enthalten die folgenden Werte.

Wert Typ Beschreibung
applicationId Zeichenfolge Die Produkt-ID der Desktopanwendung, für die Sie Blockdaten abgerufen haben.
date Zeichenfolge Das Datum, das dem Wert des Blocktreffs zugeordnet ist.
ProductName Zeichenfolge Der Anzeigename der Desktopanwendung, der aus den Metadaten der zugehörigen ausführbaren Datei(en) abgeleitet ist.
fileName Zeichenfolge Die ausführbare Datei, die blockiert wurde.
applicationVersion Zeichenfolge Die Version der ausführbaren Anwendungsdatei, die blockiert wurde.
osVersion Zeichenfolge Eine der folgenden Zeichenfolgen, die die Betriebssystemversion angibt, unter der die Desktopanwendung derzeit ausgeführt wird:

  • Windows 7
  • Windows 8.1
  • Windows 10
  • Windows 11
  • Windows Server 2016
  • Windows Server 1709
  • Unbekannt
osRelease Zeichenfolge Eine der folgenden Zeichenfolgen, die die Betriebssystemversion oder den Flighting-Ring (als Teilpopulation innerhalb der Betriebssystemversion) angibt, auf der die Desktopanwendung derzeit ausgeführt wird.

Für Windows 11: Version 2110

Für Windows 10:

  • Version 1507
  • Version 1511
  • Version 1607
  • Version 1703
  • Version 1709
  • Releasevorschau
  • Insider Fast
  • Insider Langsam

Für Windows Server 1709:

  • RTM

Für Windows Server 2016:

  • Version 1607

Für Windows 8.1:

  • Update 1

Für Windows 7:

  • Service Pack 1

Wenn der Betriebssystemfreigabe- oder Flighting-Ring unbekannt ist, hat dieses Feld den Wert Unbekannt.
market Zeichenfolge Der ISO 3166-Ländercode des Marktes, in dem die Desktopanwendung blockiert ist.
deviceType Zeichenfolge Eine der folgenden Zeichenfolgen, die den Typ des Geräts angibt, auf dem die Desktopanwendung blockiert ist:

  • PC
  • Server
  • Tablet
  • Unbekannt
blockType Zeichenfolge Eine der folgenden Zeichenfolgen, die den Typ des auf dem Gerät gefundenen Blocks angibt:

  • Mögliches Sediment
  • Temporäres Sediment
  • Laufzeitbenachrichtigung

Weitere Informationen zu diesen Blocktypen und was sie für Entwickler und Benutzer bedeuten, finden Sie in der Beschreibung des Berichts Anwendungsblöcke.
Architektur Zeichenfolge Die Architektur des Geräts, auf dem der Block vorhanden ist:

  • ARM64
  • X86
targetOs Zeichenfolge Eine der folgenden Zeichenfolgen, die die Windows 10 oder Windows 11 Betriebssystemversion angibt, auf der die Ausführung der Desktopanwendung blockiert ist:

  • Version 1709
  • Version 1803
deviceCount number Die Anzahl unterschiedlicher Geräte, die über Blöcke auf der angegebenen Aggregationsebene verfügen.

Antwortbeispiel

Das folgende Beispiel zeigt ein Beispiel für einen JSON-Antworttext für diese Anforderung.

{
  "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/blockdetails?applicationId=123456789&startDate=2018-01-01&endDate=2018-02-01&top=10000&skip=10000&groupby=applicationVersion,deviceType,osVersion,osRelease",
  "TotalCount": 23012
}