Abrufen des Status einer App-ÜbermittlungGet the status of an app submission

Verwenden Sie diese Methode in der Microsoft Store Übermittlungs-API, um den Status einer APP-Übermittlung zu erhalten.Use this method in the Microsoft Store submission API to get the status of an app submission. Weitere Informationen zum Prozess der Erstellung einer APP-Übermittlung mithilfe der Microsoft Store Übermittlungs-API finden Sie unter Verwalten von App-Übermittlungen.For more information about the process of process of creating an app submission by using the Microsoft Store submission API, see Manage app submissions.

VoraussetzungenPrerequisites

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

  • Wenn Sie dies nicht bereits getan haben, müssen Sie alle Voraussetzungen für die Microsoft Store Übermittlungs-API erfüllen.If you have not done so already, complete all the prerequisites for the Microsoft Store submission API.
  • Rufen Sie ein Azure AD-Zugriffstoken ab, das im Anforderungsheader für diese Methode verwendet wird.Obtain an Azure AD access token to use in the request header for this method. Nachdem Sie ein Zugriffstoken erhalten haben, haben Sie 60 Minuten Zeit, es zu verwenden, bevor es abläuft.After you obtain an access token, you have 60 minutes to use it before it expires. Wenn das Token abgelaufen ist, können Sie ein neues abrufen.After the token expires, you can obtain a new one.

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
GETGET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}/status

AnforderungsheaderRequest header

HeaderHeader typeType BESCHREIBUNGDescription
AuthorizationAuthorization Zeichenfolgestring Erforderlich.Required. Das Azure AD-Zugriffstoken im Format Bearer <token>.The Azure AD access token in the form Bearer <token>.

AnforderungsparameterRequest parameters

NameName TypType BESCHREIBUNGDescription
applicationIdapplicationId Zeichenfolgestring Erforderlich.Required. Die Store-ID der App mit der Übermittlung, für die der Status abgerufen werden soll.The Store ID of the app that contains the submission for which you want to get the status. Weitere Informationen zur Store-ID finden Sie unter Anzeigen von Details zur App-Identität.For more information about the Store ID, see View app identity details.
submissionIdsubmissionId Zeichenfolgestring Erforderlich.Required. Die ID der Übermittlung, für die der Status abgerufen werden sollen.The ID of the submission for which you want to get the status. Diese ID ist in den Antwortdaten für Anforderungen zum Erstellen einer APP-Übermittlungverfügbar.This ID is available in the response data for requests to create an app submission. Für eine Übermittlung, die im Partner Center erstellt wurde, ist diese ID auch in der URL für die Übermittlungs Seite 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 der Status einer App-Übermittlung abgerufen werden kann.The following example demonstrates how to get the status of an app submission.

GET https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/submissions/1152921504621243610/status 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. Der Antworttext enthält Informationen über die angegebene Übermittlung.The response body contains information about the specified submission. 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": "PendingCommit",
  "statusDetails": {
    "errors": [],
    "warnings": [],
    "certificationReports": []
  },
}

AntworttextResponse body

WertValue TypType BESCHREIBUNGDescription
statusstatus Zeichenfolgestring Der Status der Übermittlung.The status of the submission. Mögliche Werte:This can be one of the following values:
  • KeineNone
  • CanceledCanceled
  • PendingCommitPendingCommit
  • CommitStartedCommitStarted
  • CommitFailedCommitFailed
  • PendingPublicationPendingPublication
  • VeröffentlichungPublishing
  • VeröffentlichtPublished
  • PublishFailedPublishFailed
  • PreProcessingPreProcessing
  • PreProcessingFailedPreProcessingFailed
  • ZertifizierungCertification
  • CertificationFailedCertificationFailed
  • FreigabeRelease
  • ReleaseFailedReleaseFailed
statusDetailsstatusDetails Objekt (object)object Enthält zusätzliche Details über den Status der Übermittlung, einschließlich Informationen zu Fehlern.Contains additional details about the status of the submission, including information about any errors. Weitere Informationen finden Sie in der Statusdetails-Ressource.For more information, see the Status details resource.

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
404404 Die Übermittlung konnte nicht gefunden werden.The submission could not be found.
409409 Die APP verwendet ein Partner Center-Feature, das derzeit von der Microsoft Store Übermittlungs-API nicht unterstütztwird.The app uses a Partner Center feature that is currently not supported by the Microsoft Store submission API.