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

  • Artigo

Use este método na API de envio da Microsoft Store para atualizar um envio de versão de pacote de pré-lançamento existente. Depois de atualizar com êxito um envio usando esse método, você deverá 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 do seguinte:

  • Se você 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 este 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 criar um envio de pacote de pré-lançamento .

Solicitação

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

Método URI da solicitação
PUT https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions/{submissionId}

Cabeçalho da solicitação

parâmetro Tipo Descrição
Autorização string Obrigatórios. O token de acesso Azure AD notoken> de portador< de formulário.

Parâmetros da solicitação

Nome Type Descrição
applicationId string Obrigatórios. A ID da Loja do aplicativo para o qual você deseja atualizar um envio do pacote de pré-lançamento. Para saber mais informações sobre a ID da Loja, consulte Exibir detalhes de identidade de aplicativo.
flightId string Obrigatórios. 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 de 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 pré-lançamento no Partner Center.
submissionId string Obrigatórios. A ID do envio para atualizar. Esse 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.

Corpo da solicitação

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

Valor Type Descrição
flightPackages array 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. Durante a chamada desse 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.
packageDeliveryOptions objeto Contém as configurações de distribuição de pacote gradual e de atualização obrigatória para o envio. Para obter mais informações, consulte Objeto de opções de entrega de pacote.
targetPublishMode string O modo de publicação do envio. Esse valor pode ser um dos seguintes:
  • Imediata
  • Manual
  • SpecificDate
targetPublishDate string A data de publicação do envio em formato ISO 8601, se o targetPublishMode estiver definido como SpecificDate.
notesForCertification string Fornece informações adicionais para os testadores de certificação, como credenciais da conta de teste e as etapas para acessar e confirmar recursos. Para obter mais informações, consulte Notas para certificação.

Exemplo de solicitação

O exemplo a seguir demonstra como atualizar um envio do 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": [
    {
      "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 não for possível concluir a solicitação, a resposta conterá um dos seguintes códigos de erro HTTP.

Código do erro Descrição
400 Não foi possível atualizar o envio do pacote de pré-lançamento porque a solicitação é inválida.
409 O envio de 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.