Share via

Ottenere un componente aggiuntivo

  • Articolo

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

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
GET https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/{inAppProductId}

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
id string Obbligatorio. ID dello Store del componente aggiuntivo da recuperare. L'ID dello Store è disponibile nel Centro per i partner.

Corpo della richiesta

Non fornire un corpo della richiesta per questo metodo.

Esempio di richiesta

L'esempio seguente illustra come recuperare informazioni su un componente aggiuntivo.

GET https://manage.devcenter.microsoft.com/v1.0/my/inappproducts/9NBLGGH4TNMP HTTP/1.1
Authorization: Bearer <your access token>

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": "Test-add-on",
  "productType": "Durable",
  "pendingInAppProductSubmission": {
    "id": "1152921504621243619",
    "resourceLocation": "inappproducts/9NBLGGH4TNMP/submissions/1152921504621243619"
  },
  "lastPublishedInAppProductSubmission": {
    "id": "1152921504621243705",
    "resourceLocation": "inappproducts/9NBLGGH4TNMP/submissions/1152921504621243705"
  }
}

Codici di errore

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

Codice di errore Descrizione
404 Il componente aggiuntivo specificato non è stato trovato.
409 Il componente aggiuntivo usa una funzionalità del Centro per i partner attualmente non supportata dall'API di invio di Microsoft Store.