Condividi tramite

Ottenere tutti i componenti aggiuntivi

  • Articolo

Usare questo metodo nell'API di invio di Microsoft Store per recuperare i dati per tutti i componenti aggiuntivi per tutte le app registrate 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

Intestazione della richiesta

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

Parametri della richiesta

Tutti i parametri della richiesta sono facoltativi per questo metodo. Se si chiama questo metodo senza parametri, la risposta conterrà i dati per tutti i componenti aggiuntivi per tutte le app registrate nel proprio account.

Parametro Tipo Descrizione Richiesto
migliori int Numero di elementi da restituire nella richiesta (ossia il numero di componenti aggiuntivi da restituire). Se nel proprio account è presente un numero di componenti aggiuntivi maggiore del valore specificato nella query, il corpo della risposta includerà un percorso URI relativo che è possibile aggiungere all'URI del metodo per richiedere la pagina di dati successiva. No
skip int Numero di elementi da ignorare nella query prima di restituire gli elementi rimanenti. Usare questo parametro per scorrere i set di dati. Ad esempio, top=10 e skip=0 recupera gli elementi da 1 a 10, top=10 e skip=10 recupera gli elementi da 11 a 20 e così via. No

Corpo della richiesta

Non fornire un corpo della richiesta per questo metodo.

Esempi di richiesta

L'esempio seguente illustra come recuperare tutti i dati dei componenti aggiuntivi per tutte le app registrate nel proprio account.

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

L'esempio seguente illustra come recuperare solo i primi 10 componenti aggiuntivi.

GET https://manage.devcenter.microsoft.com/v1.0/my/inappproducts?top=10 HTTP/1.1
Authorization: Bearer <your access token>

Response

L'esempio seguente illustra il corpo della risposta JSON restituito da una richiesta riuscita dei primi 5 componenti aggiuntivi registrati in un account sviluppatore con 1.072 componenti aggiuntivi totali. Per brevità, questo esempio mostra solo i dati per i primi due componenti aggiuntivi restituiti dalla richiesta. Per ulteriori dettagli sui valori nel corpo della risposta, vedere la sezione seguente.

{
  "@nextLink": "inappproducts/?skip=5&top=5",
  "value": [
    {
      "applications": {
        "value": [
          {
            "id": "9NBLGGH4R315",
            "resourceLocation": "applications/9NBLGGH4R315"
          }
        ],
        "totalCount": 1
      },
      "id": "9NBLGGH4TNMP",
      "productId": "a8b8310b-fa8d-4da0-aca0-577ef6dce4dd",
      "productType": "Consumable",
      "pendingInAppProductSubmission": {
        "id": "1152921504621243619",
        "resourceLocation": "inappproducts/9NBLGGH4TNMP/submissions/1152921504621243619"
      },
      "lastPublishedInAppProductSubmission": {
        "id": "1152921504621243705",
        "resourceLocation": "inappproducts/9NBLGGH4TNMP/submissions/1152921504621243705"
      }
    },
    {
      "applications": {
        "value": [
          {
            "id": "9NBLGGH4R315",
            "resourceLocation": "applications/9NBLGGH4R315"
          }
        ],
        "totalCount": 1
      },
      "id": "9NBLGGH4TNMN",
      "productId": "6a3c9788-a350-448a-bd32-16160a13018a",
      "productType": "Consumable",
      "pendingInAppProductSubmission": {
        "id": "1152921504621243538",
        "resourceLocation": "inappproducts/9NBLGGH4TNMN/submissions/1152921504621243538"
      },
      "lastPublishedInAppProductSubmission": {
        "id": "1152921504621243106",
        "resourceLocation": "inappproducts/9NBLGGH4TNMN/submissions/1152921504621243106"
      }
    },

  // Other add-ons omitted for brevity...
  ],
  "totalCount": 1072
}

Corpo della risposta

Valore Tipo Descrzione
@nextLink stringa Se sono presenti pagine aggiuntive di dati, questa stringa contiene un percorso relativo che è possibile aggiungere all'URI della richiesta https://manage.devcenter.microsoft.com/v1.0/my/ di base per richiedere la pagina di dati successiva. Ad esempio, se il parametro top del corpo della richiesta iniziale è impostato su 10 ma vi sono 100 componenti aggiuntivi registrati nel proprio account, il corpo della risposta includerà un valore @nextLinkinappproducts?skip=10&top=10 che indica che è possibile chiamare https://manage.devcenter.microsoft.com/v1.0/my/inappproducts?skip=10&top=10 per richiedere i successivi 10 componenti aggiuntivi.
value matrice Matrice che contiene oggetti che forniscono informazioni su ogni componente aggiuntivo. Per ulteriori informazioni, vedere Risorsa del componente aggiuntivo.
totalCount int Numero di oggetti dell'app nella matrice value del corpo della risposta.

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 Non sono stati trovati componenti aggiuntivi.
409 Le app o i componenti aggiuntivi usano funzionalità del Centro per i partner attualmente non supportate dall'API di invio di Microsoft Store.