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

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

Продукт

Представляет покупаемый товар или услугу. Сам по себе продукт не является продаваемым товаром.

Свойство	Тип	Описание
идентификатор	Струна	Идентификатор продукта.
заголовок	Струна	Название продукта.
описание	Струна	Описание продукта.
тип продукта	ТипЭлемента	Объект, описывающий классификации типов этого продукта.
isMicrosoftProduct	Булев	Указывает, является ли продукт продуктом Майкрософт.
ИмяИздателя	Струна	Имя издателя продукта, если оно доступно.
ссылки	СсылкиНаПродукт	Ссылки на ресурсы, содержащиеся в продукте.

Тип предмета

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

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

ProductLinks

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

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

Артикул

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

Свойство	Тип	Описание
идентификатор	Струна	Идентификатор номера SKU. Идентификатор является уникальным только в контексте родительского продукта.
заголовок	Струна	Название SKU.
описание	Струна	Описание номера SKU.
productId	Струна	Идентификатор родительского продукта , который содержит SKU.
минимальное количество	int	Минимальное количество, допустимое для покупки.
Максимальное количество	int	Максимальное количество, допустимое для покупки.
isTrial	Булев	Указывает, является ли SKU пробным элементом.
поддерживаемые платежные циклы	Массив строк	Список поддерживаемых циклов выставления счетов для номера SKU. Поддерживаемые значения — это имена элементов, найденные в BillingCycleType.
требования для покупки	Массив строк	Список необходимых шагов или действий, необходимых перед покупкой элемента. Поддерживаемые значения: "InventoryCheck" — указывает, что наличие товара на складе должно быть проверено перед попыткой его приобрести. "AzureSubscriptionRegistration" — указывает, что требуется подписка Azure и должна быть зарегистрирована перед попыткой приобрести элемент.
переменныеИнвентаризации	Массив строк	Список переменных, необходимых для выполнения проверки инвентаризации элемента. Поддерживаемые значения: CustomerId — идентификатор клиента, за который будет приобретена покупка. AzureSubscriptionId — идентификатор подписки Azure, используемой для приобретения резервации в Azure. "ArmRegionName" — регион, для которого требуется проверить инвентаризацию. Это значение должно соответствовать "ArmRegionName" в DynamicAttributes SKU.
Переменные настройки	Массив строк	Список переменных, которые должны быть указаны в контексте предоставления позиции в корзине , при покупке товара. Поддерживаемые значения: Область применения — параметр покупки резервирования Azure: "Индивидуальный", "Общий доступ". SubscriptionId — идентификатор подписки Azure, используемый для приобретения резервации в Azure. "Длительность" — длительность резервирования Azure: "1Year", "3Year".
dynamicAttributes	Пары "ключ-значение"	Словарь динамических свойств, применяемых к элементу. Свойства в словаре являются динамическими и могут изменяться без уведомления. Партнеры должны избегать создания выраженных зависимостей от определенных ключей, существующих в значении свойства.
ссылки	Ресурсные ссылки	Ссылки на ресурсы, содержащиеся в SKU.
Аттестация Свойства	Свойства аттестации	Свойства аттестации для единицы SKU.
тип потребления	Струна	Доступен только в том случае, если sku поддерживает потребление, например превышение.
ручная активация	Булев	Только SKU Marketplace. Если установлено значение false, выставление счетов начинается немедленно, вместо того чтобы ждать, пока ISV активирует службы в свойстве ISV.
специализированные свойства предложения	Список специализированных свойств предложения	Доступен только в том случае, если продукт является подтипом Специализированного предложения.
минимальное обязательство по покупке	МинимальноеОбязательствоПоПокупке	Фиксированная сумма, выделенная на вычислительные услуги.

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

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

Заметка

Новые коммерческие возможности для служб на основе лицензий включают множество новых возможностей и доступны для всех поставщиков облачных решений (CSPS). Дополнительные сведения см. в Обзор новых коммерческих возможностей.

Свойство	Тип	Описание
имеетОграничения	Булев	Описывает, содержит ли номер SKU assetContraints
этоДополнение	Булев	Описывает, является ли SKU дополнением
предварительный компонент <	массив строк	Описание продуктов и SKU, с которыми может работать дополнение.
обновитьЦелевыеПредложения	массив строк	Список продуктов и SKU, в которые можно обновить этот элемент.
инструкции преобразования	Список инструкций по преобразованию	Список инструкций, применимых для преобразования операций

специализированные свойства предложения

Заметка

Новые коммерческие возможности для служб на основе лицензий включают множество новых возможностей и доступны для всех поставщиков облачных решений (CSPS). Дополнительные сведения см. в Обзор новых коммерческих возможностей.

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

