Ein Flugpaket erstellen

2025-06-10

Verwenden Sie diese Methode in der Microsoft Store-Übermittlungs-API, um einen Paketflug für eine App zu erstellen, die in Ihrem Partner Center-Konto registriert ist.

Hinweis

Diese Methode erstellt ein Flugpaket ohne Übermittlungen. Informationen zum Erstellen einer Einreichung für Paket-Flights finden Sie in den Methoden unter Verwalten von Paket-Flight-Einreichungen.

Voraussetzungen

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

Wenn Sie dies noch nicht getan haben, erledigen Sie alle Voraussetzungen für die Microsoft Store-Übermittlungs-API.
Holen Sie sich ein Azure AD-Zugriffstoken, um es im Header der Anfrage für diese Methode zu verwenden. Nachdem Sie ein Zugriffstoken abgerufen haben, müssen Sie es 60 Minuten verwenden, bevor es abläuft. Nachdem das Token abgelaufen ist, können Sie eine neue abrufen.

Anfrage

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

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

Anforderungs-Kopfzeile

Kopfzeile	Typ	BESCHREIBUNG
Autorisierung	Schnur	Erforderlich. Das Azure AD-Zugriffstoken in der Form Bearer<token>.

Anforderungsparameter

Name	Typ	BESCHREIBUNG
Anwendungs-ID	Schnur	Erforderlich. Die Store-ID der App, für die Sie ein Paket-Flight erstellen möchten. Weitere Informationen zur Store-ID finden Sie unter Anzeigen von App-Identitätsdetails.

Anfragekörper

Der Anforderungstext weist die folgenden Parameter auf.

Parameter	Typ	BESCHREIBUNG	Erforderlich
benutzerfreundlicher Name	Schnur	Der Name des Flugpakets, wie vom Entwickler angegeben.	Nein
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.	Nein
rankHigherThan	Schnur	Der benutzerfreundliche Name des Flight-Pakets, das direkt unter dem aktuellen Flight-Paket rangiert. Wenn Sie diesen Parameter nicht festlegen, hat der neue Paketflug den höchsten Rang unter allen Paketflügen. Weitere Informationen über die Bewertung von Fluggruppen finden Sie unter Pauschalflüge.	Nein

Beispielanfrage

Im folgenden Beispiel wird das Erstellen eines neuen Flight-Pakets für eine App mit der Store-ID 9WZDNCRD911W veranschaulicht.

POST https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights HTTP/1.1
Authorization: Bearer eyJ0eXAiOiJKV1Q...
Content-Type: application/json
{
  "friendlyName": "myflight",
  "groupIds": [
    0
  ],
  "rankHigherThan": null
}

Antwort

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

{
  "flightId": "43e448df-97c9-4a43-a0bc-2a445e736bcd",
  "friendlyName": "myflight",
  "groupIds": [
    "0"
  ],
  "rankHigherThan": "671c2857-725e-4faf-9e9e-ea1191ef879c"
}

Antwortkörper

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 in der Anfrage angegeben.
Gruppen-IDs	Array	Ein Array von Zeichenfolgen, die die IDs der Fluggruppen enthalten, die dem Paketflug zugeordnet sind, wie in der Anforderung angegeben. Weitere Informationen zu Fluggruppen finden Sie unter Paketflüge.
rankHigherThan	Schnur	Der freundliche Name des Flugpakets, das unmittelbar unter dem aktuellen Flugpaket rangiert, wie im Antrag angegeben. Weitere Informationen über die Bewertung von Fluggruppen finden Sie unter Pauschalflüge.

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.
409	Das Flight-Paket konnte aufgrund des aktuellen Zustands nicht erstellt werden, oder die App verwendet ein Partner Center-Feature, das derzeit von der Microsoft Store-Übermittlungs-APInicht unterstützt wird.