Atualizar um envio de pacote de pré-lançamento

2025-06-10

Use esse método na API de envio da Microsoft Store para atualizar um envio de pacote de pré-lançamento existente. Depois de atualizar com êxito um envio usando esse método, você deve confirmar o envio para ingestão e publicação.

Para obter mais informações sobre como esse método se encaixa no processo de criação de um envio de pacote de pré-lançamento usando a API de envio da Microsoft Store, consulte Gerenciar envios de pacote 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.
Crie um envio de pacote de pré-lançamento para um de seus aplicativos. Você pode fazer isso no Partner Center ou pode fazer isso usando o método de envio de criação de um pacote de pré-lançamento .

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
COLOCAR	`https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions/{submissionId}`

Cabeçalho da solicitação

Cabeçalho	Tipo	Descrição
Autorização	corda	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
ID do aplicativo	corda	Obrigatório. A ID da Loja do aplicativo para o qual você deseja atualizar um envio de pacote de pré-lançamento. Para obter mais informações sobre a ID da Loja, consulte Exibir detalhes da identidade do aplicativo.
ID do voo	corda	Obrigatório. A ID do pacote de pré-lançamento para o qual você deseja atualizar um envio. 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.
ID de submissão	corda	Obrigatório. A ID do envio a ser atualizado. Essa ID está disponível nos dados de resposta para solicitações para criar um envio de pacote de pré-lançamento. Para um envio criado no Partner Center, essa ID também está disponível na URL da página de envio no Partner Center.
packageId	corda	Obrigatório. A ID do pacote existente.

Corpo da solicitação

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

Valor	Tipo	Descrição
pacotes de voo	matriz	Contém objetos que fornecem detalhes sobre cada pacote no envio. Para obter mais detalhes sobre os valores no corpo da resposta, consulte Recurso do pacote de pré-lançamento. Ao chamar esse método para atualizar um envio de aplicativo, somente os valores fileName, fileStatus, minimumDirectXVersion e minimumSystemRam desses objetos são necessários no corpo da solicitação. Os outros valores são preenchidos pelo Partner Center.
opçõesDeEntregaDePacotes	objeto	Contém a distribuição gradual do pacote e as configurações de atualização obrigatórias para o envio. Para obter mais informações, consulte Objeto de opções de entrega de pacote.
modo de publicação alvo	corda	O modo de publicação para o envio. Esse valor pode ser um dos seguintes: Imediata Manual Data específica
data-alvo de publicação	corda	A data de publicação para o envio no formato ISO 8601, se o targetPublishMode estiver definido como SpecificDate.
notasParaCertificação	corda	Fornece informações adicionais para os testadores de certificação, como credenciais de conta de teste e etapas para acessar e verificar recursos. Para obter mais informações, consulte Notas para certificação.

Exemplo de solicitação

O exemplo a seguir demonstra como atualizar um envio de pacote de pré-lançamento para um aplicativo.

PUT https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions/1152921504621243649 HTTP/1.1
Authorization: Bearer <your access token>
Content-Type: application/json
{
  "flightPackages": [
    {
      "id": "existingPackage.Id",
      "fileName": "newPackage.appx",
      "fileStatus": "PendingUpload",
      "minimumDirectXVersion": "None",
      "minimumSystemRam": "None"
    }
  ],
  "packageDeliveryOptions": {
    "packageRollout": {
        "isPackageRollout": false,
        "packageRolloutPercentage": 0.0,
        "packageRolloutStatus": "PackageRolloutNotStarted",
        "fallbackSubmissionId": "0"
    },
    "isMandatoryUpdate": false,
    "mandatoryUpdateEffectiveDate": "1601-01-01T00:00:00.0000000Z"
  },
  "targetPublishMode": "Immediate",
  "targetPublishDate": "",
  "notesForCertification": "No special steps are required for certification of this app."
}

Resposta

O exemplo a seguir demonstra o corpo da resposta JSON para uma chamada bem-sucedida para esse método. O corpo da resposta contém informações sobre o envio atualizado. Para obter mais detalhes sobre os valores no corpo da resposta, consulte Recurso de envio de pacote de pré-lançamento.

{
  "id": "1152921504621243649",
  "flightId": "cd2e368a-0da5-4026-9f34-0e7934bc6f23",
  "status": "PendingCommit",
  "statusDetails": {
    "errors": [],
    "warnings": [],
    "certificationReports": []
  },
  "flightPackages": [
    {
      "fileName": "newPackage.appx",
      "fileStatus": "PendingUpload",
      "id": "",
      "version": "1.0.0.0",
      "languages": ["en-us"],
      "capabilities": [],
      "minimumDirectXVersion": "None",
      "minimumSystemRam": "None"
    }
  ],
  "packageDeliveryOptions": {
    "packageRollout": {
        "isPackageRollout": false,
        "packageRolloutPercentage": 0.0,
        "packageRolloutStatus": "PackageRolloutNotStarted",
        "fallbackSubmissionId": "0"
    },
    "isMandatoryUpdate": false,
    "mandatoryUpdateEffectiveDate": "1601-01-01T00:00:00.0000000Z"
  },
  "fileUploadUrl": "https://productingestionbin1.blob.core.windows.net/ingestion/8b389577-5d5e-4cbe-a744-1ff2e97a9eb8?sv=2014-02-14&sr=b&sig=wgMCQPjPDkuuxNLkeG35rfHaMToebCxBNMPw7WABdXU%3D&se=2016-06-17T21:29:44Z&sp=rwl",
  "targetPublishMode": "Immediate",
  "targetPublishDate": "",
  "notesForCertification": "No special steps are required for certification of this app."
}

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
400	O envio do pacote de pré-lançamento não pôde ser atualizado porque a solicitação é inválida.
409	O envio do pacote de pré-lançamento não pôde ser atualizado devido ao estado atual do aplicativo ou o aplicativo usa um recurso do Partner Center que atualmente não tem suporte da API de envio da Microsoft Store.