Créer une soumission de vol de paquet

Utilisez cette méthode dans l’API de soumission du Microsoft Store pour créer une nouvelle soumission pour un vol de paquet d’une application. Une fois que vous avez créé une nouvelle soumission à l’aide de cette méthode, mettre à jour la soumission pour apporter les modifications nécessaires aux données de soumission, puis valider la soumission pour l’ingestion et la publication.

Pour plus d'informations sur la façon dont cette méthode s'intègre au processus de création d'une soumission de vol de package à l'aide de l'API de soumission au Microsoft Store, consultez Gérer les soumissions de vol de package.

Remarque

Cette méthode crée une soumission pour un vol de package existant. Pour créer un vol de package, utilisez la méthode créer un vol de package.

Conditions préalables

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 du Microsoft Store.
  • Obtenez 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 un déploiement de package pour une application. Vous pouvez faire cela dans l’Espace partenaires, ou vous pouvez le faire à l’aide de la méthode pour créer un vol de package.

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 la requête
PUBLIER https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions

En-tête de requête

En-tête de page Catégorie Descriptif
Autorisation ficelle Obligatoire. Le jeton d’accès Azure AD sous la forme Bearer<token>.

Paramètres de la demande

Nom Catégorie Descriptif
applicationId ficelle Obligatoire. ID de la boutique de l’application pour laquelle vous souhaitez créer une soumission de vol de paquet. Pour plus d’informations sur l’ID store, consultez Afficher les détails de l’identité de l’application.
flightId ficelle Obligatoire. Identifiant du vol de package pour lequel vous souhaitez ajouter la soumission. Cet ID est disponible dans les données de réponse pour les demandes visant à créer un vol de package et à obtenir des vols de package pour une application.

Corps de la requête

Ne fournissez pas de corps de requête pour cette méthode.

Exemple de requête

L'exemple suivant montre comment créer une soumission de vol de package pour une application dont l'ID de la boutique est 9WZDNCRD91MD.

POST https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions HTTP/1.1
Authorization: Bearer <your access token>

Réponse

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 nouvelle soumission. Pour plus d’informations sur les valeurs dans le corps de la réponse, consultez la ressource de soumission de package de vol .

{
  "id": "1152921504621243649",
  "flightId": "cd2e368a-0da5-4026-9f34-0e7934bc6f23",
  "status": "PendingCommit",
  "statusDetails": {
    "errors": [],
    "warnings": [],
    "certificationReports": []
  },
  "flightPackages": [
    {
      "fileName": "newPackage.appx",
      "fileStatus": "PendingUpload",
      "id": "",
      "version": "1.0.0.0",
      "languages": ["en-us"],
      "capabilities": [],
      "minimumDirectXVersion": "None",
      "minimumSystemRam": "None"
    }
  ],
  "packageDeliveryOptions": {
    "packageRollout": {
        "isPackageRollout": false,
        "packageRolloutPercentage": 0.0,
        "packageRolloutStatus": "PackageRolloutNotStarted",
        "fallbackSubmissionId": "0"
    },
    "isMandatoryUpdate": false,
    "mandatoryUpdateEffectiveDate": "1601-01-01T00:00:00.0000000Z"
  },
  "fileUploadUrl": "https://productingestionbin1.blob.core.windows.net/ingestion/8b389577-5d5e-4cbe-a744-1ff2e97a9eb8?sv=2014-02-14&sr=b&sig=wgMCQPjPDkuuxNLkeG35rfHaMToebCxBNMPw7WABdXU%3D&se=2016-06-17T21:29:44Z&sp=rwl",
  "targetPublishMode": "Immediate",
  "targetPublishDate": "",
  "notesForCertification": "No special steps are required for certification of this app."
}

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 Descriptif
400 La soumission de vol du package n'a pas pu être créée car la demande n'est pas valide.
409 Impossible de créer la soumission de vol de package en raison de l'état actuel de l'application, ou parce que l'application utilise une fonctionnalité de l'Espace partenaires qui n'est pas actuellement prise en charge par l'API de soumission du Microsoft Store.
  • Last updated on