Dela via

Uppdatera en paketflyganmälan

Använd den här metoden i Microsoft Store-api:et för överföring av paket för att uppdatera en befintlig sändning av paketflyg. När du har uppdaterat en insändning med den här metoden måste du bekräfta sä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.

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 du alla krav för Microsoft Store-api:et för överföring.
  • 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 paketflygleverans för en av dina appar. Du kan göra detta i Partnercenter, eller så kan du göra det med hjälp av metoden skapa en paketflygningsöverföring .

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
LÄGG https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions/{submissionId}

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 för appen för vilken du vill uppdatera en paketflygsinlämning. Mer information om Store-ID finns i Visa information om appidentitet.
flightId snöre Obligatoriskt. ID:t för den paketflygning som du vill uppdatera en överföring 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. För en flygning som har skapats i Partnercenter är det här ID:t också tillgängligt i URL:en för flygsidan i Partnercenter.
insändningsID snöre Obligatoriskt. ID:t för inskicket som ska uppdateras. Detta ID är tillgängligt i svarsdatan för begäranden om att skapa en paketflygansökan. 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.
paket-ID snöre Obligatoriskt. ID:t för det befintliga paketet.

begäranens innehåll

Begärandetexten har följande parametrar.

Värde Typ Beskrivning
flygpaket samling Innehåller objekt som innehåller information om varje paket i sändningen. Mer information om värdena i svarstexten finns i Resurs för flygpaket. När du anropar den här metoden för att uppdatera en appöverföring krävs endast värdena fileName, fileStatus, minimumDirectXVersion och minimumSystemRam för dessa objekt i begärandetexten. De andra värdena fylls i av Partnercenter.
leveransalternativ för paket objekt Innehåller gradvis paketdistribution och obligatoriska uppdateringsinställningar för sändningen. Mer information finns i Objektet paketleveransalternativ.
målinställning för publicering snöre Publiceringsläget för insändningen. Detta kan vara något av följande värden:
  • Omedelbar
  • Handbok
  • Specifikt datum
måldatum för publicering snöre Publiceringsdatumet för sändningen i ISO 8601-format, om targetPublishMode har angetts till SpecificDate.
anteckningar för certifiering snöre Innehåller ytterligare information för certifieringstestarna, till exempel autentiseringsuppgifter för testkontot och steg för att komma åt och verifiera funktioner. Mer information finns i Anteckningar för certifiering.

Exempel på begäran

I följande exempel visas hur du uppdaterar en inlämning av paketflyg för en app.

PUT https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621243649 HTTP/1.1
Authorization: Bearer <your access token>
Content-Type: application/json
{
  "flightPackages": [
    {
      "id": "existingPackage.Id",
      "fileName": "newPackage.appx",
      "fileStatus": "PendingUpload",
      "minimumDirectXVersion": "None",
      "minimumSystemRam": "None"
    }
  ],
  "packageDeliveryOptions": {
    "packageRollout": {
        "isPackageRollout": false,
        "packageRolloutPercentage": 0.0,
        "packageRolloutStatus": "PackageRolloutNotStarted",
        "fallbackSubmissionId": "0"
    },
    "isMandatoryUpdate": false,
    "mandatoryUpdateEffectiveDate": "1601-01-01T00:00:00.0000000Z"
  },
  "targetPublishMode": "Immediate",
  "targetPublishDate": "",
  "notesForCertification": "No special steps are required for certification of this app."
}

Svar

I följande exempel visas JSON-svarstexten för ett lyckat anrop till den här metoden. Svarstexten innehåller information om den uppdaterade sändningen. För mer information om värdena i svarstexten, se Resurs för paketflyginlämning.

{
  "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 uppdatera paketflygsansökan eftersom begäran är ogiltig.
409 Det gick inte att uppdatera sändningen av paketflyget på grund av appens aktuella tillstånd, eller så använder appen en PartnerCenter-funktion som för närvarande inte stöds av Microsoft Store-api:et för överföring.
  • Last updated on