Поделиться через

Ресурсы продуктов

  • Статья

Ресурсы, представляющие выкупаемые товары или услуги. Включает ресурсы для описания типа продукта и фигуры (SKU) и проверки доступности продукта в инвентаризации.

Продукт

Представляет благо или обслуживание. Продукт сам по себе не является purchasable элементом.

Свойство Type Описание
id Строка Идентификатор продукта.
title Строка Название продукта.
описание Строка Описание продукта.
productType ItemType Объект, описывающий категории типов этого продукта.
isMicrosoftProduct Bool Указывает, является ли продукт продуктом Майкрософт.
publisherName Строка Имя издателя продукта, если оно доступно.
ссылки ProductLinks Ссылки на ресурсы, содержащиеся в продукте.

ItemType

Представляет тип продукта.

Свойство Type Описание
id Строка Идентификатор типа.
displayName Строка Отображаемое имя типа элемента.
subType ItemType Необязательно. Объект, описывающий классификацию подтипов для типа элемента.

Содержит список ссылок для продукта.

Свойство Type Описание
skus Ссылка Ссылка для доступа к базовым номерам SKU.
ссылки ResourceLinks Ссылки на ресурсы, содержащиеся в ресурсе.

Sku

Представляет purchasable Stock Keeping Unit (SKU) под продуктом.

Свойство Type Описание
id Строка Идентификатор номера SKU. Идентификатор является уникальным только в контексте родительского продукта.
title Строка Заголовок номера SKU.
описание Строка Описание номера SKU.
productId Строка Идентификатор родительского продукта , содержащего номер SKU.
minimumQuantity Int Минимальное количество, допустимое для покупки.
maximumQuantity Int Максимальное количество, допустимое для покупки.
isTrial Bool Указывает, является ли SKU пробным элементом.
supportedBillingCycles Массив строк Список поддерживаемых период выставления счетов для номера SKU. Поддерживаемые значения: имена участников в BillingCycleType.
purchasePrerequisites Массив строк Список необходимых шагов или действий, необходимых перед покупкой элемента. Поддерживаются такие значения:
"InventoryCheck" — указывает, что инвентаризация элемента должна быть оценена перед попыткой приобрести элемент.
"AzureSubscriptionRegistration" — указывает, что требуется подписка Azure и должна быть зарегистрирована перед попыткой приобрести элемент.
inventoryVariables Массив строк Список переменных, необходимых для выполнения проверки инвентаризации элемента. Поддерживаются такие значения:
CustomerId — идентификатор клиента, за который будет приобретена покупка.
AzureSubscriptionId — идентификатор подписки Azure, которая будет использоваться для покупки резервирования Azure.
ArmRegionName — регион, для которого необходимо проверить инвентаризацию. Это значение должно соответствовать параметру ArmRegionName из DynamicAttributes номера SKU.
provisioningVariables Массив строк Список переменных, которые должны быть предоставлены в контекст подготовки элемента строки корзины при покупке элемента. Поддерживаются такие значения:
Область — область покупки резервирования Azure: "Один", "Общий".
SubscriptionId — идентификатор подписки Azure, которая будет использоваться для покупки резервирования Azure.
"Длительность" — длительность резервирования Azure: "1Year", "3Year".
dynamicAttributes Пары "ключ-значение" Словарь динамических свойств, применяемых к элементу. Свойства в словаре являются динамическими и могут изменяться без уведомления. Партнеры должны избегать создания сильных зависимостей от определенных ключей, существующих в значении свойства.
ссылки ResourceLinks Ссылки на ресурсы, содержащиеся в номере SKU.
АттестацияProperties АттестацияProperties Свойства аттестации для номера SKU.
consumptionType Строка Доступен только в том случае, если sku поддерживает потребление, например избыточность.
специализированныеofferProperTies Список специализированныхOfferProperTies Доступен только в том случае, если продукт является подтипом СпециализированногоOffer.
minimumPurchaseCommitment MinimumPurchaseCommitment Фиксированный объем, зафиксированный в службах вычислений.

