Dela via

Skapa och skicka in en paketflygansökan

Använd den här metoden i Microsoft Store-api:et för inlämning för att skapa en ny överföring för en paketflygning för en app. När du har skapat en ny insändning med hjälp av den här metoden uppdaterar du sändningen för att göra nödvändiga ändringar i insändningsdata och genomför sedan insändningen för inmatning och publicering.

Mer information om hur den här metoden passar in i processen för att skapa ett paketflyg som skickas med hjälp av Microsoft Store-api:et för överföring finns i Hantera paketflygöverföringar.

Anmärkning

Den här metoden skapar en inlämning för en befintlig distributionsflygning. Om du vill skapa en paketflygning använder du metoden skapa ett paketflyg .

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 förutsättningar för API:et för Microsoft Store-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.
  • Skapa en paketflygning för en app. Du kan göra detta i Partnercenter, eller så kan du göra det med hjälp av metoden skapa ett paketflyg .

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/applications/{applicationId}/flights/{flightId}/submissions

Förfrågningshuvudrad

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

Parametrar för begäran

Namn Typ Beskrivning
applicationId snöre Obligatoriskt. Store-ID:t för den app som du vill skapa en paketflyktsöverföring för. Mer information om Store-ID finns i Visa information om appidentitet.
flightId snöre Obligatoriskt. ID för den paketflygning som du vill lägga till inlämningen för. Det här ID:t är tillgängligt i svarsdata för begäranden om att skapa en paketflygning och hämta paketflygningar för en app.

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 skapar en ny paketinlämning för en app som har Store ID 9WZDNCRD91MD.

POST https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions 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. Svarstexten innehåller information om den nya insändningen. Mer information om värdena i svarstexten finns i Paketflyktsöverföringsresurs.

{
  "id": "1152921504621243649",
  "flightId": "cd2e368a-0da5-4026-9f34-0e7934bc6f23",
  "status": "PendingCommit",
  "statusDetails": {
    "errors": [],
    "warnings": [],
    "certificationReports": []
  },
  "flightPackages": [
    {
      "fileName": "newPackage.appx",
      "fileStatus": "PendingUpload",
      "id": "",
      "version": "1.0.0.0",
      "languages": ["en-us"],
      "capabilities": [],
      "minimumDirectXVersion": "None",
      "minimumSystemRam": "None"
    }
  ],
  "packageDeliveryOptions": {
    "packageRollout": {
        "isPackageRollout": false,
        "packageRolloutPercentage": 0.0,
        "packageRolloutStatus": "PackageRolloutNotStarted",
        "fallbackSubmissionId": "0"
    },
    "isMandatoryUpdate": false,
    "mandatoryUpdateEffectiveDate": "1601-01-01T00:00:00.0000000Z"
  },
  "fileUploadUrl": "https://productingestionbin1.blob.core.windows.net/ingestion/8b389577-5d5e-4cbe-a744-1ff2e97a9eb8?sv=2014-02-14&sr=b&sig=wgMCQPjPDkuuxNLkeG35rfHaMToebCxBNMPw7WABdXU%3D&se=2016-06-17T21:29:44Z&sp=rwl",
  "targetPublishMode": "Immediate",
  "targetPublishDate": "",
  "notesForCertification": "No special steps are required for certification of this app."
}

Felkoder

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

Felkod Beskrivning
400 Det gick inte att skapa inlämningen av paketflygbokningen eftersom begäran var ogiltig.
409 Det gick inte att skapa paketöverföringen på grund av appens aktuella tillstånd, eller så använder appen en Partner Center-funktion som för närvarande inte stöds av Microsoft Store-inlämnings-API:et.
  • Last updated on