Condividi tramite

Gestire i componenti aggiuntivi

  • Articolo

Utilizza i metodi seguenti nell'API di invio di Microsoft Store per gestire i componenti aggiuntivi per le tue app. Per un'introduzione all'API di invio di Microsoft Store, inclusi i prerequisiti per l'utilizzo dell'API, vedereCrea e gestisci invii utilizzando i servizi di Microsoft Store.

Questi metodi possono essere utilizzati solo per ottenere, creare o eliminare componenti aggiuntivi. Per creare invii per componenti aggiuntivi, vedere i metodi in Gestione degli invii di componenti aggiuntivi.

Method URI Descrizione
GET https://manage.devcenter.microsoft.com/v1.0/my/inappproducts Ottieni tutti i componenti aggiuntivi per le tue app
GET https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/{inAppProductId} Ottieni un componente aggiuntivo specifico
POST https://manage.devcenter.microsoft.com/v1.0/my/inappproducts Creare un componente aggiuntivo
DELETE https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/{inAppProductId} Elimina un componente aggiuntivo

Prerequisiti

Se non lo hai già fatto, completa tutti iprerequisitio l'API di invio a Microsoft Store prima di provare a utilizzare uno di questi metodi.

Risorse dati

I metodi API di invio di Microsoft Store per la gestione dei componenti aggiuntivi utilizzano le seguenti risorse di dati JSON.

Risorsa componente aggiuntivo

Questa risorsa descrive un componente aggiuntivo.

{
  "applications": {
    "value": [
      {
        "id": "9NBLGGH4R315",
        "resourceLocation": "applications/9NBLGGH4R315"
      }
    ],
    "totalCount": 1
  },
  "id": "9NBLGGH4TNMP",
  "productId": "TestAddOn",
  "productType": "Durable",
  "pendingInAppProductSubmission": {
    "id": "1152921504621243619",
    "resourceLocation": "inappproducts/9NBLGGH4TNMP/submissions/1152921504621243619"
  },
  "lastPublishedInAppProductSubmission": {
    "id": "1152921504621243705",
    "resourceLocation": "inappproducts/9NBLGGH4TNMP/submissions/1152921504621243705"
  }
}

Questa risorsa ha i seguenti valori.

Valore Tipo Descrizione
applications array Un array che contiene una risorsa dell'applicazione che rappresenta l'app a cui è associato questo componente aggiuntivo. In questo array è supportato un solo elemento.
id string L'ID dello Store del componente aggiuntivo. Questo valore viene fornito dallo Store. Un esempio di Store ID è 9NBLGGH4TNMP.
productId string L'ID prodotto del componente aggiuntivo. Questo è l'ID fornito dallo sviluppatore al momento della creazione del componente aggiuntivo. Per maggiori informazioni, vedere Imposta il tipo di prodotto e l'ID prodotto.
productType string Il tipo di prodotto del componente aggiuntivo. Sono supportati i seguenti valori: Durevole eConsumabile.
lastPublishedInAppProductSubmission oggetto Una risorsa di invio che fornisce informazioni sull'ultimo invio pubblicato per il componente aggiuntivo.
pendingInAppProductSubmission oggetto Una risorsa di invio che fornisce informazioni sull'attuale invio in sospeso per il componente aggiuntivo.

Risorsa dell'applicazione

Questa risorsa descrive l'app a cui è associato un componente aggiuntivo. L'esempio seguente dimostra il formato di questa risorsa.

{
  "applications": {
    "value": [
      {
        "id": "9NBLGGH4R315",
        "resourceLocation": "applications/9NBLGGH4R315"
      }
    ],
    "totalCount": 1
  },
}

Questa risorsa ha i seguenti valori.

Valore Tipo Descrizione
value oggetto Un oggetto che contiene i seguenti valori:
  • id. L'ID dello Store dell'app. Per ulteriori informazioni sull'ID negozio, vedere Visualizza i dettagli dell'identità dell'app.
  • resourceLocation. Un percorso relativo che puoi aggiungere https://manage.devcenter.microsoft.com/v1.0/my/ all'URI della richiesta di base per recuperare i dati completi per l'app.
totalCount int Il numero di oggetti app nell'array delle applicazioni applicazioni del corpo della risposta.

Risorsa di invio

Questa risorsa fornisce informazioni sull'invio di un componente aggiuntivo. L'esempio seguente dimostra il formato di questa risorsa.

{
  "pendingInAppProductSubmission": {
    "id": "1152921504621243619",
    "resourceLocation": "inappproducts/9NBLGGH4TNMP/submissions/1152921504621243619"
  },
}

Questa risorsa ha i seguenti valori.

Valore Tipo Descrizione
id string L'ID dell'invio.
resourceLocation string Un percorso relativo che puoi aggiungere https://manage.devcenter.microsoft.com/v1.0/my/ all'URI della richiesta di base per recuperare i dati completi per l'invio.