Ausführen eines Commit für eine App-Übermittlung
Verwenden Sie diese Methode in der Microsoft Store-Übermittlungs-API, um eine neue oder aktualisierte App-Übermittlung an Partner Center zu übernehmen. Das Commit-Aktion benachrichtigt Partner Center, dass die Übermittlungsdaten hochgeladen wurden (einschließlich aller zugehörigen Pakete und Bilder). 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 Ü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 tun:
- Falls noch nicht geschehen, füllen Sie alle Voraussetzungen für die Microsoft Store-Übermittlungs-API aus.
- Rufen Sie ein Azure AD-Zugriffstoken ab, das im Anforderungsheader für diese Methode verwendet wird. Nachdem Sie ein Zugriffstoken erhalten haben, haben Sie 60 Minuten Zeit, es zu verwenden, bevor es abläuft. Nachdem das Token abgelaufen ist, können Sie eine neue abrufen.
- Erstellen Sie eine App-Übermittlung, und aktualisieren Sie die Übermittlung dann mit allen erforderlichen Änderungen an den Übermittlungsdaten.
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}/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 Übermittlung enthält, die Sie übernehmen möchten. Weitere Informationen zur Store-ID finden Sie unter Anzeigen von App-Identitätsdetails. |
| 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 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 App-Übermittlung übernehmen.
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 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:
|
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. |