Ausführen eines Commit für eine App-Übermittlung

  • Artikel

Verwenden Sie diese Methode in der Microsoft Store-Übermittlungs-API, um eine neue oder aktualisierte App-Übermittlung an Partner Center zu committen. Die Commitaktion benachrichtigt Partner Center, dass die Übermittlungsdaten hochgeladen wurden (einschließlich aller zugehörigen Pakete und Bilder). Als Reaktion darauf committet Partner Center die Änderungen an den Übermittlungsdaten für die Erfassung und Veröffentlichung. Nachdem der Commitvorgang erfolgreich war, werden die Änderungen an der Übermittlung in Partner Center angezeigt.

Weitere Informationen dazu, wie der Commitvorgang in den Prozess zum Übermitteln einer App mithilfe der Microsoft Store-Übermittlungs-API passt, finden Sie unter Verwalten von App-Übermittlungen.

Voraussetzungen

Zur Verwendung dieser Methode sind folgende Schritte erforderlich:

Anforderung

Diese Methode hat die folgende Syntax. In den folgenden Abschnitten finden Sie Verwendungsbeispiele und Beschreibungen des Header und Anforderungstexts.

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

Anforderungsheader

Header type BESCHREIBUNG
Authorization Zeichenfolge Erforderlich. Das Azure AD-Zugriffstoken im Format Bearertoken<>.

Anforderungsparameter

Name Typ Beschreibung
applicationId Zeichenfolge Erforderlich. Die Store-ID der App, die die Übermittlung enthält, die Sie übernehmen möchten. Weitere Informationen zur Store-ID finden Sie unter Anzeigen von Details zur App-Identität.
submissionId Zeichenfolge Erforderlich. Die ID der Übermittlung, die Sie übernehmen möchten. Diese ID ist in den Antwortdaten für Anforderungen zum Erstellen einer App-Übermittlung verfügbar. Für eine Übermittlung, die in Partner Center erstellt wurde, ist diese ID auch in der URL für die Übermittlungsseite in Partner Center verfügbar.

Anforderungstext

Stellen Sie keinen Anforderungstext für diese Methode bereit.

Anforderungsbeispiel

Im folgenden Beispiel wird veranschaulicht, wie eine App-Übermittlung übernommen wird.

POST https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/submissions/1152921504621243610/commit HTTP/1.1
Authorization: Bearer <your access token>

Antwort

Das folgende Beispiel veranschaulicht den JSON-Antworttext für einen erfolgreichen Aufruf dieser Methode. 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. Mögliche Werte:
  • Keine
  • Canceled
  • 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 im aktuellen Zustand committet werden, oder die App verwendet ein Partner Center-Feature, das derzeit nicht von der Microsoft Store-Übermittlungs-API unterstützt wird.