Mettre à jour une soumission d’extensionUpdate an add-on submission

Utilisez cette méthode dans l’API de soumission au Microsoft Store pour mettre à jour une extension existante (également dénommée PIA ou produit in-app).Use this method in the Microsoft Store submission API to update an existing add-on (also known as in-app product or IAP) submission. 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.After you successfully update a submission by using this method, you must commit the submission for ingestion and publishing.

Pour plus d’informations sur la façon dont cette méthode s’inscrit 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 d’extensions.For more information about how this method fits into the process of creating an add-on submission by using the Microsoft Store submission API, see Manage add-on submissions.

Conditions préalablesPrerequisites

Pour utiliser cette méthode, vous devez d’abord effectuer les opérations suivantes :To use this method, you need to first do the following:

  • Si ce n’est pas déjà le cas, remplissez toutes les conditions préalables relatives à l’API de soumission au Microsoft Store.If you have not done so already, complete all the prerequisites for the Microsoft Store submission API.
  • Obtenez un jeton d’accès Azure AD à utiliser dans l’en-tête de requête de cette méthode.Obtain an Azure AD access token to use in the request header for this method. Après avoir obtenu un jeton d’accès, vous avez 60 minutes pour l’utiliser avant expiration.After you obtain an access token, you have 60 minutes to use it before it expires. Une fois le jeton arrivé à expiration, vous pouvez en obtenir un nouveau.After the token expires, you can obtain a new one.
  • Créer une soumission de module complémentaire pour l’une de vos applications.Create an add-on submission for one of your apps. Vous pouvez le faire dans le centre de partenaires, ou vous pouvez le faire à l’aide de la créer une soumission de module complémentaire (méthode).You can do this in Partner Center, or you can do this by using the Create an add-on submission method.

RequêteRequest

Cette méthode présente la syntaxe suivante.This method has the following syntax. 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.See the following sections for usage examples and descriptions of the header and request body.

MéthodeMethod URI de requêteRequest URI
PUTPUT https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/{inAppProductId}/submissions/{submissionId}

En-tête de requêteRequest header

En-têteHeader TypeType DescriptionDescription
AuthorizationAuthorization chaînestring Obligatoire.Required. Le jeton d’accès Azure AD sous la forme PORTEUR < jeton>.The Azure AD access token in the form Bearer <token>.

Paramètres de la requêteRequest parameters

NomName TypeType DescriptionDescription
inAppProductIdinAppProductId chaînestring Obligatoire.Required. ID Windows Store de l’extension pour laquelle vous voulez mettre à jour une soumission.The Store ID of the add-on for which you want to update a submission. L’ID de Store est disponible dans le centre de partenaires, et il est inclus dans les données de réponse pour les demandes au créer un module complémentaire ou obtenir les détails du module complémentaire.The Store ID is available in Partner Center, and it is included in the response data for requests to Create an add-on or get add-on details.
submissionIdsubmissionId chaînestring Obligatoire.Required. ID de la soumission à mettre à jour.The ID of the submission to update. Cet ID est disponible dans les données de réponse des requêtes pour créer une soumission d'extension.This ID is available in the response data for requests to create an add-on submission. Pour la soumission qui a été créée dans le centre de partenaires, cet ID est également disponible dans l’URL de la page d’envoi dans l’espace partenaires.For a submission that was created in Partner Center, this ID is also available in the URL for the submission page in Partner Center.

Corps de la requêteRequest body

Le corps de la requête contient les paramètres suivants.The request body has the following parameters.

ValeurValue TypeType DescriptionDescription
contentTypecontentType chaînestring Type de contenu qui est fourni dans l’extension.The type of content that is provided in the add-on. Les valeurs possibles sont les suivantes :This can be one of the following values:
  • NotSetNotSet
  • BookDownloadBookDownload
  • EMagazineEMagazine
  • ENewspaperENewspaper
  • MusicDownloadMusicDownload
  • MusicStreamMusicStream
  • OnlineDataStorageOnlineDataStorage
  • VideoDownloadVideoDownload
  • VideoStreamVideoStream
  • AspAsp
  • OnlineDownloadOnlineDownload
keywordskeywords tableauarray Tableau de chaînes qui contiennent jusqu’à 10 mots clés pour l’extension.An array of strings that contain up to 10 keywords for the add-on. Votre application peut rechercher des extensions à l’aide de ces mots clés.Your app can query for add-ons using these keywords.
lifetimelifetime chaînestring Durée de vie de l’extension.The lifetime of the add-on. Les valeurs possibles sont les suivantes :This can be one of the following values:
  • ForeverForever
  • OneDayOneDay
  • ThreeDaysThreeDays
  • FiveDaysFiveDays
  • OneWeekOneWeek
  • TwoWeeksTwoWeeks
  • OneMonthOneMonth
  • TwoMonthsTwoMonths
  • ThreeMonthsThreeMonths
  • SixMonthsSixMonths
  • OneYearOneYear
listingslistings objetobject Objet qui contient des informations de référencement pour l’extension.An object that contains listing info for the add-on. Pour plus d’informations, voir la ressource de référencement.For more information, see Listing resource.
pricingpricing objetobject Objet qui contient des informations de tarification pour l’extension.An object that contains pricing info for the add-on. Pour plus d’informations, voir la ressource de tarification.For more information, see Pricing resource.
targetPublishModetargetPublishMode chaînestring Mode de publication pour la soumission.The publish mode for the submission. Les valeurs possibles sont les suivantes :This can be one of the following values:
  • ImmediateImmediate
  • ManuelleManual
  • SpecificDateSpecificDate
targetPublishDatetargetPublishDate chaînestring Date de publication de la soumission au format ISO 8601, si le paramètre targetPublishMode a la valeur SpecificDate.The publish date for the submission in ISO 8601 format, if the targetPublishMode is set to SpecificDate.
tagtag chaînestring Données développeur personnalisées de l’extension (ces informations étaient précédemment appelées tag).The custom developer data for the add-on (this information was previously called the tag).
visibilityvisibility chaînestring Visibilité de l’extension.The visibility of the add-on. Les valeurs possibles sont les suivantes :This can be one of the following values:
  • HiddenHidden
  • PublicPublic
  • PrivatePrivate
  • NotSetNotSet

Exemple de requêteRequest example

L’exemple suivant montre comment mettre à jour une soumission d’extension.The following example demonstrates how to update an add-on submission.

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",
}

RéponseResponse

L’exemple suivant illustre le corps de réponse JSON d’un appel réussi à cette méthode.The following example demonstrates the JSON response body for a successful call to this method. Le corps de la réponse contient des informations sur la soumission mise à jour.The response body contains information about the updated submission. Pour plus d’informations sur les valeurs figurant dans le corps de la réponse, voir la ressource de soumission d’extension.For more details about the values in the response body, see Add-on submission resource.

{
  "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’erreurError codes

Si la requête ne peut pas aboutir, la réponse contient l’un des codes d’erreur HTTP suivants.If the request cannot be successfully completed, the response will contain one of the following HTTP error codes.

Error codeError code DescriptionDescription
400400 Impossible de mettre à jour la soumission, car la requête n’est pas valide.The submission could not be updated because the request is invalid.
409409 L’envoi n’a pas pu être chargé en raison de l’état actuel du module complémentaire ou le module complémentaire utilise une fonctionnalité de partenaires est actuellement ne pas pris en charge par l’API de soumission de Microsoft Store.The submission could not be updated because of the current state of the add-on, or the add-on uses a Partner Center feature that is currently not supported by the Microsoft Store submission API.