Dela via

Uppdatera en appinlämning

Använd den här metoden i Microsoft Store-api:et för insändning för att uppdatera en befintlig appöverföring. När du har uppdaterat en anmälan med den här metoden måste du bekräfta anmälan för inmatning och publicering.

Mer information om hur den här metoden passar in i processen för att skapa en appöverföring med hjälp av Microsoft Store-api:et för insändning finns i Hantera appö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 api:et för överföring till Microsoft Store.
  • 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 sändning för en av dina appar. Du kan göra detta i Microsoft Partner Center, eller med hjälp av metoden skapa en inskickning av en app.

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 Förfrågan-URI
STÄLLA https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId}

Begärandehuvud

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

Parametrar för begäran

Namn Typ Beskrivning
applicationId sträng Krävs. Appens Store-ID för vilken du vill uppdatera en inskickning. Mer information om Store-ID finns i Visa information om appidentitet.
insändningsID sträng Krävs. ID för inlämningen som ska uppdateras. Det här ID:t finns i svarsdatan för begäran om att skicka in en app. 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ärans innehåll

Begärandetexten har följande parametrar.

Värde Typ Beskrivning
Ansökningskategori sträng En sträng som anger kategorin och/eller underkategorin för din app. Kategorier och underkategorier kombineras till en enda sträng med understrecket _, till exempel BooksAndReference_EReader.
prissättning objekt Ett objekt som innehåller prisinformation för appen. Mer information finns i avsnittet Prisresurs .
synlighet sträng Appens synlighet. Detta kan vara något av följande värden:
  • Dold
  • Offentlig
  • Privat
  • Ej inställt
målinställning för publicering sträng Publiceringsläget för inlämningen. Detta kan vara något av följande värden:
  • Omedelbar
  • Handbok
  • SpecifikDatum
måldatum för publicering sträng Publiceringsdatumet för sändningen i ISO 8601-format, om targetPublishMode har angetts till SpecificDate.
Annonser objekt En ordlista med nyckel- och värdepar, där varje nyckel är en landskod och varje värde är ett Listningsresursobjekt som innehåller listinformation för appen.
hårdvarupreferenser samling En matris med strängar som definierar maskinvaruinställningarna för din app. Detta kan vara något av följande värden:
  • Röra vid
  • Tangentbord
  • Mus
  • Kamera
  • NfcHce
  • NFC
  • BluetoothLE
  • Telefoni
automatiskBackupAktiverad boolesk Anger om Windows kan inkludera appens data i automatiska säkerhetskopieringar till OneDrive. Mer information finns i Appdeklarationer.
kanInstalleraPåFlyttbarMedia boolesk Anger om kunder kan installera din app på flyttbart lagringsutrymme. Mer information finns i Appdeklarationer.
ärSpelDvrAktiverad boolesk Anger om spel-DVR är aktiverat för appen.
spelalternativ objekt En matris som innehåller en resurs för spelalternativ som definierar spelrelaterade inställningar för appen.
harExternaInApp-produkter boolesk Anger om din app tillåter att användare köper utanför Microsoft Store-handelssystemet. Mer information finns i Appdeklarationer.
uppfyllTillgänglighetsriktlinjer boolesk Anger om din app har testats för att uppfylla riktlinjerna för hjälpmedel. Mer information finns i Appdeklarationer.
anteckningarFörCertifiering sträng Innehåller anteckningar för certifiering för din app.
applikationspaket samling Innehåller objekt som innehåller information om varje paket i sändningen. Mer information finns i avsnittet Programpaket . 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 objekt Innehåller gradvis paketdistribution och obligatoriska uppdateringsinställningar för sändningen. Mer information finns i Objektet paketleveransalternativ.
företagslicensiering sträng Ett av värdena för företagslicensiering som anger företagets licensieringsbeteende för appen.
låtMicrosoftBestämmaAppTillgänglighetFörFramtidaEnhetsfamiljer boolesk Anger om Microsoft får göra appen tillgänglig för framtida Windows 10- och Windows 11-enhetsfamiljer.
TillåtMålFramtidaEnhetsFamiljer boolesk Anger om din app får rikta in sig på framtida Windows 10- och Windows 11-enhetsfamiljer.
Släp samling En matris som innehåller upp till trailerresurser som representerar videotrailrar för applistan.

Exempel på begäran

I följande exempel visas hur du uppdaterar en appinsändning.

