Freigeben über

Abrufen eines Flight-Pakets

  • Artikel

Verwenden Sie diese Methode in der Microsoft Store-Übermittlungs-API, um Daten für ein Flight-Paket für eine App abzurufen, die für Ihr Partner Center-Konto registriert ist.

Voraussetzungen

Um diese Methode zu verwenden, müssen Sie zuerst Folgendes tun:

Anfordern

Diese Methode weist die folgende Syntax auf. In den folgenden Abschnitten finden Sie Verwendungsbeispiele und Beschreibungen des Headers und des Anforderungstexts.

Methode Anforderungs-URI
GET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}

Anforderungsheader

Header Typ Beschreibung
Autorisierung Zeichenfolge Erforderlich. Das Azure AD-Zugriffstoken im Formular Bearer<-Token>.

Anforderungsparameter

Name Typ Beschreibung
applicationId Zeichenfolge Erforderlich. Die Store-ID der App, die das Flight-Paket enthält, das Sie abrufen möchten. Die Store-ID für die App ist im Partner Center verfügbar.
flightId Zeichenfolge Erforderlich. Die ID des abzurufenden Flight-Pakets. Diese ID steht in den Antwortdaten für Anforderungen zum Erstellen eines Flight-Pakets und zum Abrufen von Flight-Paketen für eine App zur Verfügung. Für einen Test-Flight, der im Partner Center erstellt wurde, steht diese ID auch in der URL für die Flight-Seite im Partner Center zur Verfügung.

Anforderungstext

Geben Sie keinen Anforderungstext für diese Methode an.

Anforderungsbeispiel

Im folgenden Beispiel wird veranschaulicht, wie Informationen zu einem Flight-Paket mit der ID 43e448df-97c9-4a43-a0bc-2a445e736bcd für eine App mit dem Store-ID-Wert 9WZDNCRD91MD abgerufen werden.

GET https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights/43e448df-97c9-4a43-a0bc-2a445e736bcd HTTP/1.1
Authorization: Bearer <your access token>

Antwort

Im folgenden Beispiel wird der JSON-Antworttext für einen erfolgreichen Aufruf dieser Methode veranschaulicht. Weitere Informationen zu den Werten im Antworttext finden Sie in den folgenden Abschnitten.

{
  "flightId": "43e448df-97c9-4a43-a0bc-2a445e736bcd",
  "friendlyName": "myflight",
  "lastPublishedFlightSubmission": {
    "id": "1152921504621086517",
    "resourceLocation": "flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621086517"
  },
  "pendingFlightSubmission": {
    "id": "115292150462124364",
    "resourceLocation": "flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621243647"
  },
  "groupIds": [
    "0"
  ],
  "rankHigherThan": "671c2857-725e-4faf-9e9e-ea1191ef879c"
}

Antworttext

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 Ein Objekt, das Informationen zur letzten veröffentlichten Übermittlung für das Flight-Paket bereitstellt. Weitere Informationen finden Sie im Abschnitt "Übermittlungsobjekt " weiter unten.
pendingFlightSubmission Objekt Ein Objekt, das Informationen zur aktuellen ausstehenden Übermittlung für das Flight-Paket bereitstellt. Weitere Informationen finden Sie im Abschnitt "Übermittlungsobjekt " weiter unten.
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.

Übermittlungsobjekt

Die Werte "lastPublishedFlightSubmission " und "pendingFlightSubmission " im Antworttext enthalten Objekte, die Ressourceninformationen zu einer Übermittlung für das Flight-Paket bereitstellen. Diese Objekte weisen 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.

Fehlercodes

Wenn die Anforderung nicht erfolgreich abgeschlossen werden kann, enthält die Antwort einen der folgenden HTTP-Fehlercodes.

Fehlercode Beschreibung
400 Die Anforderung ist ungültig.
404 Das angegebene Flight-Paket konnte nicht gefunden werden.
409 Die App verwendet ein Partner Center-Feature, das derzeit von der Microsoft Store-Übermittlungs-API nicht unterstützt wird.