Criar um pacote de pré-lançamento
Use esse método na API de envio da Microsoft Store para criar um pacote de pré-lançamento para um aplicativo registrado em sua conta do Partner Center.
Observação
Este método cria um pacote de pré-lançamento sem nenhum envio. Para criar um envio para o pacote de pré-lançamento, consulte os métodos em Gerenciar envios do 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.
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 |
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 pacote de pré-lançamento. Para saber mais informações sobre a ID da Loja, consulte Exibir detalhes de identidade de aplicativo. |
Corpo da solicitação
O corpo da solicitação tem os parâmetros a seguir.
Parâmetro | Type | Descrição | Obrigatório |
---|---|---|---|
friendlyName | string | O nome do pacote de pré-lançamento, conforme especificado pelo desenvolvedor. | Não |
groupIds | array | Uma matriz de cadeias de caracteres que contêm as IDs dos grupos de versão de pré-lançamento que estão associados ao pacote de pré-lançamento. Para saber mais sobre grupos de versão de pré-lançamento, consulte Pacotes de pré-lançamento. | Não |
rankHigherThan | string | O nome amigável do pacote de pré-lançamento que ficou imediatamente abaixo do pacote de pré-lançamento atual. Se você não definir este parâmetro, o novo pacote de pré-lançamento terá a classificação mais alta de todos os pacotes de pré-lançamento. Para saber mais sobre a classificação de grupos de versão de pré-lançamento, consulte Pacotes de pré-lançamento. | Não |
Exemplo de solicitação
O exemplo a seguir demonstra como criar um novo pacote de pré-lançamento para um aplicativo que tem a ID da Loja 9WZDNCRD911W.
POST https://manage.devcenter.microsoft.com/v1.0/my/applications/9NBLGGH4R315/flights HTTP/1.1
Authorization: Bearer eyJ0eXAiOiJKV1Q...
Content-Type: application/json
{
"friendlyName": "myflight",
"groupIds": [
0
],
"rankHigherThan": null
}
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, veja as seções a seguir.
{
"flightId": "43e448df-97c9-4a43-a0bc-2a445e736bcd",
"friendlyName": "myflight",
"groupIds": [
"0"
],
"rankHigherThan": "671c2857-725e-4faf-9e9e-ea1191ef879c"
}
Corpo da resposta
Valor | Type | Descrição |
---|---|---|
flightId | string | A 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 na solicitação. |
groupIds | array | Uma matriz de cadeias de caracteres que contêm os IDs dos grupos de versão de pré-lançamento que estão associados ao pacote de pré-lançamento, conforme especificado na solicitação. Para saber mais 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 que foi classificado imediatamente abaixo do pacote de pré-lançamento atual, conforme especificado na solicitação. Para saber mais sobre a classificação de grupos de versão de pré-lançamento, consulte Pacotes de pré-lançamento. |
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 | A solicitação é inválida. |
409 | O pacote de pré-lançamento não pôde ser criado devido ao estado atual ou o aplicativo usa um recurso do Partner Center que atualmente não tem suporte na API de envio da Microsoft Store. |
Tópicos relacionados
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