Ausführen eines Commit für eine Add-On-ÜbermittlungCommit an add-on submission

Verwenden Sie diese Methode in der Microsoft Store-Übermittlung API, um eine neue oder aktualisierte-Add-On (auch bekannt als in-app-Produkt oder IAP) Eingabe zum Partner Center zu übernehmen.Use this method in the Microsoft Store submission API to commit a new or updated add-on (also known as in-app product or IAP) submission to Partner Center. Das Commit Aktion Warnungen Partner Center, dass die Sendungsdaten (einschließlich alle entsprechenden Symbole) hochgeladen wurde.The commit action alerts Partner Center that the submission data has been uploaded (including any related icons). Im Gegenzug übernimmt Partner Center die Änderungen an den Daten der Übermittlung für die Erfassung und Veröffentlichung an.In response, Partner Center commits the changes to the submission data for ingestion and publishing. Nachdem der Commitvorgang erfolgreich ist, werden die Änderungen an der Übermittlung im Partner Center angezeigt.After the commit operation succeeds, the changes to the submission are shown in Partner Center.

Weitere Informationen dazu, wie der Übernahmevorgang in den Prozess zur Übermittlung eines Add-Ons mit der Microsoft Store-Übermittlungs-API passt, finden Sie unter Verwalten von Add-On-Übermittlungen.For more information about how the commit operation fits into the process of submitting an add-on by using the Microsoft Store submission API, see Manage add-on submissions.

VorraussetzungenPrerequisites

Zur Verwendung dieser Methode sind folgende Schritte erforderlich:To use this method, you need to first do the following:

AnforderungRequest

Diese Methode hat die folgende Syntax.This method has the following syntax. In den folgenden Abschnitten finden Sie Verwendungsbeispiele und Beschreibungen des Header und Anforderungstexts.See the following sections for usage examples and descriptions of the header and request body.

MethodeMethod Anforderungs-URIRequest URI
POSTPOST https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/{inAppProductId}/submissions/{submissionId}/commit

AnforderungsheaderRequest header

HeaderHeader TypType BeschreibungDescription
AutorisierungAuthorization Stringstring Erforderlich.Required. Die Azure AD-Zugriffstoken in der Form Bearer < token>.The Azure AD access token in the form Bearer <token>.

AnforderungsparameterRequest parameters

NameName TypType BeschreibungDescription
inAppProductIdinAppProductId Stringstring Erforderlich.Required. Die Store-ID des Add-Ons, die die Übermittlung enthält, die Sie übernehmen möchten.The Store ID of the add-on that contains the submission you want to commit. Die Store-ID ist im Partner Center zur Verfügung und befindet sich in die Antwortdaten für Anforderungen an erhalten alle Add-ons und ein Add-on erstellen.The Store ID is available in Partner Center, and it is included in the response data for requests to Get all add-ons and Create an add-on.
submissionIdsubmissionId Stringstring Erforderlich.Required. Die ID der Übermittlung, die Sie übernehmen möchten.The ID of the submission you want to commit. Diese ID ist in den Antwortdaten für Anforderungen zum Erstellen einer Add-On-Übermittlung verfügbar.This ID is available in the response data for requests to create an add-on submission. Für eine Eingabe, die im Partner Center erstellt wurde, ist diese ID auch in die URL für die Seite für die Auftragsübermittlung im Partner Center verfügbar.For a submission that was created in Partner Center, this ID is also available in the URL for the submission page in Partner Center.

AnforderungstextRequest body

Stellen Sie keinen Anforderungstext für diese Methode bereit.Do not provide a request body for this method.

AnforderungsbeispielRequest example

Im folgenden Beispiel wird veranschaulicht, wie eine Add-On-Übermittlung übernommen wird.The following example demonstrates how to commit an add-on submission.

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

AntwortResponse

Das folgende Beispiel veranschaulicht den JSON-Antworttext für einen erfolgreichen Aufruf dieser Methode.The following example demonstrates the JSON response body for a successful call to this method. Weitere Informationen zu den Werten im Antworttext finden Sie in den folgenden Abschnitten.For more details about the values in the response body, see the following sections.

{
  "status": "CommitStarted"
}

AntworttextResponse body

WertValue TypType BeschreibungDescription
statusstatus Stringstring Der Status der Übermittlung.The status of the submission. Folgende Werte sind möglich:This can be one of the following values:
  • KeineNone
  • CanceledCanceled
  • PendingCommitPendingCommit
  • CommitStartedCommitStarted
  • CommitFailedCommitFailed
  • PendingPublicationPendingPublication
  • PublishingPublishing
  • PublishedPublished
  • PublishFailedPublishFailed
  • PreProcessingPreProcessing
  • PreProcessingFailedPreProcessingFailed
  • CertificationCertification
  • CertificationFailedCertificationFailed
  • VersionRelease
  • ReleaseFailedReleaseFailed

FehlercodesError codes

Wenn die Anforderung nicht erfolgreich abgeschlossen werden kann, enthält die Antwort einen der folgenden HTTP-Fehlercodes.If the request cannot be successfully completed, the response will contain one of the following HTTP error codes.

FehlercodeError code BeschreibungDescription
400400 Die Anforderungsparameter sind ungültig.The request parameters are invalid.
404404 Die angegebene Übermittlung konnte nicht gefunden werden.The specified submission could not be found.
409409 Die angegebene Übermittlung wurde gefunden, aber konnte nicht im aktuellen Zustand ausgeführt werden, oder das Add-on verwendet ein Partner Center-Feature, das derzeit nicht durch die Übermittlung zum Microsoft Store-API unterstützt.The specified submission was found but it could not be committed in its current state, or the add-on uses a Partner Center feature that is currently not supported by the Microsoft Store submission API.