Obter um envio de pacote de pré-lançamentoGet a package flight submission

Use este método na API de envio da Microsoft Store para obter dados para um envio de pacote de pré-lançamento existente.Use this method in the Microsoft Store submission API to get data for an existing package flight submission. Para obter mais informações sobre o processo de criação de um envio de pacote de pré-lançamento usando a API de envio da Microsoft Store, consulte Gerenciar envios do pacote de pré-lançamento.For more information about the process of process of creating a package flight submission by using the Microsoft Store submission API, see Manage package flight submissions.

Pré-requisitosPrerequisites

Para usar este método, primeiro você precisa do seguinte:To use this method, you need to first do the following:

  • Se você não tiver feito isso, conclua todos os pré-requisitos para a API de envio da Microsoft Store.If you have not done so already, complete all the prerequisites for the Microsoft Store submission API.
  • Obtenha um token de acesso do Azure AD a ser usado no cabeçalho da solicitação para este método.Obtain an Azure AD access token to use in the request header for this method. Após obter um token de acesso, você tem 60 minutos para usá-lo antes dele expirar.After you obtain an access token, you have 60 minutes to use it before it expires. Depois que o token expirar, você poderá obter um novo.After the token expires, you can obtain a new one.
  • Criar um envio de vôo de pacote para um aplicativo no Partner Center.Create a package flight submission for an app in Partner Center. Você pode fazer isso no Partner Center ou pode fazer isso usando o método criar um pacote de envio de vôo .You can do this in Partner Center, or you can do this by using the create a package flight submission method.

SolicitaçãoRequest

Esse método tem a seguinte sintaxe.This method has the following syntax. Veja as seções a seguir para obter exemplos de uso e descrições do corpo da solicitação e do cabeçalho.See the following sections for usage examples and descriptions of the header and request body.

MétodoMethod URI da solicitaçãoRequest URI
GETGET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions{submissionId}

Cabeçalho da solicitaçãoRequest header

CabeçalhoHeader TipoType DescriçãoDescription
AutorizaçãoAuthorization stringstring Obrigatórios.Required. O token de acesso do Azure AD no formulário Bearer <token>.The Azure AD access token in the form Bearer <token>.

Parâmetros da solicitaçãoRequest parameters

NomeName TipoType DescriçãoDescription
applicationIdapplicationId stringstring Obrigatórios.Required. A ID da Loja do aplicativo que contém o envio do pacote de pré-lançamento que você deseja obter.The Store ID of the app that contains the package flight submission you want to get. Para saber mais informações sobre a ID da Loja, consulte Exibir detalhes de identidade de aplicativo.For more information about the Store ID, see View app identity details.
flightIdflightId stringstring Obrigatórios.Required. A ID do pacote de pré-lançamento que contém o envio que você deseja obter.The ID of the package flight that contains the submission you want to get. Essa ID está disponível nos dados de resposta de solicitações para criar um pacote de pré-lançamento e obter pacotes de pré-lançamento para um aplicativo.This ID is available in the response data for requests to create a package flight and get package flights for an app. Para um vôo criado no Partner Center, essa ID também está disponível na URL da página de vôo no Partner Center.For a flight that was created in Partner Center, this ID is also available in the URL for the flight page in Partner Center.
submissionIdsubmissionId stringstring Obrigatórios.Required. A ID do envio a ser obtida.The ID of the submission to get. Esse ID está disponível nos dados de resposta para solicitações para criar um envio de pacote de pré-lançamento.This ID is available in the response data for requests to create a package flight submission. Para um envio criado no Partner Center, essa ID também está disponível na URL da página de envio no Partner Center.For a submission that was created in Partner Center, this ID is also available in the URL for the submission page in Partner Center.

Corpo da solicitaçãoRequest body

Não forneça um corpo da solicitação para esse método.Do not provide a request body for this method.

Exemplo de solicitaçãoRequest example

O exemplo a seguir demonstra como obter um envio de pacote de pré-lançamento para um aplicativo que tem a ID da Loja 9WZDNCRD91MD.The following example demonstrates how to get a package flight submission for an app that has the Store ID 9WZDNCRD91MD.

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

RespostaResponse

O exemplo a seguir demonstra o corpo da resposta JSON para uma chamada bem-sucedida para esse método.The following example demonstrates the JSON response body for a successful call to this method. O corpo da resposta contém informações sobre o envio especificado.The response body contains information about the specified submission. Para obter mais detalhes sobre os valores no corpo da resposta, consulte Recurso de envio de pacote de pré-lançamento.For more details about the values in the response body, see Package flight submission resource.

{
  "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."
}

Códigos do ErroError codes

Se não for possível concluir a solicitação, a resposta conterá um dos seguintes códigos de erro HTTP.If the request cannot be successfully completed, the response will contain one of the following HTTP error codes.

Código do erroError code DescriçãoDescription
404404 O envio do pacote de pré-lançamento não foi encontrado.The package flight submission could not be found.
409409 O envio de vôo do pacote não pertence ao vôo do pacote especificado ou o aplicativo usa um recurso do Partner Center que atualmente não tem suporte da API de envio do Microsoft Store.The package flight submission does not belong to the specified package flight, or the app uses a Partner Center feature that is currently not supported by the Microsoft Store submission API.