Атрибуты динамического SKU

Важные свойства, относящиеся к новым продуктам и службам на основе лицензий.

Примечание.

Новые возможности коммерческой торговли для служб на основе лицензий включают множество новых возможностей и доступны для всех поставщик облачных решений (ПОСТАВЩИКОВ УСЛУГ). Дополнительные сведения см . в обзоре новых коммерческих возможностей.

Свойство Type Описание
hasConstraints Логический Описывает, содержит ли номер SKU assetContraints
isAddon Логический Описывает, является ли номер SKU надстройкой
предварительный компонент < массив строк Описание продуктов и номеров sus, с которыми может работать надстройка
upgradeTargetOffers массив строк Список продуктов и номеров SKU, которые элемент может обновить до
преобразованиеInstructions Список преобразованийInstructions Список инструкций, применимых для преобразования операций

специализированныеofferProperTies

Примечание.

Новые возможности коммерческой торговли для служб на основе лицензий включают множество новых возможностей и доступны для всех поставщик облачных решений (ПОСТАВЩИКОВ УСЛУГ). Дополнительные сведения см . в обзоре новых коммерческих возможностей.

Применимо только для подтипов продукта "Специализированныеoffers"

Свойство Type Описание
startDate Строка Идентификаторы терминов применимы к инструкциям
endDate Строка Параметры, определяющие продление
pricingPolicies Список цен наPolicies Список политик, определяющих типы и значения скидок на повышение.

MinimumPurchaseCommitment

Атрибуты минимального количества, которое может быть зафиксировано в службах вычислений.

Свойство Type Описание
зерно Строка Период минимального обязательства на покупку.
currencyCode Строка словаря<, строка> Значение "валюта" и "символ" минимальной суммы, которую можно зафиксировать.
amount Int Минимальная сумма, которую можно зафиксировать в службах вычислений.

ЦенообразованиеPolicies

Описать типы и значения скидок на повышение.

Свойство Type Описание
type Строка Опишите, основана ли скидка на процентные или плоские скидки.
значение Строка Определяет сумму примененной скидки.

Availability

Представляет конфигурацию, в которой номер SKU доступен для покупки (например, страна или регион, валюта и отраслевый сегмент).

Свойство Type Описание
id Строка Идентификатор этой доступности. Этот идентификатор является уникальным только в контексте родительского продукта и номера SKU. Идентификаторы доступности заметок могут меняться с течением времени. Партнеры должны полагаться только на это значение в течение короткого промежутка времени после получения.
productId Строка Идентификатор продукта , содержащего эту доступность.
skuId Строка Идентификатор номера SKU , содержащего эту доступность.
catalogItemId Строка Уникальный идентификатор этого элемента в каталоге. Этот идентификатор должен быть заполнен свойствами OrderLineItem.OfferId или CartLineItem.CatalogItemId при покупке родительского номера SKU. Обратите внимание, что этот идентификатор может изменяться со временем. Вы должны полагаться только на это значение в течение короткого времени после получения. Доступ к нему должен использоваться только во время покупки.
DefaultCurrency Строка Валюта по умолчанию, поддерживаемая для этой доступности.
сегмент Строка Сегмент отрасли для этой доступности. Поддерживаемые значения: коммерческая, образование, правительство, nonProfit.
country Строка Страна или регион (в формате кода страны ISO), где применяется эта доступность.
isPurchasable Bool Указывает, является ли эта доступность доступной.
isRenewable Bool Указывает, является ли эта доступность возобновляемым.
Возобновление инструкций ОбновлениеInstruction Представляет инструкции по продлению для заданной доступности.
продукт Продукт Продукт, соответствующий этой доступности.
sku SKU Номер SKU этой доступности соответствует.
условия Массив ресурсов терминов Коллекция терминов, применимых к этой доступности.
ссылки ResourceLinks Ссылки на ресурсы, содержащиеся в доступности.

Инструкция по продлению

Примечание.

