Freigeben über

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 unter "Verwalten von App-Übermittlungen".

Method URI Beschreibung
GET https://manage.devcenter.microsoft.com/v1.0/my/applications Abrufen von Daten für alle Ihre Apps
GET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId} Abrufen von Daten für eine bestimmte App
GET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/listinappproducts Abrufen von Add-Ons für eine App
GET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/listflights Abrufen von Flight-Paketen für eine App

Voraussetzungen

Falls noch nicht geschehen, füllen Sie alle Voraussetzungen für die Microsoft Store-Übermittlungs-API aus, 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 stellt eine App dar, die für Ihr 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
}

Diese Ressource weist die folgenden Werte auf:

Wert Typ Beschreibung
id Zeichenfolge Die Store-ID der App. Weitere Informationen zur Store-ID finden Sie unter Anzeigen von App-Identitätsdetails.
primaryName Zeichenfolge Der primäre Name der App.
packageFamilyName Zeichenfolge Der Paketfamilienname der App.
packageIdentityName Zeichenfolge Der Paketidentitätsname der App.
publisherName Zeichenfolge Die Windows-Herausgeber-ID, die der App zugeordnet ist. Dies entspricht dem Wert "Package/Identity/Publisher", der auf der Seite "App-Identität" für die App im Partner Center angezeigt wird.
firstPublishedDate Zeichenfolge Das Datum, an dem die App erstmals im ISO 8601-Format veröffentlicht wurde.
lastPublishedApplicationSubmission Objekt Eine Übermittlungsressource , die Informationen zur letzten veröffentlichten Übermittlung für die App bereitstellt.
pendingApplicationSubmission Objekt Eine Übermittlungsressource , die Informationen zur aktuellen ausstehenden Übermittlung für die App bereitstellt.
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"
}

Diese Ressource weist die folgenden Werte auf:

Wert Typ Beschreibung
inAppProductId Zeichenfolge Die Store-ID des Add-Ons. Dieser Wert wird vom Store bereitgestellt. Ein Beispiel für die Store-ID ist 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"
}

Diese Ressource weist die folgenden Werte auf:

Wert Typ Beschreibung
flightId Zeichenfolge Die ID für das Flight-Paket. Dieser Wert wird vom Partner Center bereitgestellt.
friendlyName Zeichenfolge Der Name des Flight-Pakets, wie vom Entwickler angegeben.
lastPublishedFlightSubmission Objekt Eine Übermittlungsressource , die Informationen zur letzten veröffentlichten Übermittlung für das Flight-Paket bereitstellt.
pendingFlightSubmission Objekt Eine Übermittlungsressource , die Informationen zur aktuellen ausstehenden Übermittlung für das Flight-Paket bereitstellt.
groupIds array Ein Array von Zeichenfolgen, die die IDs der 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 unmittelbar niedriger als das aktuelle Flight-Paket ist. Weitere Informationen zum Bewerten von Test-Flight-Gruppen finden Sie unter Flight-Pakete.

Submission-Ressource

Diese Ressource enthält Informationen zu einer Übermittlung. Im folgenden Beispiel wird das Format dieser Ressource veranschaulicht.

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

Diese Ressource weist die folgenden Werte auf:

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.