Partilhar via

Criar um voo de pacote

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

Observação

Este método cria um voo de pacote sem quaisquer envios. Para criar um envio para voos de pacotes, consulte os métodos em Gerenciar envios de voos de pacotes.

Pré-requisitos

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

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

Solicitação

Este 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 Solicitar URI
Publicação https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights

Cabeçalho da solicitação

Cabeçalho Tipo Descrição
Autorização corda Obrigatório O token de acesso do Azure AD no formato portador<token>.

Parâmetros de solicitação

Nome Tipo Descrição
applicationId corda Obrigatório A ID da Loja da aplicação para a qual pretende criar um voo de pacote. Para obter mais informações sobre a ID da Loja, consulte Exibir detalhes da identidade do aplicativo.

Corpo de solicitação

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

Parâmetro Tipo Descrição Obrigatório
Nome amigável corda O nome do voo do pacote, conforme especificado pelo desenvolvedor. Não
IDs de grupo conjunto Uma matriz de cadeias de caracteres que contêm os IDs dos grupos de voo associados ao voo do pacote. Para obter mais informações sobre grupos de voos, consulte Voos organizados. Não
classificarMaisAltoQue corda O nome amigável do voo de pacote que está posicionado imediatamente abaixo do voo de pacote atual. Se você não definir esse parâmetro, o novo pacote de voo terá a classificação mais alta de todos os voos do pacote. Para obter mais informações sobre como classificar grupos de voos, consulte Voos em pacote. Não

Exemplo de solicitação

O exemplo a seguir demonstra como criar um novo voo de pacote 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 de 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 Tipo Descrição
flightId corda O ID do voo do pacote. Este valor é fornecido pelo Partner Center.
Nome amigável corda O nome do voo do pacote, conforme especificado na solicitação.
IDs de grupo conjunto Uma matriz de cadeias de caracteres que contêm os IDs dos grupos de voo associados ao voo do pacote, conforme especificado na solicitação. Para obter mais informações sobre grupos de voos, consulte Voos organizados.
classificarMaisAltoQue corda O nome amigável do voo do pacote que é classificado imediatamente abaixo do voo do pacote atual, conforme especificado na solicitação. Para obter mais informações sobre como classificar grupos de voos, consulte Voos em pacote.

Códigos de 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 de erro Descrição
400 O pedido é inválido.
409 O voo do pacote não pôde ser criado devido ao seu estado atual ou o aplicativo usa um recurso do Partner Center que atualmente não é suportado pela API de envio da Microsoft Store.
  • Last updated on