Criar um pacote de pré-lançamentoCreate a package flight

Use esse método na API de envio de Microsoft Store para criar um vôo de pacote para um aplicativo que está registrado em sua conta do Partner Center.Use this method in the Microsoft Store submission API to create a package flight for an app that is registered to your Partner Center account.

Observação

Este método cria um pacote de pré-lançamento sem nenhum envio.This method creates a package flight without any submissions. Para criar um envio para o pacote de pré-lançamento, consulte os métodos em Gerenciar envios do pacote de pré-lançamento.To create a submission for package flight, see the methods in 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.

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
POSTPOST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights

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 para o qual você deseja criar um pacote de pré-lançamento.The Store ID of the app for which you want to create a package flight. 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.

Corpo da solicitaçãoRequest body

O corpo da solicitação tem os parâmetros a seguir.The request body has the following parameters.

ParâmetroParameter TipoType DescriçãoDescription ObrigatórioRequired
friendlyNamefriendlyName stringstring O nome do pacote de pré-lançamento, conforme especificado pelo desenvolvedor.The name of the package flight, as specified by the developer. NãoNo
groupIdsgroupIds matrizarray Uma matriz de cadeias de caracteres que contêm as IDs dos grupos de versão de pré-lançamento que estão associados ao pacote de pré-lançamento.An array of strings that contain the IDs of the flight groups that are associated with the package flight. Para saber mais sobre grupos de versão de pré-lançamento, consulte Pacotes de pré-lançamento.For more information about flight groups, see Package flights. NãoNo
rankHigherThanrankHigherThan stringstring O nome amigável do pacote de pré-lançamento que ficou imediatamente abaixo do pacote de pré-lançamento atual.The friendly name of the package flight that is ranked immediately lower than the current package flight. Se você não definir este parâmetro, o novo pacote de pré-lançamento terá a classificação mais alta de todos os pacotes de pré-lançamento.If you do not set this parameter, the new package flight will have the highest rank of all package flights. Para saber mais sobre a classificação de grupos de versão de pré-lançamento, consulte Pacotes de pré-lançamento.For more information about ranking flight groups, see Package flights. NãoNo

Exemplo de solicitaçãoRequest example

O exemplo a seguir demonstra como criar um novo pacote de pré-lançamento para um aplicativo que tem a ID da Loja 9WZDNCRD911W.The following example demonstrates how to create a new package flight for an app that has the Store ID 9WZDNCRD911W.

POST https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights HTTP/1.1
Authorization: Bearer eyJ0eXAiOiJKV1Q...
Content-Type: application/json
{
  "friendlyName": "myflight",
  "groupIds": [
    0
  ],
  "rankHigherThan": null
}

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. Para obter mais detalhes sobre os valores no corpo da resposta, veja as seções a seguir.For more details about the values in the response body, see the following sections.

{
  "flightId": "43e448df-97c9-4a43-a0bc-2a445e736bcd",
  "friendlyName": "myflight",
  "groupIds": [
    "0"
  ],
  "rankHigherThan": "671c2857-725e-4faf-9e9e-ea1191ef879c"
}

Corpo da respostaResponse body

ValorValue TipoType DescriçãoDescription
flightIdflightId stringstring A ID do pacote de pré-lançamento.The ID for the package flight. Esse valor é fornecido pelo Partner Center.This value is supplied by Partner Center.
friendlyNamefriendlyName stringstring O nome do pacote de pré-lançamento, conforme especificado na solicitação.The name of the package flight, as specified in the request.
groupIdsgroupIds matrizarray Uma matriz de cadeias de caracteres que contêm os IDs dos grupos de versão de pré-lançamento que estão associados ao pacote de pré-lançamento, conforme especificado na solicitação.An array of strings that contain the IDs of the flight groups that are associated with the package flight, as specified in the request. Para saber mais sobre grupos de versão de pré-lançamento, consulte Pacotes de pré-lançamento.For more information about flight groups, see Package flights.
rankHigherThanrankHigherThan stringstring O nome amigável do pacote de pré-lançamento que foi classificado imediatamente abaixo do pacote de pré-lançamento atual, conforme especificado na solicitação.The friendly name of the package flight that is ranked immediately lower than the current package flight, as specified in the request. Para saber mais sobre a classificação de grupos de versão de pré-lançamento, consulte Pacotes de pré-lançamento.For more information about ranking flight groups, see Package flights.

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
400400 A solicitação é inválida.The request is invalid.
409409 Não foi possível criar o vôo do pacote devido a seu estado atual, 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 could not be created because of its current state, or the app uses a Partner Center feature that is currently not supported by the Microsoft Store submission API.