Freigeben über


Eine App-Einreichung durchführen

Verwenden Sie diese Methode in der Microsoft Store-Übermittlungs-API, um eine neue oder aktualisierte App-Einreichung an das Partner Center einzureichen. Die Commit-Aktion benachrichtigt das Partner Center darüber, dass die Übermittlungsdaten hochgeladen wurden (einschließlich aller zugehörigen Pakete und Bilder). 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 Commitvorgang in den Prozess der Übermittlung einer App mithilfe der Microsoft Store-Übermittlungs-API passt, finden Sie unter Verwalten von App-Ü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 App-Einreichung 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}/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 Übermittlung enthält, die Sie abschließen möchten. Weitere Informationen zur Store-ID finden Sie unter Anzeigen von App-Identitätsdetails.
Einreichungs-ID Schnur Erforderlich. Die ID der Übermittlung, die Sie übernehmen möchten. Diese ID ist in den Antwortdaten für Anfragen zum Erstellen einer App-Einreichungbei 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.

Anfragekörper

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

Beispielanfrage

Im folgenden Beispiel wird gezeigt, wie Sie eine App-Einreichung einreichen.

POST https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/submissions/1152921504621243610/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.