PUT https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/submissions/1152921504621230023 HTTP/1.1
Authorization: Bearer <your access token>
Content-Type: application/json
{
  "applicationCategory": "BooksAndReference_EReader",
  "pricing": {
    "trialPeriod": "FifteenDays",
    "marketSpecificPricings": {},
    "sales": [],
    "priceId": "Tier2"
  },
  "visibility": "Public",
  "targetPublishMode": "Manual",
  "targetPublishDate": "1601-01-01T00:00:00Z",
  "listings": {
    "en-us": {
      "baseListing": {
        "copyrightAndTrademarkInfo": "",
        "keywords": [
		      "epub"
		    ],
        "licenseTerms": "",
        "privacyPolicy": "",
        "supportContact": "",
        "websiteUrl": "",
        "description": "Description",
        "features": [
		      "Free ebook reader"
		    ],
        "releaseNotes": "",
        "images": [
          {
            "fileName": "contoso.png",
            "fileStatus": "Uploaded",
            "id": "1152921504672272757",
            "imageType": "Screenshot"
          }
        ],
        "recommendedHardware": [],
        "title": "Contoso ebook reader"
      },
      "platformOverrides": {
        "Windows81": {
          "description": "Ebook reader for Windows 8.1"
        }
      }
    }
  },
  "hardwarePreferences": [
    "Touch"
  ],
  "automaticBackupEnabled": false,
  "canInstallOnRemovableMedia": true,
  "isGameDvrEnabled": false,
  "gamingOptions": [],
  "hasExternalInAppProducts": false,
  "meetAccessibilityGuidelines": true,
  "notesForCertification": "",
  "applicationPackages": [
    {
      "fileName": "contoso_app.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"
  },
  "enterpriseLicensing": "Online",
  "allowMicrosoftDecideAppAvailabilityToFutureDeviceFamilies": true,
  "allowTargetFutureDeviceFamilies": {
    "Desktop": false,
    "Mobile": true,
    "Holographic": true,
    "Xbox": false,
    "Team": true
  },
  "trailers": []
}

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. Mer information om värdena i svarskroppen finns i Resurs för appinlämning.

{
  "id": "1152921504621243540",
  "applicationCategory": "BooksAndReference_EReader",
  "pricing": {
    "trialPeriod": "FifteenDays",
    "marketSpecificPricings": {},
    "sales": [],
    "priceId": "Tier2"
  },
  "visibility": "Public",
  "targetPublishMode": "Manual",
  "targetPublishDate": "1601-01-01T00:00:00Z",
  "listings": {
    "en-us": {
      "baseListing": {
        "copyrightAndTrademarkInfo": "",
        "keywords": [
           "epub"
        ],
        "licenseTerms": "",
        "privacyPolicy": "",
        "supportContact": "",
        "websiteUrl": "",
        "description": "Description",
        "features": [
          "Free ebook reader"
        ],
        "releaseNotes": "",
        "images": [
          {
            "fileName": "contoso.png",
            "fileStatus": "Uploaded",
            "id": "1152921504672272757",
            "imageType": "Screenshot"
          }
        ],
        "recommendedHardware": [],
        "title": "Contoso ebook reader"
      },
      "platformOverrides": {
        "Windows81": {
          "description": "Ebook reader for Windows 8.1",
        }
      }
    }
  },
  "hardwarePreferences": [
    "Touch"
  ],
  "automaticBackupEnabled": false,
  "canInstallOnRemovableMedia": true,
  "isGameDvrEnabled": false,
  "gamingOptions": [],
  "hasExternalInAppProducts": false,
  "meetAccessibilityGuidelines": true,
  "notesForCertification": "",
  "status": "PendingCommit",
  "statusDetails": {
    "errors": [],
    "warnings": [],
    "certificationReports": []
  },
  "fileUploadUrl": "https://productingestionbin1.blob.core.windows.net/ingestion/387a9ea8-a412-43a9-8fb3-a38d03eb483d?sv=2014-02-14&sr=b&sig=sdd12JmoaT6BhvC%2BZUrwRweA%2Fkvj%2BEBCY09C2SZZowg%3D&se=2016-06-17T18:32:26Z&sp=rwl",
  "applicationPackages": [
    {
      "fileName": "contoso_app.appx",
      "fileStatus": "PendingUpload",
      "id": "1152921504620138797",
      "version": "1.0.0.0",
      "architecture": "ARM",
      "languages": [
        "en-US"
      ],
      "capabilities": [
        "ID_RESOLUTION_HD720P",
        "ID_RESOLUTION_WVGA",
        "ID_RESOLUTION_WXGA"
      ],
      "minimumDirectXVersion": "None",
      "minimumSystemRam": "None",
      "targetDeviceFamilies": [
        "Windows.Mobile min version 10.0.10240.0"
      ]
    }
  ],
  "packageDeliveryOptions": {
    "packageRollout": {
        "isPackageRollout": false,
        "packageRolloutPercentage": 0.0,
        "packageRolloutStatus": "PackageRolloutNotStarted",
        "fallbackSubmissionId": "0"
    },
    "isMandatoryUpdate": false,
    "mandatoryUpdateEffectiveDate": "1601-01-01T00:00:00.0000000Z"
  },
  "enterpriseLicensing": "Online",
  "allowMicrosoftDecideAppAvailabilityToFutureDeviceFamilies": true,
  "allowTargetFutureDeviceFamilies": {
    "Desktop": false,
    "Mobile": true,
    "Holographic": true,
    "Xbox": false,
    "Team": true
  },
  "friendlyName": "Submission 2",
  "trailers": []
}

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 sändningen eftersom begäran är ogiltig.
409 Det gick inte att uppdatera sändningen 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-api:et för överföring.
  • Last updated on