Partilhar via

Obter um voo de pacote

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

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.

Pedido

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

Cabeçalho da solicitação

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

Parâmetros de solicitação

Nome Tipo Descrição
applicationId corda Obrigatório A ID da Loja da aplicação que contém o voo do pacote que pretende obter. O ID da loja para a aplicação está disponível no Partner Center.
flightId corda Obrigatório ID do voo do pacote a obter. Esse ID está disponível nos dados de resposta para solicitações para criar um pacote de voo e obter voos de pacote para um aplicativo. Para um voo criado no Partner Center, esse ID também está disponível no URL da página do voo no Partner Center.

Corpo de solicitação

Não forneça um conteúdo de solicitação para este método.

Exemplo de solicitação

O exemplo a seguir demonstra como recuperar informações sobre um voo de pacote com o ID 43e448df-97c9-4a43-a0bc-2a445e736bcd para um aplicativo com o valor de ID da Loja 9WZDNCRD91MD.

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

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",
  "lastPublishedFlightSubmission": {
    "id": "1152921504621086517",
    "resourceLocation": "flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621086517"
  },
  "pendingFlightSubmission": {
    "id": "115292150462124364",
    "resourceLocation": "flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621243647"
  },
  "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 pelo desenvolvedor.
últimaSubmissãoDeVooPublicada objeto Um objeto que fornece informações sobre o último envio publicado para o voo pacote. Para obter mais informações, consulte a seção objeto de Submissão abaixo.
SubmissãoDeVooPendente objeto Um objeto que fornece informações sobre a submissão pendente atual para a remessa de pacote. Para obter mais informações, consulte a seção objeto de Submissão abaixo.
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.
classificarMaisAltoQue corda O nome amigável do voo de pacote que está posicionado imediatamente abaixo do voo de pacote atual. Para obter mais informações sobre como classificar grupos de voos, consulte Voos em pacote.

Objeto de submissão

Os valores lastPublishedFlightSubmission e pendingFlightSubmission no corpo da resposta contêm objetos que fornecem informações de recursos sobre a submissão para o envio de pacote. Esses objetos têm os seguintes valores.

Valor Tipo Descrição
ID corda O identificador da submissão.
LocalizaçãoDoRecurso corda Um caminho relativo que se pode anexar ao URI de solicitação de base https://manage.devcenter.microsoft.com/v1.0/my/ para recuperar todos os dados completos da submissão.

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.
404 Não foi possível encontrar o pacote de voo especificado.
409 O aplicativo usa um recurso do Partner Center que atualmente não é suportado pela API de envio da Microsoft Store.
  • Last updated on