Criar um envio de pacote de pré-lançamento
Use este método na API de envio da Microsoft Store para criar um novo envio para um pacote de pré-lançamento para um app. Depois de criar um novo envio com êxito usando esse método, atualize o envio para fazer as alterações necessárias para os dados de envio e depois confirme o envio para inclusã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.
Observação
Este método cria um envio para um pacote de pré-lançamento existente. Para criar um pacote de pré-lançamento, use o método criar um 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 pacote de pré-lançamento para um aplicativo. Você pode fazer isso no Partner Center ou pode fazer isso usando o método criar um 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 |
---|---|
POST | https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions |
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 criar 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 adicionar o 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. |
Corpo da solicitação
Não forneça um corpo da solicitação para esse método.
Exemplo de solicitação
O exemplo a seguir demonstra como criar um novo envio de pacote de pré-lançamento para um aplicativo que tem a ID da Loja 9WZDNCRD91MD.
POST https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights/43e448df-97c9-4a43-a0bc-2a445e736bcd/submissions 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. O corpo da resposta contém informações sobre o novo envio. 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 criar 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 criado 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. |
Tópicos relacionados
- Criar e gerenciar envios usando serviços da Microsoft Store
- Gerenciar envios de pacote de pré-lançamento
- Obter um envio de pacote de pré-lançamento
- Confirmar um envio de pacote de pré-lançamento
- Atualizar um envio de pacote de pré-lançamento
- Excluir um envio de pacote de pré-lançamento
- Obter o status de um envio de pacote de pré-lançamento
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de