Ressources de produits
Ressources qui représentent des biens ou services purchasables. Inclut des ressources pour décrire le type de produit et la forme (SKU) et pour vérifier la disponibilité du produit dans un inventaire.
Produit
Représente un bon ou un service purchasable. Un produit lui-même n’est pas un élément purchasable.
| Propriété | Type | Description |
|---|---|---|
| id | Chaîne | ID d’un produit. |
| title | Chaîne | Titre du produit. |
| description | Chaîne | Description du produit. |
| productType | Type d'élément | Objet qui décrit la ou les catégorisations de type de ce produit. |
| isMicrosoftProduct | Bool | Indique si le produit est un produit Microsoft. |
| publisherName | Chaîne | Nom de l’éditeur du produit s’il est disponible. |
| liens | ProductLinks | Liens de ressources contenus dans le produit. |
ItemType
Représente le type d’un produit.
| Propriété | Type | Description |
|---|---|---|
| id | Chaîne | Identificateur de type. |
| displayName | Chaîne | Nom complet d’un type d’élément. |
| subType | Type d'élément | facultatif. Objet qui décrit une catégorisation de sous-type pour un type d’élément. |
ProductLinks
Contient une liste de liens pour un produit.
| Propriété | Type | Description |
|---|---|---|
| skus | Lien | Lien permettant d’accéder aux références SKU sous-jacentes. |
| liens | ResourceLinks | Liens de ressources contenus dans une ressource. |
Sku
Représente une unité de conservation de stock purchasable (SKU) sous un produit.
| Propriété | Type | Description |
|---|---|---|
| id | Chaîne | ID de la référence SKU. L’ID est unique uniquement dans le contexte de son produit parent. |
| title | Chaîne | Titre de la référence SKU. |
| description | Chaîne | Description de la référence SKU. |
| productId | Chaîne | ID du produit parent qui contient une référence SKU. |
| minimumQuantity | Int | Quantité minimale autorisée pour l’achat. |
| maximumQuantity | Int | Quantité maximale autorisée pour l’achat. |
| isTrial | Bool | Indique si une référence SKU est un élément d’évaluation. |
| supportedBillingCycles | Tableau de chaînes | Liste des cycle de facturation prises en charge pour une référence SKU. Les valeurs prises en charge sont les noms des membres trouvés dans BillingCycleType. |
| purchasePrerequisites | Tableau de chaînes | Liste des étapes ou actions requises avant l’achat d’un élément. Les valeurs prises en charge sont : « InventoryCheck » : indique que l’inventaire de l’élément doit être évalué avant de tenter d’acheter un article. « AzureSubscriptionRegistration » : indique qu’un abonnement Azure est nécessaire et doit être inscrit avant de tenter d’acheter un élément. |
| inventoryVariables | Tableau de chaînes | Liste des variables nécessaires pour exécuter une vérification d’inventaire sur un élément. Les valeurs prises en charge sont : « CustomerId » : ID du client pour lequel l’achat serait destiné. « AzureSubscriptionId » : ID de l’abonnement Azure qui serait utilisé pour un achat de réservation Azure. « ArmRegionName » : région pour laquelle vérifier l’inventaire. Cette valeur doit correspondre à « ArmRegionName » à partir de DynamicAttributes de la référence SKU. |
| provisioningVariables | Tableau de chaînes | Liste des variables qui doivent être fournies dans le contexte d’approvisionnement d’un élément de ligne de panier lors de l’achat d’un élément. Les valeurs prises en charge sont : Étendue : étendue d’un achat de réservation Azure : « Unique », « Partagé ». « SubscriptionId » : ID de l’abonnement Azure qui serait utilisé pour un achat de réservation Azure. « Duration » - Durée de la réservation Azure : « 1Year », « 3Year ». |
| dynamicAttributes | paires clé/valeur | Dictionnaire de propriétés dynamiques qui s’appliquent à un élément. Les propriétés d’un dictionnaire sont dynamiques et peuvent changer sans préavis. Les partenaires doivent éviter de créer des dépendances fortes sur des clés particulières existantes dans la valeur d’une propriété. |
| liens | ResourceLinks | Liens de ressources contenus dans la référence SKU. |
| AttestationProperties | AttestationProperties | Propriétés d’attestation d’une référence SKU. |
| consumptionType | Chaîne | N’est disponible que si la référence SKU prend en charge la consommation telle que le dépassement. |
| specializedOfferProperties | Liste de specializedOfferProperties | Est disponible uniquement si le produit est sous-type de SpecializedOffer. |
| minimumPurchaseCommitment | MinimumPurchaseCommitment | Montant fixe validé sur les services de calcul. |
Attributs de référence SKU dynamiques
Propriétés notables pertinentes pour les nouveaux produits et services basés sur des licences commerciales.
Remarque
Les nouvelles expériences commerciales pour les services basés sur des licences incluent de nombreuses nouvelles fonctionnalités et sont disponibles pour tous les Fournisseur de solutions Cloud (CSP). Pour plus d’informations, consultez la Vue d’ensemble des nouvelles expériences commerciales.
| Propriété | Type | Description |
|---|---|---|
| hasConstraints | Boolean | Décrit si la référence SKU contient assetContraints |
| isAddon | Boolean | Décrit si la référence SKU est un module complémentaire |
| prérequisSkus | tableau de chaînes | Décrit les produits et références SKU que le module complémentaire peut utiliser |
| upgradeTargetOffers | tableau de chaînes | Une liste de produits et de références SKU que l’élément peut mettre à niveau vers |
| conversionInstructions | Liste des conversionInstructions | Liste des instructions applicables aux opérations de conversion |
specializedOfferProperties
Remarque
Les nouvelles expériences commerciales pour les services basés sur des licences incluent de nombreuses nouvelles fonctionnalités et sont disponibles pour tous les Fournisseur de solutions Cloud (CSP). Pour plus d’informations, consultez la Vue d’ensemble des nouvelles expériences commerciales.
Applicable uniquement aux sous-types de produits « SpecializedOffers »
| Propriété | Type | Description |
|---|---|---|
| startDate | Chaîne | ID de terme les instructions s’appliquent à |
| endDate | Chaîne | Options qui définissent les renouvellements |
| pricingPolicies | Liste des tarifsPolicies | Liste des stratégies qui définissent les types et valeurs de remise de promotion. |
MinimumPurchaseCommitment
Attributs de la quantité minimale pouvant être validée sur les services de calcul.
| Propriété | Type | Description |
|---|---|---|
| grain | Chaîne | Période de l’engagement d’achat minimal. |
| currencyCode | Chaîne de<dictionnaire, chaîne> | La « devise » et le « symbole » du montant minimal pouvant être validé. |
| montant | Int | Montant minimal pouvant être validé sur les services de calcul. |
PricingPolicies
Décrire les types et valeurs de remise de promotion.
| Propriété | Type | Description |
|---|---|---|
| type | Chaîne | Décrivez si la remise est basée sur des pourcentages ou des remises à taux fixe. |
| value | Chaîne | Définit le montant de la remise appliquée. |
Disponibilité
Représente une configuration dans laquelle une référence SKU est disponible pour l’achat (par exemple, pays/région, devise et segment du secteur).
| Propriété | Type | Description |
|---|---|---|
| id | Chaîne | ID de cette disponibilité. Cet ID est unique uniquement dans le contexte de son produit parent et de sa référence SKU. Notez que les ID de disponibilité peuvent changer au fil du temps. Les partenaires ne doivent compter que sur cette valeur dans un court intervalle de temps après sa récupération. |
| productId | Chaîne | ID du produit qui contient cette disponibilité. |
| skuId | Chaîne | ID de la référence SKU qui contient cette disponibilité. |
| catalogItemId | Chaîne | Identificateur unique de cet élément dans le catalogue. Cet ID doit être renseigné dans les propriétés OrderLineItem.OfferId ou CartLineItem.CatalogItemId lors de l’achat de la référence SKU parente. Notez que cet ID peut changer au fil du temps. Vous ne devez compter que sur cette valeur dans un court délai après sa récupération. Il doit être accessible uniquement et utilisé au moment de l’achat. |
| defaultCurrency | Chaîne | Devise par défaut prise en charge pour cette disponibilité. |
| segment | Chaîne | Segment du secteur pour cette disponibilité. Les valeurs prises en charge sont les suivantes : Commercial, Education, Government, NonProfit. |
| country | Chaîne | Pays ou région (au format de code pays ISO) où cette disponibilité s’applique. |
| isPurchasable | Bool | Indique si cette disponibilité est purchassable. |
| isRenewable | Bool | Indique si cette disponibilité est renouvelable. |
| RenewalInstructions | RenewalInstruction | Représente des instructions de renouvellement pour une disponibilité donnée. |
| product | Produit | Le produit à laquelle cette disponibilité correspond. |
| sku | Sku | La référence SKU à laquelle cette disponibilité correspond. |
| terms | Tableau de ressources de terme | Collection de termes applicables à cette disponibilité. |
| liens | ResourceLinks | Liens de ressources contenus dans la disponibilité. |
Instruction de renouvellement
Remarque
Les nouvelles expériences commerciales pour les services basés sur des licences incluent de nombreuses nouvelles fonctionnalités et sont disponibles pour tous les Fournisseur de solutions Cloud (CSP). Pour plus d’informations, consultez la Vue d’ensemble des nouvelles expériences commerciales.
Représente des instructions de renouvellement pour une disponibilité donnée.
| Propriété | Type | Description |
|---|---|---|
| applicableTermIds | Tableau de chaînes | ID de terme les instructions s’appliquent à |
| RenewalOptions | Tableau de RenewalOption | Options qui définissent les renouvellements |
RenewalOption
Remarque
Les nouvelles expériences commerciales pour les services basés sur des licences incluent de nombreuses nouvelles fonctionnalités et sont disponibles pour tous les Fournisseur de solutions Cloud (CSP). Pour plus d’informations, consultez la Vue d’ensemble des nouvelles expériences commerciales.
Représente des instructions de renouvellement pour une disponibilité donnée.
| Propriété | Type | Description |
|---|---|---|
| renewToId | Chaîne | Représente le produit et la référence sku à renouveler vers |
| isAutoRenewable | Bool | Indique si la disponibilité peut être renouvelée automatiquement ou non |
Terme
Représente un terme pour lequel la disponibilité peut être achetée.
| Propriété | Type | Description |
|---|---|---|
| durée | Chaîne | Représentation ISO 8601 de la durée du terme. Les valeurs prises en charge actuelles sont P1M (un mois), P1Y (un an) et P3Y (trois ans). |
| description | Chaîne | Description du terme. |
InventoryCheckRequest
Représente une demande de vérification de l’inventaire sur certains éléments de catalogue.
| Propriété | Type | Description |
|---|---|---|
| targetItems | Tableau d’InventoryItem | Liste des éléments de catalogue évalués par la vérification de l’inventaire. |
| inventoryContext | Paires clé-valeur. | Dictionnaire des valeurs de contexte nécessaires pour effectuer les vérifications d’inventaire. Chaque référence SKU des produits définit les valeurs (le cas échéant) nécessaires pour effectuer cette opération. |
| liens | ResourceLinks | Liens de ressources contenus dans la demande de vérification de l’inventaire. |
InventoryItem
Représente un élément unique dans une opération de vérification d’inventaire. Cette ressource est utilisée pour spécifier les éléments cibles dans une demande d’entrée et est également utilisée pour représenter les résultats de sortie de l’opération de vérification de l’inventaire.
| Propriété | Type | Description |
|---|---|---|
| productId | Chaîne | (Obligatoire) ID du produit. |
| skuId | Chaîne | ID de la référence SKU. Lorsque vous utilisez cette ressource comme entrée à une demande d’inventaire, cette valeur est facultative. Si cette valeur n’est pas fournie, toutes les références SKU sous le produit sont considérées comme des éléments cibles de l’opération de vérification de l’inventaire. |
| isRestricted | Bool | Indique si cet élément a été trouvé pour avoir un inventaire restreint. |
| restrictions | Tableau d’InventoryRestriction | Détails des restrictions trouvées pour cet élément. Cette propriété ne sera remplie que si isRestricted = « true ». |
InventoryRestriction
Représente les détails d’une restriction d’inventaire. Ces détails s’appliquent uniquement aux résultats de sortie de vérification de l’inventaire, et non aux demandes d’entrée.
| Propriété | Type | Description |
|---|---|---|
| reasonCode | Chaîne | Code qui identifie la raison de la restriction. |
| description | Chaîne | Description de la restriction d’inventaire. |
| properties | Paires clé-valeur. | Dictionnaire de propriétés qui peuvent fournir des détails supplémentaires sur la restriction. |
BillingCycleType
[Enum/dotnet/api/system.enum) avec des valeurs qui indiquent un type de cycle de facturation.
| Valeur | Position | Description |
|---|---|---|
| Inconnu | 0 | Initialiseur d’énumération. |
| Mensuelle | 1 | Indique que le partenaire sera facturé mensuellement. |
| Annuelle | 2 | Indique que le partenaire sera facturé annuellement. |
| Aucune | 3 | Indique que le partenaire ne sera pas facturé. Cette valeur peut être utilisée pour les éléments d’évaluation. |
| OneTime | 4 | Indique que le partenaire sera facturé une seule fois. |
| Tous les trois ans | 5 | Indique que le partenaire sera facturé tous les trois ans. |
AttestationProperties
Représente un type d’attestation et s’il est requis pour l’achat.
| Propriété | Type | Description |
|---|---|---|
| attestationType | Chaîne | Indique le type d’attestation. Les produits Windows 365 ont la valeur de Windows 365. Le texte d’attestation Windows 365 est « Je comprends que chaque personne utilisant Windows 365 Affaires avec Avantage Windows hybride doit également avoir une copie valide de Windows 10/11 Pro installée sur son appareil professionnel principal . » |
| enforceAttestation | Boolean | Indique si l’attestation est requise pour l’achat. |