Lämna in ett tillägg

Använd den här metoden i API:et för Microsoft Store-inlämningar för att bekräfta en ny eller uppdaterad inlämning av tillägg (även kallat in-app-produkt eller IAP) till Partnercenter. Incheckningsåtgärden varnar Partnercenter om att inskickade data har laddats upp (inklusive eventuella relaterade ikoner). Som svar genomför Partnercenter ändringarna av inskickade data för inmatning och publicering. När åtgärden har slutförts visas ändringarna i inlämningen i Partnercenter.

Mer information om hur incheckningsåtgärden passar in i processen för att skicka ett tillägg med hjälp av Microsoft Store-api:et för insändning finns i Hantera tilläggsöverföringar.

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 inlämning till Microsoft Store-API:et.
  • 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.
  • Skapa en tilläggsinskickning och uppdatera sedan inskickningen med nödvändiga ändringar i inskickningsdata.

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äran om URI
Posten https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/{inAppProductId}/submissions/{submissionId}/commit

Förfrågningshuvudrad

Rubrik Typ Beskrivning
Auktorisering snöre Obligatoriskt. Azure AD-åtkomsttokenet i formen Bearer<token>.

Parametrar för begäran

Namn Typ Beskrivning
produkt-ID i app snöre Obligatoriskt. Butiks-ID:t för tillägget som innehåller den sändning du vill slutföra. Store-ID:t är tillgängligt i Partnercenter och ingår i svarsdata för begäranden om att Hämta alla tillägg och Skapa ett tillägg.
insändningsID snöre Obligatoriskt. ID för den inlämning som du vill skicka in. Det här ID:t är tillgängligt i svarsdata för begäranden om att skapa en tilläggsinlämning. För en inlämning som har skapats i Partnercenter är detta ID också tillgängligt i URL:en för insändningssidan i Partnercenter.

begäranens innehåll

Ange ingen begärandetext för den här metoden.

Exempel på begäran

I följande exempel visas hur du lämnar in en tilläggsinlämning.

POST https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/9NBLGGH4TNMP/submissions/1152921504621230023/commit HTTP/1.1
Authorization: Bearer <your access token>

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 följande avsnitt.

{
  "status": "CommitStarted"
}

Svarsdel

Värde Typ Beskrivning
tillstånd snöre Status för insändningen. Detta kan vara något av följande värden:
  • Ingen
  • Annullerad
  • Väntande åtagande
  • CommitSattIgång
  • Åtagande misslyckades
  • Väntar på publicering
  • Förlagsverksamhet
  • Publicerad
  • Publicering misslyckades
  • Förbehandling
  • FörbehandlingMisslyckades
  • Certifiering
  • Certifiering misslyckades
  • Lansering
  • Utgivning misslyckades

Felkoder

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

Felkod Beskrivning
400 Parametrarna för begäran är ogiltiga.
404 Det gick inte att hitta den angivna insändningen.
409 Den angivna insändningen hittades men kunde inte checkas in i det aktuella tillståndet, eller så använder tillägget en PartnerCenter-funktion som för närvarande inte stöds av Microsoft Store-api:et för överföring.