Новые возможности коммерческой торговли для служб на основе лицензий включают множество новых возможностей и доступны для всех поставщик облачных решений (ПОСТАВЩИКОВ УСЛУГ). Дополнительные сведения см . в обзоре новых коммерческих возможностей.

Представляет инструкции по продлению для заданной доступности.

Свойство Type Описание
applicableTermIds Массив строк Идентификаторы терминов применимы к инструкциям
ОбновлениеOptions Массив ОбновленияOption Параметры, определяющие продление

ОбновлениеOption

Примечание.

Новые возможности коммерческой торговли для служб на основе лицензий включают множество новых возможностей и доступны для всех поставщик облачных решений (ПОСТАВЩИКОВ УСЛУГ). Дополнительные сведения см . в обзоре новых коммерческих возможностей.

Представляет инструкции по продлению для заданной доступности.

Свойство Type Описание
renewToId Строка Представляет продукт и номер SKU для возобновления
isAutoRenewable Bool Возможность автоматического продления доступности

Термин

Представляет термин, для которого можно приобрести доступность.

Свойство Type Описание
duration Строка Представление срока действия термина ISO 8601. Текущие поддерживаемые значения: P1M (один месяц), P1Y (один год) и P3Y (три года).
описание Строка Описание термина.

InventoryCheckRequest

Представляет запрос на проверку инвентаризации определенных элементов каталога.

Свойство Type Описание
targetItems Массив InventoryItem Список элементов каталога, которые будет оценивать проверка инвентаризации.
inventoryContext пары "ключ-значение"; Словарь значений контекста, необходимых для выполнения проверки инвентаризации. Каждый номер SKU продуктов определяет, какие значения (если таковые имеются) необходимы для выполнения этой операции.
ссылки ResourceLinks Ссылки на ресурсы, содержащиеся в запросе проверки инвентаризации.

InventoryItem

Представляет один элемент в операции проверки инвентаризации. Этот ресурс используется для указания целевых элементов во входном запросе, а также используется для представления выходных результатов операции проверки инвентаризации.

Свойство Type Описание
productId Строка (обязательно) Идентификатор продукта.
skuId Строка Идентификатор номера SKU. При использовании этого ресурса в качестве входных данных для запроса инвентаризации это значение является необязательным. Если это значение не указано, все номера SKU под продуктом будут считаться целевыми элементами операции проверки инвентаризации.
isRestricted Bool Указывает, был ли найден этот элемент ограниченным инвентаризацией.
ограничения Массив inventoryRestriction Сведения о любых ограничениях, найденных для этого элемента. Это свойство будет заполнено только в том случае, если isRestricted = true.

InventoryRestriction

Представляет сведения об ограничении инвентаризации. Эти сведения применимы только для результатов проверки инвентаризации, а не для входных запросов.

Свойство Type Описание
reasonCode Строка Код, определяющий причину ограничения.
описание Строка Описание ограничения инвентаризации.
свойства пары "ключ-значение"; Словарь свойств, которые могут предоставлять дополнительные сведения об ограничении.

BillingCycleType

[Enum/dotnet/api/system.enum) со значениями, указывающими тип период выставления счетов.

Значение Position Description
Неизвестно 0 Инициализатор перечисления.
Месяц 1 Указывает, что партнер будет взиматься ежемесячно.
Ежегодный 2 Указывает, что партнер будет взиматься ежегодно.
нет 3 Указывает, что партнер не будет взиматься. Это значение можно использовать для пробных элементов.
OneTime 4 Указывает, что партнер будет взиматься один раз.
Трехлетие 5 Указывает, что партнер будет взиматься каждые три года.

АттестацияProperties

Представляет тип аттестации и, если он необходим для покупки.

Свойство Type Описание
аттестацияType Строка Указывает тип аттестации. Продукты Windows 365 будут иметь значение Windows 365. Текст аттестации Windows 365 — "Я понимаю, что каждый пользователь, использующий Windows 365 для бизнеса с Преимущество гибридного использования Windows также должен иметь действительную копию Windows 10/11 Pro на основном рабочем устройстве".
enforceAttestation Логический Указывает, требуется ли аттестация для покупки.