Freigeben über

Flight-Pakete für eine App abrufen

  • Artikel

Verwenden Sie diese Methode in der Microsoft Store-Übermittlungs-API, um die Flight-Pakete für eine App auflisten, die für Ihr Partner Center-Konto registriert ist. Weitere Informationen zu Flight-Paketen finden Sie unter "Flight-Pakete".

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}/listflights

Anforderungsheader

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

Anforderungsparameter

Name Typ Beschreibung Erforderlich
applicationId Zeichenfolge Die Store-ID der App, für die Sie das Flight-Paket abrufen möchten. Weitere Informationen zur Store-ID finden Sie unter Anzeigen von App-Identitätsdetails. Ja
Oben int Die Anzahl der Elemente, die in der Anforderung zurückgegeben werden sollen (d. r. die Anzahl der zurückzugebenden Flight-Pakete). Wenn Ihr Konto mehr Flight-Pakete enthält als der Wert, den Sie in der Abfrage angeben, enthält der Antworttext einen relativen URI-Pfad, den Sie an den Methoden-URI anfügen können, um die nächste Seite mit Daten anzufordern. No
skip int Die Anzahl der Elemente, die in der Abfrage umgangen werden sollen, bevor die verbleibenden Elemente zurückgegeben werden. Verwenden Sie diesen Parameter, um Datensätze zu durchlaufen. Beispielsweise ruft top=10 und skip=0 Elemente 1 bis 10 ab, top=10 und skip=10 ruft Elemente 11 bis 20 ab usw. No

Anforderungstext

Geben Sie keinen Anforderungstext für diese Methode an.

Beispiele für Anforderungen

Im folgenden Beispiel wird veranschaulicht, wie sie alle Flight-Pakete für eine App auflisten.

GET https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/listflights HTTP/1.1
Authorization: Bearer <your access token>

Im folgenden Beispiel wird veranschaulicht, wie das erste Flight-Paket für eine App aufgeführt wird.

GET https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/listflights?top=1 HTTP/1.1
Authorization: Bearer <your access token>

Antwort

Das folgende Beispiel veranschaulicht den JSON-Antworttext, der von einer erfolgreichen Anforderung für das erste Flight-Paket für eine App mit drei Gesamtpaket-Flight-Paketen zurückgegeben wird. Weitere Informationen zu den Werten im Antworttext finden Sie im folgenden Abschnitt.

{
  "value": [
    {
      "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"
    }
  ],
  "totalCount": 3
}

Antworttext

Wert Typ Beschreibung
@nextLink string Wenn zusätzliche Datenseiten vorhanden sind, enthält diese Zeichenfolge einen relativen Pfad, den Sie an den Basisanforderungs-URI https://manage.devcenter.microsoft.com/v1.0/my/ anfügen können, um die nächste Datenseite anzufordern. Wenn beispielsweise der oberste Parameter des anfänglichen Anforderungstexts auf 2 festgelegt ist, aber vier Flight-Pakete für die App vorhanden sind, enthält der Antworttext den @nextLink Wert , der applications/{applicationid}/listflights/?skip=2&top=2angibt, dass Sie aufrufen https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationid}/listflights/?skip=2&top=2 können, um die nächsten 2 Flight-Pakete anzufordern.
value array Ein Array von Objekten, die Informationen zu Flight-Paketen für die angegebene App bereitstellen. Weitere Informationen zu den Daten in den einzelnen Objekten finden Sie in der Flight-Ressource.
totalCount int Die Gesamtanzahl der Zeilen im Datenergebnis für die Abfrage (d. a. die Gesamtanzahl der Flight-Pakete für die angegebene App).

Fehlercodes

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

Fehlercode BESCHREIBUNG
404 Es wurden keine Flight-Pakete gefunden.
409 Die App verwendet ein Partner Center-Feature, das derzeit von der Microsoft Store-Übermittlungs-API nicht unterstützt wird.