Freigeben über

Erstellen einer Flugpaket-Einreichung

Verwenden Sie diese Methode, um eine neue Einsendung für einen Paketflug einer App in der Microsoft Store-Übermittlungs-API zu erstellen. Nachdem Sie eine neue Übermittlung mithilfe dieser Methode erfolgreich erstellt haben, aktualisieren Sie die Übermittlung so, dass alle erforderlichen Änderungen an den Übermittlungsdaten vorgenommen werden, und übernehmen Sie dann die Übermittlung für die Aufnahme und Veröffentlichung.

Weitere Informationen darüber, wie diese Methode in den Prozess zur Erstellung einer Paketflug-Einreichung mithilfe der Microsoft Store-Einreichungs-API passt, finden Sie unter Verwalten von Paketflug-Einreichungen.

Hinweis

Diese Methode erstellt eine Einreichung für ein vorhandenes Flugpaket. Um einen "Package Flight" zu erstellen, verwenden Sie die Methode erstellenSieEinPackageFlight.

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.
  • Erstellen Sie ein Flight-Paket für eine App. Sie können dies im Partner Center tun oder indem Sie die Paketflug--Methode verwenden.

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/{flightId}/submissions

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 eine Paketflug-Einreichung erstellen möchten. Weitere Informationen zur Store-ID finden Sie unter Anzeigen von App-Identitätsdetails.
FlugId Schnur Erforderlich. Die ID des Pakets für den Flug, für das Sie die Einreichung hinzufügen möchten. Diese ID ist in den Antwortdaten für Anforderungen zum Erstellen eines Flugpakets und zum Abrufen von Flugpaketen für eine Appverfügbar.

Anfragekörper

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

Beispielanfrage

Das folgende Beispiel veranschaulicht, wie eine neue Testpaket-Einreichung für eine App mit der Store-ID 9WZDNCRD91MD erstellt wird.

POST https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions HTTP/1.1
Authorization: Bearer <your access token>

Antwort

Im folgenden Beispiel wird der JSON-Antworttext für einen erfolgreichen Aufruf dieser Methode angezeigt. Der Antworttext enthält Informationen zur neuen Übermittlung. Weitere Informationen zu den Werten im Antworttext finden Sie in der Ressource zur Einreichung von Flugpaketen .

{
  "id": "1152921504621243649",
  "flightId": "cd2e368a-0da5-4026-9f34-0e7934bc6f23",
  "status": "PendingCommit",
  "statusDetails": {
    "errors": [],
    "warnings": [],
    "certificationReports": []
  },
  "flightPackages": [
    {
      "fileName": "newPackage.appx",
      "fileStatus": "PendingUpload",
      "id": "",
      "version": "1.0.0.0",
      "languages": ["en-us"],
      "capabilities": [],
      "minimumDirectXVersion": "None",
      "minimumSystemRam": "None"
    }
  ],
  "packageDeliveryOptions": {
    "packageRollout": {
        "isPackageRollout": false,
        "packageRolloutPercentage": 0.0,
        "packageRolloutStatus": "PackageRolloutNotStarted",
        "fallbackSubmissionId": "0"
    },
    "isMandatoryUpdate": false,
    "mandatoryUpdateEffectiveDate": "1601-01-01T00:00:00.0000000Z"
  },
  "fileUploadUrl": "https://productingestionbin1.blob.core.windows.net/ingestion/8b389577-5d5e-4cbe-a744-1ff2e97a9eb8?sv=2014-02-14&sr=b&sig=wgMCQPjPDkuuxNLkeG35rfHaMToebCxBNMPw7WABdXU%3D&se=2016-06-17T21:29:44Z&sp=rwl",
  "targetPublishMode": "Immediate",
  "targetPublishDate": "",
  "notesForCertification": "No special steps are required for certification of this app."
}

Fehlercodes

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

Fehlercode BESCHREIBUNG
400 Die Paketflugübermittlung konnte nicht erstellt werden, da die Anforderung ungültig ist.
409 Die Flight-Paketübermittlung konnte aufgrund des aktuellen Zustands der App nicht erstellt werden, oder die App verwendet ein Partner Center-Feature, das derzeit von der Microsoft Store-Übermittlungs-APInicht unterstützt wird.
  • Last updated on