Erstellen eines Add-Ons
Verwenden Sie diese Methode in der Microsoft Store-Übermittlungs-API, um ein Add-On (auch als In-App-Produkt oder IAP bezeichnet) für eine App zu erstellen, die für Ihr Partner Center-Konto registriert ist.
Hinweis
Diese Methode erstellt ein Add-On ohne Übermittlungen. Informationen zum Erstellen einer Übermittlung für ein Add-On finden Sie unter den Methoden 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.
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 |
|---|---|
| POST | https://manage.devcenter.microsoft.com/v1.0/my/inappproducts |
Anforderungsheader
| Header | Typ | Beschreibung |
|---|---|---|
| Autorisierung | Zeichenfolge | Erforderlich. Das Azure AD-Zugriffstoken im Formular Bearer<-Token>. |
Anforderungstext
Der Anforderungstext weist die folgenden Parameter auf.
| Parameter | Typ | Beschreibung | Erforderlich |
|---|---|---|---|
| applicationIds | array | Ein Array, das die Store-ID der App enthält, der dieses Add-On zugeordnet ist. In diesem Array wird nur ein Element unterstützt. | Ja |
| productId | Zeichenfolge | Die Produkt-ID des Add-Ons. Dies ist ein Bezeichner, der im Code verwendet werden kann, um auf das Add-On zu verweisen. Weitere Informationen finden Sie unter Festlegen des Produkttyps und der Produkt-ID. | Ja |
| productType | Zeichenfolge | Der Produkttyp des Add-Ons. Die folgenden Werte werden unterstützt: Durable und Consumable. | Ja |
Anforderungsbeispiel
Im folgenden Beispiel wird das Erstellen eines neuen Konsum-Add-Ons für eine App veranschaulicht.
POST https://manage.devcenter.microsoft.com/v1.0/my/inappproducts HTTP/1.1
Authorization: Bearer eyJ0eXAiOiJKV1Q...
Content-Type: application/json
{
"applicationIds": [ "9NBLGGH4R315" ],
"productId": "my-new-add-on",
"productType": "Consumable",
}
Antwort
Im folgenden Beispiel wird der JSON-Antworttext für einen erfolgreichen Aufruf dieser Methode veranschaulicht. Weitere Informationen zu den Werten im Antworttext finden Sie in der Add-On-Ressource.
{
"applications": {
"value": [
{
"id": "9NBLGGH4R315",
"resourceLocation": "applications/9NBLGGH4R315"
}
],
"totalCount": 1
},
"id": "9NBLGGH4TNMP",
"productId": "my-new-add-on",
"productType": "Consumable",
}
Fehlercodes
Wenn die Anforderung nicht erfolgreich abgeschlossen werden kann, enthält die Antwort einen der folgenden HTTP-Fehlercodes.
| Fehlercode | Beschreibung |
|---|---|
| 400 | Die Anforderung ist ungültig. |
| 409 | Das Add-On konnte aufgrund seines aktuellen Zustands nicht erstellt werden, oder das Add-On verwendet ein Partner Center-Feature, das derzeit nicht von der Microsoft Store-Übermittlungs-API unterstützt wird. |