Abrufen des Status einer Add-On-Übermittlung
Verwenden Sie diese Methode in der Microsoft Store-Übermittlungs-API, um den Status einer Add-On-Übermittlung (auch als In-App-Produkt oder IAP bezeichnet) abzurufen. Weitere Informationen zum Prozess des Erstellens einer Add-On-Übermittlung mithilfe der Microsoft Store-Übermittlungs-API finden Sie unter Verwalten von Add-On-Ü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 Add-On-Übermittlung für eine Ihrer Apps. Sie können dies im Partner Center tun, oder Sie können dies tun, indem Sie die Methode zum Erstellen einer Add-On-Übermittlung verwenden.
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/inappproducts/{inAppProductId}/submissions/{submissionId}/status |
Anforderungsheader
| Header | Typ | Beschreibung |
|---|---|---|
| Autorisierung | Zeichenfolge | Erforderlich. Das Azure AD-Zugriffstoken im Formular Bearer<-Token>. |
Anforderungsparameter
| Name | Typ | Beschreibung |
|---|---|---|
| inAppProductId | Zeichenfolge | Erforderlich. Die Store-ID des Add-Ons, das die Übermittlung enthält, für die Sie den Status abrufen möchten. Die Store-ID ist im Partner Center verfügbar. |
| 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 Add-On-Ü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 Add-On-Übermittlung abgerufen wird.
GET https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/9NBLGGH4TNMP/submissions/1152921504621243680/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:
|
| 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 | Das Add-On verwendet ein Partner Center-Feature, das derzeit von der Microsoft Store-Übermittlungs-API nicht unterstützt wird. |