Freigeben über


Abrufen von App-Daten

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. Um Einsendungen für Apps zu erstellen oder zu verwalten, siehe die Methoden in App-Einsendungen verwalten.

Methode URI (Uniform Resource Identifier) BESCHREIBUNG
ERHALTEN/Bekommen https://manage.devcenter.microsoft.com/v1.0/my/applications Daten für alle Ihre Apps abrufen
ERHALTEN/Bekommen https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId} Daten für eine bestimmte App abrufen
ERHALTEN/Bekommen https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/listinappproducts Erweiterungen für eine App abrufen
ERHALTEN/Bekommen https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/listflights Flugpakete für eine App erhalten

Voraussetzungen

Wenn Sie dies noch nicht getan haben, erfüllen Sie alle Voraussetzungen für die Microsoft Store-Einreichungs-API, bevor Sie eine dieser Methoden 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 hat die folgenden Werte.

Wert Typ BESCHREIBUNG
id Schnur Die Store-ID der App. Weitere Informationen zur Store-ID finden Sie unter Anzeigen von App-Identitätsdetails.
Hauptname Schnur Der primäre Name der App.
PaketFamilienname Schnur Der Paketfamilienname der App.
PaketIdentitätsName Schnur Der Paketidentitätsname der App.
VerlegerName Schnur Die Windows-Herausgeber-ID, die der App zugeordnet ist. Dies entspricht dem Wert Package/Identity/Publisher, der auf der App-Identitätsseite für die App im Partner Center angezeigt wird.
Erstveröffentlichungsdatum Schnur Das Datum, an dem die App erstmals im ISO 8601-Format veröffentlicht wurde.
letzte veröffentlichte Anwendungsübermittlung Objekt Eine Übermittlungsressource, die Informationen zur letzten veröffentlichten Übermittlung für die App bereitstellt.
ausstehende Antragsübermittlung Objekt Eine Übermittlungsressource, die Informationen zur aktuellen ausstehenden Übermittlung für die App bereitstellt.
hatErweiterteListeBerechtigung Boolescher Wert Gibt an, ob Sie die Gaming-Optionen oder die Trailer für Einreichungen zur App konfigurieren können. Dieser Wert gilt für Übermittlungen, die nach Mai 2017 erstellt wurden.

Zusatzressource

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

{
    "inAppProductId": "9WZDNCRD7DLK"
}

Diese Ressource hat die folgenden Werte.

Wert Typ BESCHREIBUNG
In-App-Produkt-ID Schnur Die Store-ID des Add-Ons. Dieser Wert wird vom Store bereitgestellt. Ein Beispiel für die Store-ID ist 9NBLGGH4TNMP.

Flugressource

Diese Ressource enthält Informationen über ein Flugpaket 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 hat die folgenden Werte.

Wert Typ BESCHREIBUNG
FlugId Schnur Die ID für das Flugpaket. Dieser Wert wird vom Partner Center bereitgestellt.
benutzerfreundlicher Name Schnur Der Name des Flugpakets, wie vom Entwickler angegeben.
letzteveröffentlichteFlugeinreichung Objekt Eine Übermittlungsressource, die Informationen zur letzten veröffentlichten Übermittlung für das Flight-Paket bereitstellt.
Ausstehende Flugeinreichung Objekt Eine Übermittlungsressource, die Informationen über die derzeit noch ausstehende Übermittlung für das Paket der Flugreise bereitstellt.
Gruppen-IDs Array Ein Array von Zeichenfolgen, die die IDs der Fluggruppen enthalten, die dem Paketflug zugeordnet sind. Weitere Informationen zu Fluggruppen finden Sie unter Paketflüge.
rangHöherAls. Schnur Der benutzerfreundliche Name des Flight-Pakets, das direkt unter dem aktuellen Flight-Paket rangiert. Weitere Informationen über die Bewertung von Fluggruppen finden Sie unter Pauschalflüge.

Übermittlungsressource

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

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

Diese Ressource hat die folgenden Werte.

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