Свойство	Тип	Описание
дата начала	Струна	Идентификаторы терминов применимы к инструкциям
дата окончания	Струна	Параметры, определяющие продление
ценовая политика	Список политик ценообразования	Список политик, определяющих значения и типы промоциональных скидок.

Обязательства по минимальной покупке

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

Свойство	Тип	Описание
зерно	Струна	Период минимального обязательства на покупку.
код валюты	Строка словаря<, строка>	"«Валюта» и «символ» минимальной суммы, которую можно внести."
количество	int	Минимальная сумма, которую можно зафиксировать в вычислительных сервисах.

Политики ценообразования

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

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

Наличие

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

Свойство	Тип	Описание
идентификатор	Струна	Идентификатор этой доступности. Этот идентификатор является уникальным только в контексте родительского продукта и номера SKU. Учтите, что идентификаторы доступности могут изменяться с течением времени. Партнеры должны полагаться только на это значение в течение короткого промежутка времени после получения.
productId	Струна	Идентификатор продукта, содержащего эту доступность.
skuId	Струна	Идентификатор номера SKU , который содержит эту доступность.
ИдентификаторЭлементаКаталога	Струна	Уникальный идентификатор этого элемента в каталоге. Этот идентификатор должен быть заполнен свойствами OrderLineItem.OfferId или CartLineItem.CatalogItemId при приобретении родительского SKU. примечание этот идентификатор может измениться со временем. Вы должны полагаться только на это значение в течение короткого времени после получения. Доступ к нему должен использоваться только во время покупки.
валюта по умолчанию	Струна	Валюта по умолчанию, поддерживаемая для этой доступности.
сегмент	Струна	Сегмент отрасли для этой доступности. Поддерживаемые значения: коммерческие, образовательные, государственные, некоммерческие.
страна	Струна	Страна или регион (в формате кода страны ISO), где применяется эта доступность.
может быть приобретено	Булев	Указывает, является ли эта доступность доступной.
этоВозобновляемый	Булев	Указывает, можно ли возобновить этот доступ.
Инструкции по обновлению	Инструкция по обновлению	Представляет инструкции по продлению для заданной доступности.
продукт	Продукт	Продукт, к которому относится эта доступность.
SKU	SKU	SKU, которому соответствует эта доступность.
Условия	Массив ресурсов терминов	Коллекция терминов, применимых к этой доступности.
ссылки	Ресурсные ссылки	Ссылки на ресурсы, содержащиеся в списке доступных ресурсов.

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

Заметка

Новые коммерческие возможности для служб на основе лицензий включают множество новых возможностей и доступны для всех поставщиков облачных решений (CSPS). Дополнительные сведения см. в Обзор новых коммерческих возможностей.

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

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

Вариант обновления

Заметка

Новые коммерческие возможности для служб на основе лицензий включают множество новых возможностей и доступны для всех поставщиков облачных решений (CSPS). Дополнительные сведения см. в Обзор новых коммерческих возможностей.

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

Свойство	Тип	Описание
renewToId	Струна	Представляет продукт и SKU, которые необходимо обновить
являетсяАвтопродляемым	Булев	Возможность автоматического продления доступности

Срок

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

Свойство	Тип	Описание
длительность	Струна	Представление продолжительности термина в формате ISO 8601. Текущие поддерживаемые значения: P1M (один месяц), P1Y (один год) и P3Y (три года).
описание	Струна	Описание термина.
termLifeCycleState	Струна	Описание жизненного цикла. К этим значениям относятся GA (общедоступный), EndOfSale и EndofSaleWithConversions. Это свойство возвращается только в том случае, если при вызове API для получения доступности по идентификатору параметр includeLifeCycleState установлен в значение true.

Запрос на проверку инвентаря

Означает запрос на проверку запасов определённых товаров каталога.

Свойство	Тип	Описание
целевые элементы	Массив InventoryItem	Список элементов каталога, которые проверяет проверка инвентаризации.
контекст инвентаризации	Пары ключ/значение	Словарь значений контекста, необходимых для выполнения проверок инвентаризации. Каждый номер SKU продуктов определяет, какие значения (при наличии) необходимы для выполнения этой операции.
ссылки	Ресурсные ссылки	Ссылки на ресурсы, содержащиеся в запросе проверки инвентаризации.

Элемент инвентаря

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

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

ОграничениеИнвентаря

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

Свойство	Тип	Описание
код причины	Струна	Код, определяющий причину ограничения.
описание	Струна	Описание ограничения инвентаризации.
свойства	Пары ключ/значение	Словарь свойств, которые могут предоставлять дополнительные сведения об ограничении.

Тип цикла выставления счетов

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

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

Аттестация Свойства

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

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