Freigeben über

Erstellen eines Flight-Pakets

  • Artikel

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

Hinweis

Diese Methode erstellt ein Flight-Paket ohne Übermittlungen. Informationen zum Erstellen einer Übermittlung für Flight-Pakete finden Sie unter den Methoden unter Verwalten von Flight-Paketübermittlungen.

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
POST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights

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, für die Sie ein Flight-Paket erstellen möchten. Weitere Informationen zur Store-ID finden Sie unter Anzeigen von App-Identitätsdetails.

Anforderungstext

Der Anforderungstext weist die folgenden Parameter auf.

Parameter Typ Beschreibung Erforderlich
friendlyName Zeichenfolge Der Name des Flight-Pakets, wie vom Entwickler angegeben. No
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. No
rankHigherThan Zeichenfolge Der Anzeigename des Flight-Pakets, das unmittelbar niedriger als das aktuelle Flight-Paket ist. Wenn Sie diesen Parameter nicht festlegen, hat das neue Flight-Paket den höchsten Rang aller Flight-Pakete. Weitere Informationen zum Bewerten von Test-Flight-Gruppen finden Sie unter Flight-Pakete. No

Anforderungsbeispiel

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 veranschaulicht. 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"
}

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 in der Anforderung angegeben.
groupIds array Ein Array von Zeichenfolgen, die die IDs der Flight-Gruppen enthalten, die dem Flight-Paket zugeordnet sind, wie in der Anforderung angegeben. 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, wie in der Anforderung angegeben. Weitere Informationen zum Bewerten von Test-Flight-Gruppen finden Sie unter Flight-Pakete.

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 nicht von der Microsoft Store-Übermittlungs-API unterstützt wird.