Mettre à jour une soumission d’extension
Utilisez cette méthode dans l’API de soumission au Microsoft Store pour mettre à jour une soumission de module complémentaire existante (également appelée produit in-app ou IAP). Après avoir mis à jour une soumission à l’aide de cette méthode, vous devez valider la soumission en vue de son intégration et de sa publication.
Pour plus d’informations sur la façon dont cette méthode s’intègre dans le processus de création d’une soumission d’extension à l’aide de l’API de soumission au Microsoft Store, consultez Gérer les soumissions de modules complémentaires.
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 tous les prérequis pour l’API de soumission au Microsoft Store.
- Obtenez un jeton d’accès Azure AD à utiliser dans l’en-tête de requête de 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 arrivé à expiration, vous pouvez en obtenir un nouveau.
- Créez une soumission de module complémentaire 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 Créer une soumission d’extension .
Requête
Cette méthode présente la syntaxe suivante. Consultez les sections suivantes pour obtenir des exemples d’utilisation et une description de l’en-tête et du corps de la requête.
Méthode | URI de requête |
---|---|
PUT | https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/{inAppProductId}/submissions/{submissionId} |
En-tête de requête
En-tête | Type | Description |
---|---|---|
Autorisation | string | Obligatoire. Jeton d’accès Azure AD sous la formeJeton> du porteur<. |
Paramètres de la demande
Nom | Type | Description |
---|---|---|
inAppProductId | string | Obligatoire. ID Windows Store de l’extension pour laquelle vous voulez mettre à jour une soumission. L’ID store est disponible dans l’Espace partenaires et est inclus dans les données de réponse pour les demandes de création d’un module complémentaire ou d’obtention de détails sur le module complémentaire. |
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 de module complémentaire. 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 contient les paramètres suivants.
Valeur | Type | Description |
---|---|---|
contentType | string | Type de contenu qui est fourni dans l’extension. Il peut s’agir de l’une des valeurs suivantes :
|
mots clés | tableau | Tableau de chaînes qui contiennent jusqu’à 10 mots clés pour l’extension. Votre application peut rechercher des extensions à l’aide de ces mots clés. |
lifetime | string | Durée de vie de l’extension. Il peut s’agir de l’une des valeurs suivantes :
|
listings | object | Objet qui contient des informations de référencement pour l’extension. Pour plus d’informations, voir la ressource de référencement. |
Prix | object | Objet qui contient des informations de tarification pour l’extension. Pour plus d’informations, voir la ressource de tarification. |
targetPublishMode | string | Mode de publication pour 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 paramètre targetPublishMode a la valeur SpecificDate. |
tag | string | Données développeur personnalisées de l’extension (ces informations étaient précédemment appelées tag). |
visibility | string | Visibilité de l’extension. Il peut s’agir de l’une des valeurs suivantes :
|
Exemple de requête
L’exemple suivant montre comment mettre à jour une soumission d’extension.
PUT https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/9NBLGGH4TNMP/submissions/1152921504621230023 HTTP/1.1
Authorization: Bearer <your access token>
Content-Type: application/json
{
"contentType": "EMagazine",
"keywords": [
"books"
],
"lifetime": "FiveDays",
"listings": {
"en": {
"description": "English add-on description",
"icon": {
"fileName": "add-on-en-us-listing2.png",
"fileStatus": "Uploaded"
},
"title": "Add-on Title (English)"
},
"ru": {
"description": "Russian add-on description",
"icon": {
"fileName": "add-on-ru-listing.png",
"fileStatus": "Uploaded"
},
"title": "Add-on Title (Russian)"
}
},
"pricing": {
"marketSpecificPricings": {
"RU": "Tier3",
"US": "Tier4",
},
"sales": [],
"priceId": "Free"
},
"targetPublishDate": "2016-03-15T05:10:58.047Z",
"targetPublishMode": "Immediate",
"tag": "SampleTag",
"visibility": "Public",
}
response
L’exemple suivant illustre le corps de réponse JSON d’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 figurant dans le corps de la réponse, voir la ressource de soumission d’extension.
{
"id": "1152921504621243680",
"contentType": "EMagazine",
"keywords": [
"books"
],
"lifetime": "FiveDays",
"listings": {
"en": {
"description": "English add-on description",
"icon": {
"fileName": "add-on-en-us-listing2.png",
"fileStatus": "Uploaded"
},
"title": "Add-on Title (English)"
},
"ru": {
"description": "Russian add-on description",
"icon": {
"fileName": "add-on-ru-listing.png",
"fileStatus": "Uploaded"
},
"title": "Add-on Title (Russian)"
}
},
"pricing": {
"marketSpecificPricings": {
"RU": "Tier3",
"US": "Tier4",
},
"sales": [],
"priceId": "Free"
},
"targetPublishDate": "2016-03-15T05:10:58.047Z",
"targetPublishMode": "Immediate",
"tag": "SampleTag",
"visibility": "Public",
"status": "PendingCommit",
"statusDetails": {
"errors": [
{
"code": "None",
"details": "string"
}
],
"warnings": [
{
"code": "ListingOptOutWarning",
"details": "You have removed listing language(s): []"
}
],
"certificationReports": [
{
}
]
},
"fileUploadUrl": "https://productingestionbin1.blob.core.windows.net/ingestion/26920f66-b592-4439-9a9d-fb0f014902ec?sv=2014-02-14&sr=b&sig=usAN0kNFNnYE2tGQBI%2BARQWejX1Guiz7hdFtRhyK%2Bog%3D&se=2016-06-17T20:45:51Z&sp=rwl",
"friendlyName": "Submission 2"
}
Codes d’erreur
Si la requête ne peut pas aboutir, 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 requête n’est pas valide. |
409 | La soumission n’a pas pu être mise à jour en raison de l’état actuel du module complémentaire, ou le module complémentaire utilise une fonctionnalité de l’Espace partenaires qui n’est actuellement pas prise en charge par l’API de soumission au Microsoft Store. |
Rubriques connexes
- Créer et gérer des soumissions à l’aide des services du Microsoft Store
- Gérer les soumissions d’extensions
- Obtenir une soumission de module complémentaire
- Créer une soumission d’extension
- Valider une soumission d’extension
- Supprimer une soumission d’extension
- Obtenir l’état d’une soumission d’extension
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour