Compartilhar via

Obter pacotes de pré-lançamento de um app

  • Artigo

Use esse método na API de envio da Microsoft Store para listar os pacotes de pré-lançamento de um aplicativo registrado em sua conta do Partner Center. Para obter mais informações sobre pacotes de pré-lançamento, consulte 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
GET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/listflights

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 Obrigatório
applicationId string A ID da Loja do aplicativo para o qual você deseja recuperar os pacotes de pré-lançamento. Para obter mais informações sobre a ID da Loja, consulte Exibir detalhes da identidade do aplicativo. Sim
top int O número de itens a serem devolvidos na solicitação (ou seja, o número de pacotes de pré-lançamento a serem devolvidos). Se sua conta tiver mais pacotes de pré-lançamento do que o valor especificado na consulta, o corpo da resposta incluirá um caminho de URI relativo que você pode acrescentar ao URI do método para solicitar a próxima página de dados. Não
skip int O número de itens a serem ignorados na consulta antes de retornar os itens restantes. Use esse parâmetro para percorrer os conjuntos de dados. Por exemplo, top=10 e skip=0 recuperam os itens de 1 a 10, top=10 e skip=10 recuperam os itens de 11 a 20 e assim por diante. Não

Corpo da solicitação

Não forneça um corpo de solicitação para esse método.

Exemplos de solicitação

O exemplo a seguir demonstra como listar todos os pacotes de pré-lançamento de um aplicativo.

GET https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/listflights HTTP/1.1
Authorization: Bearer <your access token>

O exemplo a seguir demonstra como listar o primeiro pacote de pré-lançamento para um aplicativo.

GET https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/listflights?top=1 HTTP/1.1
Authorization: Bearer <your access token>

Resposta

O exemplo a seguir demonstra o corpo da resposta JSON retornado por uma solicitação bem-sucedida para o primeiro pacote de pré-lançamento de um aplicativo com três pacotes de pré-lançamento no total. Para obter mais detalhes sobre os valores no corpo da resposta, consulte a seção a seguir.

{
  "value": [
    {
      "flightId": "7bfc11d5-f710-47c5-8a98-e04bb5aad310",
      "friendlyName": "myflight",
      "lastPublishedFlightSubmission": {
        "id": "1152921504621086517",
        "resourceLocation": "flights/7bfc11d5-f710-47c5-8a98-e04bb5aad310/submissions/1152921504621086517"
      },
      "pendingFlightSubmission": {
        "id": "1152921504621215786",
        "resourceLocation": "flights/7bfc11d5-f710-47c5-8a98-e04bb5aad310/submissions/1152921504621215786"
      },
      "groupIds": [
        "1152921504606962205"
      ],
      "rankHigherThan": "Non-flighted submission"
    }
  ],
  "totalCount": 3
}

Corpo da resposta

Valor Type Descrição
@nextLink string Se houver páginas adicionais de dados, essa cadeia de caracteres conterá um caminho relativo que você pode acrescentar ao URI de solicitação base https://manage.devcenter.microsoft.com/v1.0/my/ para solicitar a próxima página de dados. Por exemplo, se o parâmetro top do corpo da solicitação inicial estiver definido como 2, mas houver 4 pacotes de pré-lançamento para o aplicativo, o corpo da resposta incluirá um @nextLink valor de applications/{applicationid}/listflights/?skip=2&top=2, que indica que você pode chamar https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationid}/listflights/?skip=2&top=2 para solicitar os próximos 2 pacotes de pré-lançamento.
value matriz Uma matriz de objetos que fornecem informações sobre pacotes de pré-lançamento para o aplicativo especificado. Para obter mais informações sobre os dados em cada objeto, consulte Recurso de voo.
contagem total int O número total de linhas no resultado de dados para a consulta (ou seja, o número total de pacotes de pré-lançamento para o aplicativo especificado).

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 Descrição
404 Nenhum pacote de voos foi encontrado.
409 O aplicativo usa um recurso do Partner Center que atualmente não é compatível com a API de envio da Microsoft Store.