Freigeben über

Ein Flugpaket buchen

Verwenden Sie diese Methode in der Übermittlungs-API des Microsoft Stores, um Daten für einen Paketflug einer App abzurufen, die für Ihr Partner Center-Konto registriert ist.

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

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, die das Flight-Paket enthält, das Sie abrufen möchten. Die Store-ID für die App ist im Partner Center verfügbar.
FlugId Schnur Erforderlich. Die ID des abzurufenden Flugpakets. Diese ID ist in den Antwortdaten für Anforderungen zum Erstellen eines Flugpakets und zum Abrufen von Flugpaketen für eine Appverfügbar. Für einen Flug, der im Partner Center erstellt wurde, ist diese ID auch in der URL der Flugseite im Partner Center verfügbar.

Anfragekörper

Geben Sie keinen Request-Body für diese Methode an.

Beispielanfrage

Im folgenden Beispiel wird veranschaulicht, wie Informationen zu einem Paketflug mit der ID 43e448df-97c9-4a43-a0bc-2a445e736bcd für eine App mit der Store-ID 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 angezeigt. 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"
}

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 vom Entwickler angegeben.
letzteveröffentlichteFlugeinreichung Objekt Ein Objekt, das Informationen zur letzten veröffentlichten Einreichung für den Paketflug bereitstellt. Weitere Informationen finden Sie weiter unten im Abschnitt Übermittlungsobjekt.
Ausstehende Flugeinreichung Objekt Ein Objekt, das Informationen über die aktuelle ausstehende Einreichung für den Paket-Flight bereitstellt. Weitere Informationen finden Sie weiter unten im Abschnitt Übermittlungsobjekt.
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.
rangHöherAls. Schnur Der benutzerfreundliche Name des Flight-Pakets, das direkt unter dem aktuellen Flight-Paket rangiert. Weitere Informationen über die Bewertung von Fluggruppen finden Sie unter Pauschalflüge.

Übermittlungsobjekt

Die Werte lastPublishedFlightSubmission und pendingFlightSubmission im Antwortkörper enthalten Objekte, die Ressourceninformationen zu einer Einsendung für den Paketflug bereitstellen. Diese Objekte weisen die folgenden Werte auf.

Wert Typ BESCHREIBUNG
id Schnur Die ID der Einreichung.
Ressourcenstandort Schnur Ein relativer Pfad, den Sie an den Basis-https://manage.devcenter.microsoft.com/v1.0/my/ Anforderungs-URI 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 Der angegebene Paketflug wurde nicht gefunden.
409 Die App verwendet eine Partner Center-Funktion, die derzeit von der Microsoft Store-Einreichungs-APInicht unterstützt wird.
  • Last updated on