Compartilhar via

Obter um pacote de pré-lançamento

  • Artigo

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

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}/flights/{flightId}

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 que contém o pacote de pré-lançamento que você deseja obter. A ID da Loja do aplicativo está disponível no Partner Center.
ID do voo string Obrigatória. O ID do pacote de voo a ser obtido. Essa ID está disponível nos dados de resposta para solicitações para criar um pacote de pré-lançamento e obter pacotes de pré-lançamento para um aplicativo. Para um voo criado no Partner Center, essa ID também está disponível na URL da página de voo no Partner Center.

Corpo da solicitação

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

Exemplo de solicitação

O exemplo a seguir demonstra como recuperar informações sobre um pacote de pré-lançamento com a ID 43e448df-97c9-4a43-a0bc-2a445e736bcd para um aplicativo com o valor da 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 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",
  "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 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 pelo desenvolvedor.
lastPublishedFlightSubmission objeto Um objeto que fornece informações sobre o último envio publicado para o pacote de pré-lançamento. Para obter mais informações, consulte a seção Objeto de envio abaixo.
pendingFlightSubmission objeto Um objeto que fornece informações sobre o envio pendente atual para o pacote de pré-lançamento. Para obter mais informações, consulte a seção Objeto de envio abaixo.
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.
rankHigherThan string O nome amigável do pacote de pré-lançamento classificado imediatamente abaixo do pacote de pré-lançamento atual. Para obter mais informações sobre como classificar grupos de versão de pré-lançamento, consulte Pacotes de pré-lançamento.

Objeto de envio

Os valores lastPublishedFlightSubmission e pendingFlightSubmission no corpo da resposta contêm objetos que fornecem informações de recursos sobre um envio para o pacote de pré-lançamento. Esses objetos têm os seguintes valores.

Valor Type Descrição
id string A ID do envio.
resourceLocation string Um caminho relativo que você pode acrescentar ao URI de solicitação base https://manage.devcenter.microsoft.com/v1.0/my/ para recuperar os dados completos do envio.

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.
404 O pacote de voo especificado não 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.