API di inserimento prodotti per contenitori

Articolo
06/14/2024

L'API di inserimento prodotti è un'API modernizzata che unifica tutte le API di invio esistenti in tutti i prodotti del marketplace commerciale. Per informazioni dettagliate su come iniziare, vedere API di inserimento prodotti.

Questo articolo fornisce indicazioni su come usare le API in modo specifico per i contenitori.

Recuperare le configurazioni delle risorse esistenti

Recuperare tutte le risorse all'interno di un prodotto specifico in una singola chiamata API.

GET resource-tree/<product-durableID>?$version=<schema-version>

È possibile recuperare tutte le configurazioni delle risorse all'interno di un prodotto specifico usando il tipo di risorsa "albero delle risorse" insieme all'ID durevole del prodotto. La versione dello schema specificata viene usata come versione massima supportata per ognuna delle risorse applicabili del prodotto richiesto.

Nota

Se non si conosce l'ID durevole del prodotto, è possibile recuperare prima la risorsa del prodotto usando l'ID esterno del prodotto e l'esecuzione. Per altre informazioni, vedere PRODUCT API: Method 1: resource tree(API prodotto: Metodo 1: albero delle risorse).

Chiamata GET di esempio:

GET https://graph.microsoft.com/rp/product-ingestion/resource-tree/product/12345678-abcd-efgh-1234-12345678901?targetType=" anteprima"&$version=2022-03-01-preview5

Risposta campione:

{
  "$schema": "https://schema.mp.microsoft.com/schema/resource-tree/2022-03-01-preview2",
  "root": "product/12345678-abcd-efgh-1234-12345678901",
  "target": {
    "targetType": "preview"
  },
  "resources": [
  { 
    "$schema": "https://schema.mp.microsoft.com/schema/product/2022-03-01-preview3",
    "id": "product/12345678-abcd-efgh-1234-12345678901",
    "identity": {
      "externalID": "product_external_id_example"
    },
    "type": "azureContainer",
    "alias": "product_example"
  },
  { 
    "$schema": "https://schema.mp.microsoft.com/schema/commercial-marketplace-setup/2022-03-01-preview2",
    "id": "commercial-marketplace-setup/12345678-abcd-efgh-1234-12345678901",
    "product": "product/12345678-abcd-efgh-1234-12345678901",
    "sellThroughMicrosoft": true
  },
  {
    "$schema": "https://schema.mp.microsoft.com/schema/plan/2022-03-01-preview2",
    "id": "plan/12345678-abcd-efgh-1234-12345678901/98756328-04e9-55ae-9403-52b6c971a956
  ...
  }, 
     // The response would include all existing resources within this product.
  {
     ...
  }]
}

Sincronizza destinatari privati

Per un prodotto live, gli aggiornamenti ai destinatari privati nella bozza, nell'anteprima e negli ambienti live possono essere eseguiti contemporaneamente senza richiedere una pubblicazione. È possibile sincronizzare il gruppo di destinatari privato usando la risorsa "price-and-availability-update-private-audiences" specificando i gruppi di destinatari da aggiungere o rimuovere da un piano specifico. Verrà sincronizzata la bozza, l'anteprima e gli ambienti live in modo che abbiano gli stessi valori del gruppo di destinatari privati. Non è necessario fornire la risorsa di invio durante la sincronizzazione del gruppo di destinatari privato.

Per modificare i destinatari della bozza, usare la risorsa "price-and-availability-plan" e la proprietà "privateAudiences". Sarà necessario eseguire il normale flusso di pubblicazione per impostare i valori in anteprima e in tempo reale.

Importante

Se il prodotto supporta più tipi di identificatore per configurare il gruppo di destinatari privato (ad esempio, ID tenant e ID sottoscrizione), è necessario eseguire una pubblicazione completa se si specifica un nuovo tipo di identificatore per la prima volta. In questo caso non è possibile sincronizzare il gruppo di destinatari privato.

Richiesta di esempio per sincronizzare la configurazione del gruppo di destinatari privato: