Freigeben über

Ausführen eines Commit für eine Flight-Paketübermittlung

  • Artikel

Verwenden Sie diese Methode in der Microsoft Store-Übermittlungs-API, um eine neue oder aktualisierte Flight-Paket-Übermittlung an Partner Center zu übernehmen. Die Commit-Aktion benachrichtigt Partner Center, dass die Übermittlungsdaten hochgeladen wurden (einschließlich aller zugehörigen Pakete). Als Antwort verpflichtet Partner Center die Änderungen an den Übermittlungsdaten für die Erfassung und Veröffentlichung. Nachdem der Commitvorgang erfolgreich ausgeführt wurde, werden die Änderungen an der Übermittlung im Partner Center angezeigt.

Weitere Informationen dazu, wie der Commitvorgang 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 tun:

Anfordern

Diese Methode weist die folgende Syntax auf. In den folgenden Abschnitten finden Sie Verwendungsbeispiele und Beschreibungen des Headers und des Anforderungstexts.

Methode Anforderungs-URI
POST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions/{submissionId}/commit

Anforderungsheader

Header Typ Beschreibung
Autorisierung Zeichenfolge Erforderlich. Das Azure AD-Zugriffstoken im Formular Bearer<-Token>.

Anforderungsparameter

Name Typ Beschreibung
applicationId Zeichenfolge Erforderlich. Die Store-ID der App, die die Flight-Paketübermittlung enthält, die Sie übernehmen möchten. Die Store-ID für die App ist im Partner Center verfügbar.
flightId Zeichenfolge Erforderlich. Die ID des Flight-Pakets, das die zu übernehmende Übermittlung enthält. Diese ID steht in den Antwortdaten für Anforderungen zum Erstellen eines Flight-Pakets und zum Abrufen von Flight-Paketen für eine App zur Verfügung. Für einen Test-Flight, der im Partner Center erstellt wurde, steht diese ID auch in der URL für die Flight-Seite im Partner Center zur Verfügung.
submissionId Zeichenfolge Erforderlich. Die ID der zu übernehmenden Übermittlung. Diese ID ist in den Antwortdaten für Anforderungen zum Erstellen einer Flight-Paketübermittlung verfü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.

Anforderungstext

Geben Sie keinen Anforderungstext für diese Methode an.

Anforderungsbeispiel

Im folgenden Beispiel wird veranschaulicht, wie Sie eine Flight-Paketübermittlung übernehmen.

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 veranschaulicht. Weitere Informationen zu den Werten im Antworttext finden Sie in den folgenden Abschnitten.

{
  "status": "CommitStarted"
}

Antworttext

Wert Typ BESCHREIBUNG
Status Zeichenfolge Der Status der Übermittlung. Dies kann einer der folgenden Werte sein:
  • Keine
  • Storniert
  • PendingCommit
  • CommitStarted
  • CommitFailed
  • PendingPublication
  • Veröffentlichung
  • Veröffentlicht
  • PublishFailed
  • PreProcessing
  • PreProcessingFailed
  • Zertifizierung
  • CertificationFailed
  • Freigabe
  • ReleaseFailed

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 Übermittlung konnte nicht gefunden werden.
409 Die angegebene Übermittlung wurde gefunden, konnte aber nicht in ihrem aktuellen Zustand zugesichert werden, oder die App verwendet ein Partner Center-Feature, das derzeit nicht von der Microsoft Store-Übermittlungs-API unterstützt wird.