Partager via

Mettre à jour une soumission d’extension

  • Article

Utilisez cette méthode dans l’API de soumission du Microsoft Store pour mettre à jour une soumission d’extension existante (également connue sous le nom de produit in-app ou IAP). 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’extension à l’aide de l’API de soumission du 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 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 d’extension 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 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/inappproducts/{inAppProductId}/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
inAppProductId string Obligatoire. ID store du module complémentaire pour lequel vous souhaitez mettre à jour une soumission. L’ID store est disponible dans l’Espace partenaires, et il est inclus dans les données de réponse pour les demandes de création d’un module complémentaire ou obtenir les détails du 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 d’extension. 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
contentType string Le type de contenu fourni dans le module complémentaire. Il peut s’agir de l’une des valeurs suivantes :
  • NotSet
  • BookDownload
  • EMagazine
  • ENewspaper
  • MusicDownload
  • MusicStream
  • OnlineDataStorage
  • VideoDownload
  • VideoStream
  • Asp
  • OnlineDownload
mots clés tableau Tableau de chaînes contenant jusqu’à 10 mot clés pour le module complémentaire. Votre application peut rechercher des modules complémentaires à l’aide de ces mot clé.
lifetime string Durée de vie du module complémentaire. Il peut s’agir de l’une des valeurs suivantes :
  • Toujours
  • OneDay
  • ThreeDays
  • FiveDays
  • OneWeek
  • TwoWeeks
  • OneMonth
  • TwoMonths
  • ThreeMonths
  • SixMonths
  • OneYear
référencements object Objet qui contient des informations de référencement pour le module complémentaire. Pour plus d’informations, consultez Liste des ressources.
Prix object Objet qui contient des informations de tarification pour le module complémentaire. Pour plus d’informations, consultez la ressource de tarification.
targetPublishMode string Mode de publication de la soumission. Il peut s’agir de l’une des valeurs suivantes :
  • Immédiat
  • Manuel
  • SpecificDate
targetPublishDate string Date de publication de la soumission au format ISO 8601, si le targetPublishMode est défini sur SpecificDate.
tag string Données de développeur personnalisées pour le module complémentaire (ces informations étaient précédemment appelées balise).
visibility string Visibilité du module complémentaire. Il peut s’agir de l’une des valeurs suivantes :
  • Masqué(e)
  • ///Public
  • Privée
  • NotSet

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 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 de module complémentaire.

{
  "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 ê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 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 du Microsoft Store.