Condividi tramite

Creare un componente aggiuntivo

  • Articolo

Usare questo metodo nell'API di invio di Microsoft Store per creare un componente aggiuntivo (anche denominato prodotto in-app o IAP) per un'app registrata nel proprio account del Centro per i partner.

Nota

Questo metodo crea un componente aggiuntivo senza invii. Per creare un invio per un componente aggiuntivo, vedere i metodi in Gestire gli invii di componenti aggiuntivi.

Prerequisiti

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

  • Se non lo si ha 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.

Richiedi

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/inappproducts

Intestazione della richiesta

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

Corpo della richiesta

Il corpo della richiesta include i seguenti parametri.

Parametro Tipo Descrizione Richiesto
applicationIds array Matrice che contiene l'ID dello Store dell'app a cui è associato questo componente aggiuntivo. In questa matrice è supportato un solo elemento. Sì
productId string ID prodotto del componente aggiuntivo. Si tratta di un identificatore che può essere usato nel codice per fare riferimento al componente aggiuntivo. Per ulteriori informazioni, vedere Impostare il tipo di prodotto e l'ID prodotto. Sì
productType string Il tipo di prodotto del componente aggiuntivo. Sono supportati i valori seguenti: Durable e Consumable. Sì

Esempio di richiesta

L'esempio seguente illustra come creare un nuovo componente aggiuntivo Consumable per un'app.

POST https://manage.devcenter.microsoft.com/v1.0/my/inappproducts HTTP/1.1
Authorization: Bearer eyJ0eXAiOiJKV1Q...
Content-Type: application/json
{
    "applicationIds": [  "9NBLGGH4R315"  ],
    "productId": "my-new-add-on",
    "productType": "Consumable",
}

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 Risorsa del componente aggiuntivo.

{
  "applications": {
    "value": [
      {
        "id": "9NBLGGH4R315",
        "resourceLocation": "applications/9NBLGGH4R315"
      }
    ],
    "totalCount": 1
  },
  "id": "9NBLGGH4TNMP",
  "productId": "my-new-add-on",
  "productType": "Consumable",
}

Codici di errore

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

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