API d’ingestion de produit pour les conteneurs

Article
04/29/2024

L’API d’ingestion de produit est une API modernisée qui unifie toutes les API de soumission existantes sur tous les produits de la Place de marché commerciale. Pour plus d’informations sur la prise en main, reportez-vous à l’API d’ingestion de produit.

Cet article fournit des conseils sur l’utilisation des API spécifiquement pour les conteneurs.

Récupérer les configurations de ressources existantes

Récupérez toutes les ressources d’un produit spécifique dans un seul appel d’API.

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

Vous pouvez récupérer toutes les configurations de ressources au sein d’un produit spécifique en utilisant le type de ressource « resource-tree », ainsi que l’ID durable du produit. La version de schéma que vous fournissez est utilisée comme version maximale prise en charge pour chacune des ressources applicables du produit demandé.

Remarque

Si vous ne connaissez pas l’ID durable du produit, vous pouvez d’abord récupérer la ressource de produit en utilisant l’ID externe du produit et en cours d’exécution. Pour plus d’informations, consultez l’API produit : Méthode 1 : arborescence de ressources.

Exemple d’appel GET :

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

Exemple de réponse :

{
  "$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.
  {
     ...
  }]
}

Synchronisation des audiences privées

Pour un produit en direct, les mises à jour des audiences privées dans les environnements brouillons, en préversion et en direct peuvent être effectuées en même temps sans nécessiter de publication. Vous pouvez synchroniser l’audience privée à l’aide de la ressource « price-and-availability-update-private-audiences » en spécifiant les audiences que vous souhaitez ajouter ou supprimer d’un plan spécifique. Cela synchronise les environnements brouillons, en préversion et en direct pour avoir les mêmes valeurs d’audience privée. Vous n’avez pas besoin de fournir la ressource de soumission lors de la synchronisation de l’audience privée.

Pour modifier les audiences brouillons, utilisez la ressource « price-and-availability-plan » et la propriété « privateAudiences ». Cela doit passer par le flux de publication standard pour que les valeurs soient définies en préversion et en direct.

Important

Si votre produit prend en charge plusieurs types d’identificateurs pour configurer l’audience privée (par exemple, les ID de locataire et les ID d’abonnement), vous devez effectuer une publication complète si vous fournissez un nouveau type d’identificateur pour la première fois. Vous ne pouvez pas synchroniser l’audience privée dans ce cas.

Exemple de requête pour synchroniser la configuration de l’audience privée :