Freigeben über

Abrufen des Status einer App-Übermittlung

  • Artikel

Verwenden Sie diese Methode in der Microsoft Store-Übermittlungs-API, um den Status einer App-Übermittlung abzurufen. Weitere Informationen zum Prozess des Erstellens einer App-Übermittlung mithilfe der Microsoft Store-Übermittlungs-API finden Sie unter Verwalten von App-Übermittlungen.

Voraussetzungen

Um diese Methode zu verwenden, müssen Sie zuerst Folgendes tun:

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

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, für die Sie den Status abrufen möchten. Weitere Informationen zur Store-ID finden Sie unter Anzeigen von App-Identitätsdetails.
submissionId Zeichenfolge Erforderlich. Die ID der Übermittlung, für die Sie den Status abrufen 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 der Status einer App-Übermittlung abgerufen wird.

GET https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/submissions/1152921504621243610/status HTTP/1.1
Authorization: Bearer <your access token>

Antwort

Im folgenden Beispiel wird der JSON-Antworttext für einen erfolgreichen Aufruf dieser Methode veranschaulicht. Der Antworttext enthält Informationen zur angegebenen Übermittlung. Weitere Informationen zu den Werten im Antworttext finden Sie in den folgenden Abschnitten.

{
  "status": "PendingCommit",
  "statusDetails": {
    "errors": [],
    "warnings": [],
    "certificationReports": []
  },
}

Antworttext

Wert Typ BESCHREIBUNG
Status Zeichenfolge Der Status der Übermittlung. Dies kann einer der folgenden Werte sein:
  • Keine
  • Storniert
  • PendingCommit
  • CommitStarted
  • CommitFailed
  • PendingPublication
  • Veröffentlichung
  • Veröffentlicht
  • PublishFailed
  • PreProcessing
  • PreProcessingFailed
  • Zertifizierung
  • CertificationFailed
  • Freigabe
  • ReleaseFailed
statusDetails Objekt Enthält zusätzliche Details zum Status der Übermittlung, einschließlich Informationen zu Fehlern. Weitere Informationen finden Sie in der Ressource "Statusdetails".

Fehlercodes

Wenn die Anforderung nicht erfolgreich abgeschlossen werden kann, enthält die Antwort einen der folgenden HTTP-Fehlercodes.

Fehlercode BESCHREIBUNG
404 Die Übermittlung konnte nicht gefunden werden.
409 Die App verwendet ein Partner Center-Feature, das derzeit von der Microsoft Store-Übermittlungs-API nicht unterstützt wird.