Compartilhar via

Criar um pacote de pré-lançamento

  • Artigo

Use esse método na API de envio da Microsoft Store para criar um pacote de pré-lançamento para um aplicativo registrado em sua conta do Partner Center.

Observação

Esse método cria um pacote de pré-lançamento sem nenhum envio. Para criar um envio para pacotes de pré-lançamento, consulte os métodos em Gerenciar envios de pacotes de pré-lançamento.

Pré-requisitos

Para usar este método, primeiro você precisa fazer o seguinte:

  • Se você ainda não tiver feito isso, conclua todos os pré-requisitos para a API de envio da Microsoft Store.
  • Obtenha um token de acesso do Azure AD a ser usado no cabeçalho da solicitação para esse método. Após obter um token de acesso, você tem 60 minutos para usá-lo antes dele expirar. Depois que o token expirar, você poderá obter um novo.

Solicitar

Esse método tem a seguinte sintaxe. Consulte as seções a seguir para obter exemplos de uso e descrições do cabeçalho e do corpo da solicitação.

Método URI da solicitação
POST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights

Cabeçalho da solicitação

Cabeçalho Tipo Descrição
Autorização string Obrigatório. O token de acesso do Azure AD no Token<de portador> do formulário.

Parâmetros da solicitação

Nome Tipo Descrição
applicationId string Obrigatória. A ID da Loja do aplicativo para o qual você deseja criar um pacote de pré-lançamento. Para obter mais informações sobre a ID da Loja, consulte Exibir detalhes da identidade do aplicativo.

Corpo da solicitação

O corpo da solicitação tem os seguintes parâmetros.

Parâmetro Tipo Descrição Obrigatório
friendlyName string O nome do pacote de pré-lançamento, conforme especificado pelo desenvolvedor. Não
groupIds matriz Uma matriz de strings que contém as IDs dos grupos de pré-lançamento associados ao pacote de pré-lançamento. Para obter mais informações sobre grupos de versão de pré-lançamento, consulte Pacotes de pré-lançamento. Não
rankHigherThan string O nome amigável do pacote de pré-lançamento classificado imediatamente abaixo do pacote de pré-lançamento atual. Se você não definir esse parâmetro, o novo pacote de pré-lançamento terá a classificação mais alta de todos os pacotes de pré-lançamento. Para obter mais informações sobre como classificar grupos de versão de pré-lançamento, consulte Pacotes de pré-lançamento. Não

Exemplo de solicitação

O exemplo a seguir demonstra como criar um novo pacote de pré-lançamento para um aplicativo que tem a ID da Loja 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
}

Resposta

O exemplo a seguir demonstra o corpo da resposta JSON para uma chamada bem-sucedida para esse método. Para obter mais detalhes sobre os valores no corpo da resposta, consulte as seções a seguir.

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

Corpo da resposta

Valor Type Descrição
ID do voo string O ID do pacote de pré-lançamento. Esse valor é fornecido pelo Partner Center.
friendlyName string O nome do pacote de pré-lançamento, conforme especificado na solicitação.
groupIds matriz Uma matriz de strings que contém as IDs dos grupos de pré-lançamento associados ao pacote de pré-lançamento, conforme especificado na solicitação. Para obter mais informações sobre grupos de versão de pré-lançamento, consulte Pacotes de pré-lançamento.
rankHigherThan string O nome amigável do pacote de pré-lançamento que é classificado imediatamente abaixo do pacote de pré-lançamento atual, conforme especificado na solicitação. Para obter mais informações sobre como classificar grupos de versão de pré-lançamento, consulte Pacotes de pré-lançamento.

Códigos do Erro

Se a solicitação não puder ser concluída com êxito, a resposta conterá um dos seguintes códigos de erro HTTP.

Código do erro Description
400 A solicitação é inválida.
409 O pacote de pré-lançamento não pôde ser criado devido ao seu estado atual ou o aplicativo usa um recurso do Partner Center que atualmente não é compatível com a API de envio da Microsoft Store.