Abrufen von App-Daten

  • Artikel

Verwenden Sie die folgenden Methoden in der Microsoft Store-Übermittlungs-API, um Daten für vorhandene Apps in Ihrem Partner Center-Konto abzurufen. Eine Einführung in die Microsoft Store-Übermittlungs-API, einschließlich der Voraussetzungen für die Verwendung der API, finden Sie unter Erstellen und Verwalten von Übermittlungen mithilfe von Microsoft Store-Diensten.

Bevor Sie diese Methoden verwenden können, muss die App bereits in Ihrem Partner Center-Konto vorhanden sein. Informationen zum Erstellen oder Verwalten von Übermittlungen für Apps finden Sie unter den Methoden in Verwalten von App-Übermittlungen.

Methode URI BESCHREIBUNG
GET https://manage.devcenter.microsoft.com/v1.0/my/applications Daten für Ihre gesamten Apps abrufen
GET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId} Daten für eine bestimmte App abrufen
GET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/listinappproducts Add-Ons für eine App abrufen
GET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/listflights Flight-Pakete für eine App abrufen

Voraussetzungen

Wenn Sie dies noch nicht getan haben, müssen Sie alle Voraussetzungen für die Microsoft Store-Übermittlungs-API erfüllen, bevor Sie versuchen, eine dieser Methoden zu verwenden.

Datenressourcen

Die Methoden der Microsoft Store-Übermittlungs-API zum Abrufen von App-Daten verwenden die folgenden JSON-Datenressourcen.

Anwendungsressource

Diese Ressource steht für eine App, die in Ihrem Konto registriert ist.

{
  "id": "9NBLGGH4R315",
  "primaryName": "ApiTestApp",
  "packageFamilyName": "30481DevCenterAPITester.ApiTestAppForDevbox_ng6try80pwt52",
  "packageIdentityName": "30481DevCenterAPITester.ApiTestAppForDevbox",
  "publisherName": "CN=…",
  "firstPublishedDate": "1601-01-01T00:00:00Z",
  "lastPublishedApplicationSubmission": {
    "id": "1152921504621086517",
    "resourceLocation": "applications/9NBLGGH4R315/submissions/1152921504621086517"
  },
  "pendingApplicationSubmission": {
    "id": "1152921504621243487",
    "resourceLocation": "applications/9NBLGGH4R315/submissions/1152921504621243487"
  },
  "hasAdvancedListingPermission": true
}

Die Ressource hat die folgenden Werte.

Wert Typ BESCHREIBUNG
id Zeichenfolge Die Store-ID der App. Weitere Informationen zur Store-ID finden Sie unter Anzeigen von Details zur App-Identität.
primaryName Zeichenfolge Der Primärname der App.
packageFamilyName Zeichenfolge Der Paketfamilienname der App.
packageIdentityName Zeichenfolge Die Paketidentität der App.
publisherName Zeichenfolge Die Windows-Herausgeber-ID, die mit der App verknüpft ist. Dies entspricht dem Wert Package/Identity/Publisher , der auf der Seite App-Identität für die App in Partner Center angezeigt wird.
firstPublishedDate Zeichenfolge Das Datum, an dem die App erstmals im Format ISO 8601 veröffentlicht wurde.
lastPublishedApplicationSubmission Objekt (object) Eine Übermittlungsressource mit Informationen über die letzte veröffentlichte Übermittlung für die App.
pendingApplicationSubmission Objekt (object) Eine Übermittlungsressource mit Informationen über die aktuelle ausstehende Übermittlung für die App.
hasAdvancedListingPermission boolean Gibt an, ob Sie die gamingOptions oder Trailer für Übermittlungen für die App konfigurieren können. Dieser Wert gilt für Übermittlungen, die nach Mai 2017 erstellt wurden.

Add-On-Ressource

Diese Ressource enthält Informationen zu einem Add-On.

{
    "inAppProductId": "9WZDNCRD7DLK"
}

Die Ressource hat die folgenden Werte.

Wert Typ BESCHREIBUNG
inAppProductId Zeichenfolge Die Store-ID des Add-Ons. Dieser Wert wird vom Store bereitgestellt. Beispiel für eine Store-ID: 9NBLGGH4TNMP.

Flight-Ressource

Diese Ressource enthält Informationen zu einem Flight-Paket für eine App.

{
    "flightId": "7bfc11d5-f710-47c5-8a98-e04bb5aad310",
    "friendlyName": "myflight",
    "lastPublishedFlightSubmission": {
        "id": "1152921504621086517",
        "resourceLocation": "flights/7bfc11d5-f710-47c5-8a98-e04bb5aad310/submissions/1152921504621086517"
    },
    "pendingFlightSubmission": {
        "id": "1152921504621215786",
        "resourceLocation": "flights/7bfc11d5-f710-47c5-8a98-e04bb5aad310/submissions/1152921504621215786"
    },
    "groupIds": [
        "1152921504606962205"
    ],
    "rankHigherThan": "Non-flighted submission"
}

Die Ressource hat die folgenden Werte.

Wert Typ BESCHREIBUNG
flightId Zeichenfolge Die ID für das Flight-Paket. Dieser Wert wird von Partner Center bereitgestellt.
friendlyName Zeichenfolge Der Name des Flight-Pakets nach Vorgabe des Entwicklers.
lastPublishedFlightSubmission Objekt (object) Eine Übermittlungsressource mit Informationen über die letzte veröffentlichte Übermittlung für das Flight-Paket.
pendingFlightSubmission Objekt (object) Eine Übermittlungsressource mit Informationen über die aktuelle ausstehende Übermittlung für das Flight-Paket.
groupIds array Ein Array von Zeichenfolgen, die die IDs der Test-Flight-Gruppen enthalten, die dem Flight-Paket zugeordnet sind. Weitere Informationen zu Test-Flight-Gruppen finden Sie unter Flight-Pakete.
rankHigherThan Zeichenfolge Der Anzeigename des Flight-Pakets, das den unmittelbar niedrigeren Rang als das aktuelle Flight-Paket erhält. Weitere Informationen zur Bewertung von Test-Flight-Gruppen finden Sie unter Flight-Pakete.

Übermittlungsressource

Diese Ressource enthält Informationen zu einer Übermittlung. Das folgende Beispiel veranschaulicht das Format der Ressource.

{
  "pendingApplicationSubmission": {
    "id": "1152921504621243487",
    "resourceLocation": "applications/9WZDNCRD9MMD/submissions/1152921504621243487"
  }
}

Die Ressource hat die folgenden Werte.

Wert Typ BESCHREIBUNG
id Zeichenfolge Die ID der Übermittlung.
resourceLocation Zeichenfolge Ein relativer Pfad, den Sie an den Basisanforderungs-URI https://manage.devcenter.microsoft.com/v1.0/my/ anfügen können, um die vollständigen Daten für die Übermittlung abzurufen.