Mettre à jour une soumission d’application
Utilisez cette méthode dans l’API de soumission du Microsoft Store pour mettre à jour une soumission d’application existante. Une fois que vous avez correctement mis à jour une soumission à l’aide de cette méthode, vous devez valider la soumission pour l’ingestion et la publication.
Pour plus d’informations sur la façon dont cette méthode s’adapte au processus de création d’une soumission d’application à l’aide de l’API de soumission du Microsoft Store, consultez Gérer les soumissions d’applications.
Prérequis
Pour utiliser cette méthode, vous devez d’abord effectuer les opérations suivantes :
- Si vous ne l’avez pas déjà fait, remplissez toutes les conditions préalables pour l’API de soumission au Microsoft Store.
- Obtenir un jeton d’accès Azure AD à utiliser dans l’en-tête de requête pour cette méthode. Une fois que vous avez récupéré le jeton d’accès, vous avez 60 minutes pour l’utiliser avant qu’il n’expire. Une fois le jeton expiré, vous pouvez en obtenir un nouveau.
- Créez une soumission pour l’une de vos applications. Vous pouvez le faire dans l’Espace partenaires, ou vous pouvez le faire à l’aide de la méthode de création d’une soumission d’application.
Requête
Cette méthode a la syntaxe suivante. Consultez les sections suivantes pour obtenir des exemples d’utilisation et des descriptions du corps de l’en-tête et de la demande.
| Méthode | URI de requête |
|---|---|
| PUT | https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/submissions/{submissionId} |
En-tête de requête
| En-tête | Type | Description |
|---|---|---|
| Autorisation | string | Obligatoire. Jeton d’accès Azure AD au format porteur<jeton>. |
Paramètres de la demande
| Nom | Type | Description |
|---|---|---|
| applicationId | string | Obligatoire. ID Store de l’application pour laquelle vous souhaitez mettre à jour une soumission. Pour plus d’informations sur l’ID store, consultez Afficher les détails de l’identité de l’application. |
| submissionId | string | Obligatoire. ID de la soumission à mettre à jour. Cet ID est disponible dans les données de réponse pour les demandes de création d’une soumission d’application. Pour une soumission créée dans l’Espace partenaires, cet ID est également disponible dans l’URL de la page de soumission dans l’Espace partenaires. |
Corps de la demande
Le corps de la requête a les paramètres suivants.
| Valeur | Type | Description |
|---|---|---|
| applicationCategory | string | Chaîne qui spécifie la catégorie et/ou la sous-catégorie de votre application. Les catégories et les sous-catégories sont combinées en une seule chaîne avec le caractère de soulignement '_', comme BooksAndReference_EReader. |
| Prix | object | Objet qui contient des informations de tarification pour l’application. Pour plus d’informations, consultez la section Ressources de tarification . |
| visibility | string | Visibilité de l’application. Il peut s’agir de l’une des valeurs suivantes :
|
| targetPublishMode | string | Mode de publication de la soumission. Il peut s’agir de l’une des valeurs suivantes :
|
| targetPublishDate | string | Date de publication de la soumission au format ISO 8601, si le targetPublishMode est défini sur SpecificDate. |
| référencements | object | Dictionnaire de paires clé et valeur, où chaque clé est un code de pays et chaque valeur est un objet de ressource Listing qui contient des informations de référencement pour l’application. |
| hardwarePreferences | tableau | Tableau de chaînes qui définissent les préférences matérielles de votre application. Il peut s’agir de l’une des valeurs suivantes :
|
| automaticBackupEnabled | booléen | Indique si Windows peut inclure les données de votre application dans les sauvegardes automatiques sur OneDrive. Pour plus d’informations, consultez déclarations d’application. |
| canInstallOnRemovableMedia | booléen | Indique si les clients peuvent installer votre application dans un stockage amovible. Pour plus d’informations, consultez déclarations d’application. |
| isGameDvrEnabled | booléen | Indique si DVR de jeu est activé pour l’application. |
| gamingOptions | object | Tableau qui contient une ressource d’options de jeu qui définit les paramètres liés au jeu pour l’application. |
| hasExternalInAppProducts | booléen | Indique si votre application permet aux utilisateurs d’effectuer un achat en dehors du système de commerce du Microsoft Store. Pour plus d’informations, consultez déclarations d’application. |
| meetAccessibilityGuidelines | booléen | Indique si votre application a été testée pour répondre aux instructions d’accessibilité. Pour plus d’informations, consultez déclarations d’application. |
| notesForCertification | string | Contient des notes de certification pour votre application. |
| applicationPackages | tableau | Contient des objets qui fournissent des détails sur chaque package dans la soumission. Pour plus d’informations, consultez la section Package d’application. Lors de l’appel de cette méthode pour mettre à jour une soumission d’application, seules les valeurs fileName, fileStatus, minimumDirectXVersion et minimumSystemRam de ces objets sont requises dans le corps de la requête. Les autres valeurs sont remplies par l’Espace partenaires. |
| packageDeliveryOptions | object | Contient des paramètres de mise à jour progressifs et de mise à jour obligatoire pour la soumission. Pour plus d’informations, consultez l’objet options de remise de package. |
| enterpriseLicensing | string | Une des valeurs de licence d’entreprise qui indiquent le comportement de licence d’entreprise pour l’application. |
| allowMicrosftDecideAppAvailabilityToFutureDeviceFamilies | booléen | Indique si Microsoft est autorisé à rendre l’application disponible pour les futures familles d’appareils Windows 10 et Windows 11. |
| allowTargetFutureDeviceFamilies | booléen | Indique si votre application est autorisée à cibler les futures familles d’appareils Windows 10 et Windows 11. |
| Remorques | tableau | Tableau qui contient jusqu’aux ressources de bandes-annonces qui représentent des bandes-annonces vidéo pour la liste des applications. |
Exemple de requête
L’exemple suivant montre comment mettre à jour une soumission d’application.
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": []
}
Response
L’exemple suivant illustre le corps de la réponse JSON pour un appel réussi à cette méthode. Le corps de la réponse contient des informations sur la soumission mise à jour. Pour plus d’informations sur les valeurs dans le corps de la réponse, consultez la ressource de soumission d’application.
{
"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": []
}
Codes d’erreur
Si la requête ne peut pas être terminée, la réponse contient l’un des codes d’erreur HTTP suivants.
| Code d'erreur | Description |
|---|---|
| 400 | Impossible de mettre à jour la soumission, car la demande n’est pas valide. |
| 409 | La soumission n’a pas pu être mise à jour en raison de l’état actuel de l’application, ou l’application utilise une fonctionnalité de l’Espace partenaires qui n’est actuellement pas prise en charge par l’API de soumission du Microsoft Store. |