Een inzending voor een pakketvlucht creëren

Gebruik deze methode in de Microsoft Store-indienings-API om een nieuwe inzending te maken voor een pakketvlucht voor een app. Nadat u met deze methode een nieuwe inzending hebt gemaakt, werkt u de inzending bij om de benodigde wijzigingen aan te brengen in de inzendingsgegevens en voert u de inzending vervolgens door voor opname en publicatie.

Zie Verzendingen van pakketten beheren voor meer informatie over hoe deze methode past in het proces voor het maken van een verzending van een pakketvlucht met behulp van de Microsoft Store-inzendings-API.

Opmerking

Met deze methode maakt u een inzending voor een bestaande pakketvlucht. Als u een pakketvlucht wilt maken, gebruikt u de methode voor het maken van een pakketvlucht .

Vereiste voorwaarden

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

  • Als u dit nog niet hebt gedaan, moet u alle vereisten voor de Microsoft Store-indienings-API voltooien.
  • Haal een Azure AD-toegangstoken op dat moet worden gebruikt 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.
  • Maak een pakketvlucht voor een app. U kunt dit doen in partnercentrum of u kunt dit doen met behulp van de methode voor het maken van een pakketvlucht .

Aanvraag

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

Methode URI-aanvraag
BERICHT https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions

Header van het verzoek

Koptekst Typologie Beschrijving
Autorisatie touw Verplicht. Het Azure AD-toegangstoken in de vorm van Bearer<token>.

Aanvraagparameters

Naam Typologie Beschrijving
applicationId touw Verplicht. De Store-ID van de app waarvoor u een indiening voor een pakketvlucht wilt maken. Zie App-id-gegevens weergeven voor meer informatie over de Store-id.
vlucht-ID touw Verplicht. De id van de pakketvlucht waarvoor u de inzending wilt toevoegen. Deze id is beschikbaar in de antwoordgegevens voor aanvragen voor het maken van een pakketvlucht en het ophalen van pakketvluchten voor een app.

Inhoud van het verzoek

Geef geen aanvraagbody op voor deze methode.

Vraag om voorbeeld

In het volgende voorbeeld ziet u hoe u een nieuwe pakketvlucht inzending maakt voor een app met de 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>

Reactie

In het volgende voorbeeld ziet u de hoofdtekst van het JSON-antwoord voor een geslaagde aanroep naar deze methode. De hoofdtekst van het antwoord bevat informatie over de nieuwe inzending. Zie de bron Inzending van vluchtpakketten voor meer informatie over de waarden in de hoofdtekst van het antwoord.

{
  "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."
}

Foutcodes

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

Foutcode Beschrijving
400 De pakketindiening voor de vlucht kon niet worden aangemaakt aangezien het verzoek ongeldig is.
409 Het indienen van het pakketvlucht kan niet worden gecreëerd vanwege de huidige status van de app, of doordat de app gebruikmaakt van een Partner Center-functie die momenteel niet wordt ondersteund door de Microsoft Store-indienings-API.