Freigeben über

Abrufen eines Pauschalflugantrags

Verwenden Sie diese Methode in der Microsoft Store-Übermittlungs-API, um Daten für eine bestehende Paketflug-Übermittlung abzurufen. Weitere Informationen zum Prozess des Erstellens einer Paketflug-Übermittlung unter Verwendung der Microsoft Store-Übermittlungs-API finden Sie unter Verwalten von Paketflug-Übermittlungen.

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 eine Paket-Flight-Einreichung für eine App im Partner Center. Sie können dies im Partner Center tun oder indem Sie die Methode zur Erstellung eines Flight-Pakets einreichen.

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

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 die Flight-Paketübermittlung enthält, die Sie abrufen möchten. Weitere Informationen zur Store-ID finden Sie unter Anzeigen von App-Identitätsdetails.
FlugId Schnur Erforderlich. Die ID des Paketflugs, der die Übermittlung enthält, die Sie abrufen 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. Für einen Flug, der im Partner Center erstellt wurde, ist diese ID auch in der URL der Flugseite im Partner Center verfügbar.
Einreichungs-ID Schnur Erforderlich. Die ID der Einsendung, die abgerufen werden soll. Diese ID ist in den Antwortdaten für Anforderungen zum Erstellen einer Flight-Paketübermittlungverfügbar. Für eine Übermittlung, die im Partner Center erstellt wurde, ist diese ID auch in der URL für die Übermittlungsseite im Partner Center verfügbar.

Anfragekörper

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

Beispielanfrage

Im folgenden Beispiel wird veranschaulicht, wie eine Flight-Paket-Einreichung für eine App mit der Store-ID 9WZDNCRD91MD abgerufen wird.

POST https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621243649 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 angegebenen Einsendung. 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
404 Die Einreichung für den Flugpaketversand konnte nicht gefunden werden.
409 Die Paketflugübermittlung gehört nicht zum angegebenen Paketflug, oder die App verwendet eine Partner Center-Funktion, die derzeit von der Microsoft Store-Übermittlungs-APInicht unterstützt wird.
  • Last updated on