Erstellen Sie ein Add-On

2025-06-10

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 zur Erstellung einer Einreichung für ein Add-on finden Sie unter den Methoden in Verwalten von Add-on-Einreichungen.

Voraussetzungen

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

Wenn Sie dies noch nicht getan haben, erledigen Sie alle Voraussetzungen für die Microsoft Store-Übermittlungs-API.
Holen Sie sich ein Azure AD-Zugriffstoken, um es im Header der Anfrage für diese Methode zu verwenden. Nachdem Sie ein Zugriffstoken abgerufen haben, müssen Sie es 60 Minuten verwenden, bevor es abläuft. Nachdem das Token abgelaufen ist, können Sie eine neue abrufen.

Anfrage

Diese Methode weist die folgende Syntax auf. In den folgenden Abschnitten finden Sie Verwendungsbeispiele und Beschreibungen der Kopfzeile und des Anforderungstexts.

Methode	Anforderungs-URI
SENDEN	`https://manage.devcenter.microsoft.com/v1.0/my/inappproducts`

Anforderungs-Kopfzeile

Kopfzeile	Typ	BESCHREIBUNG
Autorisierung	Schnur	Erforderlich. Das Azure AD-Zugriffstoken in der Form Bearer<token>.

Anfragekörper

Der Anforderungstext weist die folgenden Parameter auf.

Parameter	Typ	BESCHREIBUNG	Erforderlich
Anwendungs-IDs	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
Produkt-ID	Schnur	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
Produkttyp	Schnur	Der Produkttyp des Add-Ons. Die folgenden Werte werden unterstützt: Durable und Consumable.	Ja

Beispielanfrage

Im folgenden Beispiel wird demonstriert, wie man ein neues verbrauchbares Add-on für eine App erstellt.

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 angezeigt. Weitere Informationen zu den Werten im Antworttext finden Sie unter Erweiterungsressource.

{
  "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 des aktuellen Zustands nicht erstellt werden, oder das Add-On verwendet eine Funktion des Partner Centers, die derzeit von der Microsoft Store-Übermittlungs-APInicht unterstützt wird.

Freigeben über