Freigeben über


Einreichung eines Flugpakets

Verwenden Sie diese Methode in der Microsoft Store-Übermittlungs-API, um eine neue oder aktualisierte Paketflug-Einreichung an das Partner Center einzureichen. Der Commit-Vorgang informiert das Partner Center, dass die Einreichungsdaten hochgeladen wurden (einschließlich aller zugehörigen Pakete). Daraufhin übernimmt Partner Center die Änderungen an den Übermittlungsdaten für die Aufnahme und Veröffentlichung. Nachdem der Commit-Vorgang erfolgreich abgeschlossen wurde, werden die Änderungen an der Einreichung im Partner Center angezeigt.

Weitere Informationen dazu, wie der Commit-Vorgang in den Prozess der Erstellung einer Flight-Paketübermittlung mithilfe der Microsoft Store-Übermittlungs-API passt, finden Sie unter Verwalten von Flight-Paketü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 Flugeinreichung und aktualisieren Sie dann die Einreichung mit allen erforderlichen Änderungen an den Einreichungsdaten.

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

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 Paketflug-Einreichung enthält, die Sie übergeben möchten. Die Store-ID für die App ist im Partner Center verfügbar.
FlugId Schnur Erforderlich. Die ID des Flight-Pakets, das die zu übernehmende Übermittlung enthält. 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 zu übernehmenden Übermittlung. 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 Paketflug-Einreichung durchgeführt wird.

POST https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621243649/commit 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.

{
  "status": "CommitStarted"
}

Antwortkörper

Wert Typ BESCHREIBUNG
Status Schnur Der Status der Einreichung. Dies kann einer der folgenden Werte sein:
  • Nichts
  • Abgesagt
  • Ausstehende Übertragung
  • CommitGestartet
  • Commit gescheitert
  • Ausstehende Veröffentlichung
  • Verlagswesen
  • Veröffentlicht
  • VeröffentlichungFehlgeschlagen
  • Vorverarbeitung
  • VorverarbeitungFehlgeschlagen
  • Zertifizierung
  • Zertifizierung gescheitert
  • Freigabe
  • FreigabeFehlgeschlagen

Fehlercodes

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

Fehlercode BESCHREIBUNG
400 Die Anforderungsparameter sind ungültig.
404 Die angegebene Einsendung konnte nicht gefunden werden.
409 Die angegebene Übermittlung wurde gefunden, konnte jedoch in ihrem aktuellen Zustand nicht übernommen werden, oder die App verwendet eine Partner Center-Funktion, die derzeit von der Microsoft Store-Übermittlungs-APInicht unterstützt wird.