Een invoegtoepassing maken

Gebruik deze methode in de Microsoft Store-inzendings-API om een invoegtoepassing (ook wel bekend als in-app-product of IAP) te maken voor een app die is geregistreerd bij uw Partnercentrum-account.

Notitie

Met deze methode maakt u een invoegtoepassing zonder inzendingen. Zie de methoden in Invoegtoepassingen beherenom een inzending voor een invoegtoepassing te maken.

Voorwaarden

Als u deze methode wilt gebruiken, moet u eerst het volgende doen:

  • Als u dit nog niet hebt gedaan, moet u alle vereisten voltooien voor de Microsoft Store-inzendings-API.
  • een Azure AD-toegangstoken verkrijgen voor gebruik in de aanvraagheader voor deze methode. Nadat u een toegangstoken hebt verkregen, hebt u 60 minuten om het te gebruiken voordat het verloopt. Nadat het token is verlopen, kunt u een nieuw token verkrijgen.

Verzoek

Deze methode heeft de volgende syntaxis. Zie de volgende secties voor gebruiksvoorbeelden en beschrijvingen van de header en aanvraagtekst.

Methode Aanvraag-URI
VERZENDEN https://manage.devcenter.microsoft.com/v1.0/my/inappproducts

Aanvraagheader

Koptekst Typologie Beschrijving
Machtiging snaar Vereist. Het Azure AD-toegangstoken in de vorm van Bearer<token>.

Aanvraaginhoud

De hoofdtekst van de aanvraag heeft de volgende parameters.

Kenmerk Typologie Beschrijving Vereist
applicationIds gegevensreeks Een matrix met de Store-id van de app waaraan deze invoegtoepassing is gekoppeld. In deze matrix wordt slechts één item ondersteund. Ja
product-ID snaar De product-id van de invoegtoepassing. Dit is een id die in code kan worden gebruikt om te verwijzen naar de invoegtoepassing. Zie Uw producttype en product-id instellenvoor meer informatie. Ja
producttype snaar Het producttype van de invoegtoepassing. De volgende waarden worden ondersteund: Duurzaam en Verbruikbaar. Ja

Aanvraagvoorbeeld

In het volgende voorbeeld ziet u hoe u een nieuwe verbruiksinvoegtoepassing voor een app maakt.

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",
}

Antwoord

In het volgende voorbeeld ziet u de hoofdtekst van het JSON-antwoord voor een geslaagde aanroep naar deze methode. Zie invoegtoepassingsresourcevoor meer informatie over de waarden in de antwoordtekst.

{
  "applications": {
    "value": [
      {
        "id": "9NBLGGH4R315",
        "resourceLocation": "applications/9NBLGGH4R315"
      }
    ],
    "totalCount": 1
  },
  "id": "9NBLGGH4TNMP",
  "productId": "my-new-add-on",
  "productType": "Consumable",
}

Foutcodes

Als de aanvraag niet kan worden voltooid, bevat het antwoord een van de volgende HTTP-foutcodes.

Foutcode Beschrijving
400 De aanvraag is ongeldig.
409 De invoegtoepassing kan niet worden gemaakt vanwege de huidige status of de invoegtoepassing maakt gebruik van een partnercentrumfunctie die momenteel niet wordt ondersteund door de Microsoft Store-indienings-API.
  • Last updated on