Creare un pacchetto in anteprima

  • Articolo

Usare questo metodo nell'API di invio di Microsoft Store per creare un pacchetto in anteprima per un'app registrata nel proprio account del Centro per i partner.

Nota

Questo metodo crea un pacchetto in anteprima senza invii. Per creare un invio per il pacchetto in anteprima, vedere i metodi in Gestire gli invii di pacchetti in anteprima.

Prerequisiti

Per usare questo metodo, è necessario prima eseguire le operazioni seguenti:

  • Se non lo si è ancora fatto, completare i prerequisiti per l'API di invio di Microsoft Store.
  • Ottenere un token di accesso di Azure AD da usare nell'intestazione della richiesta per questo metodo. Dopo aver ottenuto un token di accesso, questo sarà disponibile per 60 minuti prima della scadenza. Dopo la scadenza del token, è possibile ottenerne uno nuovo.

Richiesta

Questo metodo ha la sintassi seguente. Vedere le sezioni seguenti per esempi di uso e descrizioni dell'intestazione e del corpo della richiesta.

metodo URI della richiesta
POST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights

Intestazione della richiesta

Intestazione Type Descrizione
Autorizzazione stringa Obbligatorio. Token di accesso di Azure AD nel formato Token di<connessione>.

Parametri della richiesta

Nome Tipo Descrizione
applicationId string Obbligatorio. ID dello Store dell'app per cui si desidera creare un pacchetto in anteprima. Per ulteriori informazioni sull'ID dello Store, vedere Visualizzare i dettagli dell'identità dell'app.

Corpo della richiesta

Il corpo della richiesta include i seguenti parametri.

Parametro Tipo Descrizione Richiesto
friendlyName string Nome del pacchetto in anteprima, come specificato dallo sviluppatore. No
groupIds array Matrice di stringhe che contengono gli ID dei gruppi di pacchetti in anteprima associati al pacchetto in anteprima. Per ulteriori informazioni sui gruppi di pacchetti in anteprima, vedere Pacchetti in anteprima. No
rankHigherThan string Nome descrittivo del pacchetto in anteprima con classificazione immediatamente inferiore al pacchetto in anteprima corrente. Se non si imposta questo parametro, il nuovo pacchetto in anteprima avrà la classificazione più alta di tutti i pacchetti in anteprima. Per ulteriori informazioni sulla classificazione dei gruppi di pacchetti in anteprima, vedere Pacchetti in anteprima. No

Esempio di richiesta

L'esempio seguente illustra come creare un nuovo pacchetto in anteprima per un'app con ID dello Store 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
}

Response

L'esempio seguente illustra il corpo della risposta JSON per una chiamata riuscita a questo metodo. Per ulteriori dettagli sui valori nel corpo della risposta, vedere le sezioni seguenti.

{
  "flightId": "43e448df-97c9-4a43-a0bc-2a445e736bcd",
  "friendlyName": "myflight",
  "groupIds": [
    "0"
  ],
  "rankHigherThan": "671c2857-725e-4faf-9e9e-ea1191ef879c"
}

Corpo della risposta

Valore Tipo Descrizione
flightId string ID del pacchetto in anteprima. Questo valore è fornito dal Centro per i partner.
friendlyName string Nome del pacchetto in anteprima, come specificato nella richiesta.
groupIds array Matrice di stringhe che contengono gli ID dei gruppi di pacchetti in anteprima associati al pacchetto in anteprima, come specificato nella richiesta. Per ulteriori informazioni sui gruppi di pacchetti in anteprima, vedere Pacchetti in anteprima.
rankHigherThan string Nome descrittivo del pacchetto in anteprima con classificazione immediatamente inferiore al pacchetto in anteprima corrente, come specificato nella richiesta. Per ulteriori informazioni sulla classificazione dei gruppi di pacchetti in anteprima, vedere Pacchetti in anteprima.

Codici di errore

Se la richiesta non può essere completata, la risposta conterrà uno dei codici di errore HTTP seguenti.

Codice di errore Description
400 La richiesta non è valida.
409 Impossibile creare il pacchetto in anteprima a causa del suo stato corrente o perché l'app usa una funzionalità del Centro per i partner attualmente non supportata dall'API di invio di Microsoft Store.