Compartilhar via

Criar um pacote de voo

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

Observação

Esse método cria um pacote de voo sem submissões. Para criar um envio para o pacote de pré-lançamento, consulte os métodos em Gerenciar envios de pacote de pré-lançamento.

Pré-requisitos

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

  • Se você ainda não fez 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. Depois de obter um token de acesso, você terá 60 minutos para usá-lo antes que ele expire. Depois que o token expirar, você poderá obter um novo.

Solicitação

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

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

Cabeçalho da solicitação

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

Parâmetros de solicitação

Nome Tipo Descrição
ID do aplicativo cadeia de caracteres Obrigatório O ID da Loja do aplicativo para o qual você deseja criar um pacote de voo. 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
nome amigável cadeia de caracteres O nome do pacote de voo, conforme especificado pelo desenvolvedor. Não
IDs de grupo matriz Uma matriz de cadeias de caracteres que contêm as IDs dos grupos de voo associados ao voo do pacote. Para obter mais informações sobre grupos de voo, consulte pacotes de voos . Não
rankHigherThan cadeia de caracteres O nome amigável do voo de pacote que é classificado imediatamente abaixo do voo de pacote atual. Se você não definir esse parâmetro, o novo voo de pacote terá a classificação mais alta de todos os voos de pacotes. Para obter mais informações sobre a classificação de grupos de voos, consulte Pacote de voos. Não

Exemplo de solicitação

O exemplo a seguir demonstra como criar um novo pacote de voo para um aplicativo com o 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 de uma chamada bem-sucedida a este 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
ID do voo cadeia de caracteres O ID do voo do pacote. Esse valor é fornecido pelo Partner Center.
nome amigável cadeia de caracteres O nome do pacote de voo, conforme especificado na solicitação.
IDs de grupo matriz Uma matriz de strings que contém os IDs dos grupos de voo associados ao pacote de voo, conforme especificado na solicitação. Para obter mais informações sobre grupos de voo, consulte pacotes de voos .
rankHigherThan cadeia de caracteres O nome amigável do pacote de voo que é classificado imediatamente abaixo do pacote de voo corrente, conforme especificado na solicitação. Para obter mais informações sobre a classificação de grupos de voos, consulte Pacote de voos.

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 do erro Descrição
400 A solicitação é inválida.
409 O pacote de voo 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.