Skapa ett tillägg

Använd den här metoden i Microsoft Store-api:et för överföring för att skapa ett tillägg (även kallat produkt i appen eller IAP) för en app som är registrerad på ditt PartnerCenter-konto.

Notera / Anteckning

Den här metoden skapar ett tillägg utan några inlämningar. Information om hur du skapar en inlämning för ett tillägg finns i metoderna i Hantera tilläggsinlämningar.

Förutsättningar

Om du vill använda den här metoden måste du först göra följande:

  • Om du inte redan har gjort det, slutför alla krav för Microsoft Store-API:et för inlämning.
  • Hämta en Azure AD-åtkomsttoken som ska användas i begärandehuvudet för den här metoden. När du har fått en åtkomsttoken har du 60 minuter på dig att använda den innan den upphör att gälla. När token har upphört att gälla kan du skaffa en ny.

Begäran

Den här metoden har följande syntax. Se följande avsnitt för användningsexempel och beskrivningar av rubriken och begärandetexten.

Metod Begär-URI
Post https://manage.devcenter.microsoft.com/v1.0/my/inappproducts

Begärandehuvud

Rubrik Typ Beskrivning
Tillstånd sträng Krävs. Azure AD-åtkomsttoken i formuläret Bearer<token>.

Begärandetext

Begärandetexten har följande parametrar.

Parameter Typ Beskrivning Krävs
applikations-ID:n samling En matris som innehåller Store-ID:t för appen som det här tillägget är associerat med. Endast ett objekt stöds i den här matrisen. Ja
produkt-ID sträng Produkt-ID för tillägget. Det här är en identifierare som kan använda i kod för att referera till tillägget. Mer information finns i Ange produkttyp och produkt-ID. Ja
produkttyp sträng Produkttypen för tillägget. Följande värden stöds: Durable och Consumable. Ja

Exempel på begäran

I följande exempel visas hur du skapar ett nytt förbrukningsbart tillägg för en app.

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

Svar

I följande exempel visas JSON-svarstexten för ett lyckat anrop till den här metoden. Mer information om värdena i svarstexten finns i tilläggsresurs.

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

Felkoder

Om begäran inte kan slutföras innehåller svaret någon av följande HTTP-felkoder.

Felkod Beskrivning
400 Begäran är ogiltig.
409 Det gick inte att skapa tillägget på grund av dess aktuella tillstånd, eller så använder tillägget en Partner Center-funktion som för närvarande inte stöds av Microsoft Store-api:et för överföring.
  • Last updated on