Erstellen eines Flight-Pakets
Verwenden Sie diese Methode in der Microsoft Store-Übermittlungs-API, um ein Flight-Paket für eine App zu erstellen, die bei Ihrem Partner Center-Konto registriert ist.
Hinweis
Mit dieser Methode wird ein Flight-Paket ohne Übermittlungen erstellt. Verwenden Sie zum Erstellen einer Übermittlung für ein Flight-Paket die Methoden unter Verwalten von Flight-Paketübermittlungen.
Voraussetzungen
Zur Verwendung dieser Methode sind folgende Schritte erforderlich:
- Wenn Sie dies noch nicht getan haben, müssen Sie alle Voraussetzungen für die Microsoft Store-Übermittlungs-API erfüllen.
- Rufen Sie ein Azure AD-Zugriffstoken ab, das im Anforderungsheader für diese Methode verwendet wird. Nachdem Sie ein Zugriffstoken erhalten haben, haben Sie 60 Minuten Zeit, es zu verwenden, bevor es abläuft. Wenn das Token abgelaufen ist, können Sie ein neues abrufen.
Anforderung
Diese Methode hat die folgende Syntax. In den folgenden Abschnitten finden Sie Verwendungsbeispiele und Beschreibungen des Header und Anforderungstexts.
Methode | Anforderungs-URI |
---|---|
POST | https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights |
Anforderungsheader
Header | type | BESCHREIBUNG |
---|---|---|
Authorization | Zeichenfolge | Erforderlich. Das Azure AD-Zugriffstoken im Format Bearertoken<>. |
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 Details zur App-Identität. |
Anforderungstext
Der Anforderungstext hat folgende Parameter.
Parameter | Typ | BESCHREIBUNG | Erforderlich |
---|---|---|---|
friendlyName | Zeichenfolge | Der Name des Flight-Pakets nach Vorgabe des Entwicklers. | Nein |
groupIds | array | Ein Array von Zeichenfolgen, die die IDs der Test-Flight-Gruppen enthalten, die dem Flight-Paket zugeordnet sind. Weitere Informationen zu Test-Flight-Gruppen finden Sie unter Flight-Pakete. | Nein |
rankHigherThan | Zeichenfolge | Der Anzeigename des Flight-Pakets, das den unmittelbar niedrigeren Rang als das aktuelle Flight-Paket erhält. Wenn Sie diesen Parameter nicht festlegen, erhält das neue Flight-Paket den höchsten Rang aller Flight-Pakete. Weitere Informationen zur Bewertung von Test-Flight-Gruppen finden Sie unter Flight-Pakete. | Nein |
Anforderungsbeispiel
Im folgenden Beispiel wird gezeigt, wie Sie ein neues Flight-Paket für eine App mit der Store-ID 9WZDNCRD911W erstellen.
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
Das folgende Beispiel veranschaulicht den JSON-Antworttext für einen erfolgreichen Aufruf dieser Methode. 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 von Partner Center bereitgestellt. |
friendlyName | Zeichenfolge | Der Name des Flight-Pakets gemäß der Angabe in der Anforderung. |
groupIds | array | Ein Array von Zeichenfolgen, die die IDs der Test-Flight-Gruppen enthalten, die dem Flight-Paket zugeordnet sind, gemäß der Angabe in der Anforderung. Weitere Informationen zu Test-Flight-Gruppen finden Sie unter Flight-Pakete. |
rankHigherThan | Zeichenfolge | Der Anzeigename des Flight-Pakets, das den unmittelbar niedrigeren Rang als das aktuelle Flight-Paket erhält, gemäß der Angabe in der Anforderung. Weitere Informationen zur Bewertung 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 seines aktuellen Zustands nicht erstellt werden, oder die App verwendet ein Partner Center-Feature, das derzeit von der Microsoft Store-Übermittlungs-API nicht unterstützt wird. |
Verwandte Themen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für