Ausführen eines Commit für eine Add-On-Übermittlung
Verwenden Sie diese Methode in der Microsoft Store-Übermittlungs-API, um eine neue oder aktualisierte Add-On-Übermittlung (auch als In-App-Produkt oder IAP bezeichnet) an Partner Center zu committen. Die Commitaktion benachrichtigt Partner Center, dass die Übermittlungsdaten hochgeladen wurden (einschließlich aller zugehörigen Symbole). 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 eines Add-Ons mithilfe der Microsoft Store-Übermittlungs-API passt, finden Sie unter Verwalten von Add-On-Übermittlungen.
Voraussetzungen
Zur Verwendung dieser Methode sind folgende Schritte erforderlich:
- Wenn Sie dies noch nicht getan haben, müssen Sie alle Voraussetzungen für die Microsoft Store-Übermittlungs-API erfüllen.
- 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. Wenn das Token abgelaufen ist, können Sie ein neues abrufen.
- Erstellen Sie eine Add-On-Übermittlung, und aktualisieren Sie die Übermittlung mit allen erforderlichen Änderungen der Übermittlungsdaten.
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/inappproducts/{inAppProductId}/submissions/{submissionId}/commit |
Anforderungsheader
Header | type | BESCHREIBUNG |
---|---|---|
Authorization | Zeichenfolge | Erforderlich. Das Azure AD-Zugriffstoken im Format Bearertoken<>. |
Anforderungsparameter
Name | Typ | BESCHREIBUNG |
---|---|---|
inAppProductId | Zeichenfolge | Erforderlich. Die Store-ID des Add-Ons, die die Übermittlung enthält, die Sie übernehmen möchten. Die Store-ID ist im Partner Center verfügbar und in den Antwortdaten für Anforderungen zum Abrufen aller Add-Ons und Erstellen eines Add-Ons enthalten. |
submissionId | Zeichenfolge | Erforderlich. Die ID der Übermittlung, die Sie übernehmen möchten. Diese ID ist in den Antwortdaten für Anforderungen zum Erstellen einer Add-On-Ü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 Add-On-Übermittlung übernommen wird.
POST https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/9NBLGGH4TNMP/submissions/1152921504621230023/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:
|
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 im aktuellen Zustand nicht committet werden, oder das Add-On verwendet ein Partner Center-Feature, das derzeit von der Microsoft Store-Übermittlungs-API nicht unterstützt wird. |
Verwandte Themen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für