Dynamics 365 Commerce Merchandising [DEPRECATED]
Соединитель предоставляет действия для поиска и просмотра связанных с продуктом сведений, таких как каталоги, инвентаризация, цена и рекомендации. Соединитель подключается к единице масштабирования облака коммерции (CSU) в качестве оболочки для предоставления API-интерфейсов для безголовой коммерции в упрощенном и простом способе, чтобы предприятия могли легко использовать и создавать коммерческие приложения.
Этот соединитель доступен в следующих продуктах и регионах:
| Услуга | Class | Регионы |
|---|---|---|
| Copilot Studio | Премия | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Логические приложения | Стандарт | Все регионы Logic Apps , кроме следующих: — Регионы Azure для государственных организаций — Регионы Azure Для Китая - Министерство обороны США (DoD) |
| Power Apps | Премия | Все регионы Power Apps , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Power Automate | Премия | Все регионы Power Automate , кроме следующих: - Правительство США (GCC) - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD) |
| Контакт | |
|---|---|
| Имя | Microsoft |
| URL | https://support.microsoft.com/ |
| Адрес электронной почты | abapi@microsoft.com |
| Метаданные соединителя | |
|---|---|
| Publisher | Microsoft |
| Веб-сайт | https://dynamics.microsoft.com/en-us/commerce/overview/ |
| Политика конфиденциальности | https://privacy.microsoft.com/en-us/privacystatement |
| Дополнительные термины | https://go.microsoft.com/fwlink/?linkid=2105274 |
| Категории | Торговля; Финансировать |
Создание подключения
Соединитель поддерживает следующие типы проверки подлинности:
| По умолчанию | Параметры для создания подключения. | Все регионы | Недоступен для совместного использования |
По умолчанию
Применимо: все регионы
Параметры для создания подключения.
Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.
| Имя | Тип | Description | Обязательно |
|---|---|---|---|
| URL-адрес розничного сервера | струна | URL-адрес розничного сервера | True |
| URL-адрес базы мультимедиа с расширенными возможностями | струна | URL-адрес, используемый в случае неправильно настроенного профиля или сервера мультимедиа канала. Ожидается, что он будет иметь форму https://.../imageFileData/search?fileName= ". |
Ограничения регулирования
| Имя | Вызовы | Период обновления |
|---|---|---|
| Вызовы API для каждого подключения | 100 | 60 секунд |
Действия
| Get Product variant (не рекомендуется) [DEPRECATED] |
Поиск вариантов продукта по измерениям (не рекомендуется). |
| Получение атрибутов продукта (не рекомендуется) [DEPRECATED] |
Получение атрибутов продукта (не рекомендуется). |
| Получение значений измерения (не рекомендуется) [DEPRECATED] |
Значения измерения с доступностью инвентаризации для продукта на основе указанных требований (не рекомендуется). |
| Получение инвентаризации продуктов (не рекомендуется) [DEPRECATED] |
Получение инвентаризации продуктов в магазинах (не рекомендуется). |
| Получение каналов (не рекомендуется) [DEPRECATED] |
Получение каналов (не рекомендуется). |
| Получение каталогов (не рекомендуется) [DEPRECATED] |
Получение каталогов (не рекомендуется). |
| Получение категорий (не рекомендуется) [DEPRECATED] |
Получение категорий (не рекомендуется). |
| Получение конфигурации среды (не рекомендуется) [DEPRECATED] |
Получите конфигурацию среды (не рекомендуется). |
| Получение продуктов по идентификаторам (не рекомендуется) [DEPRECATED] |
Поиск по продуктам по идентификаторам (не рекомендуется). |
| Получение расположений изображений продукта (не рекомендуется) [DEPRECATED] |
Получение расположений изображений продукта (не рекомендуется). |
| Получение рекомендуемых продуктов (не рекомендуется) [DEPRECATED] |
Коллекция рекомендаций по продукту с коллекцией идентификаторов продуктов (не рекомендуется). |
| Проверка работоспособности (не рекомендуется) [DEPRECATED] |
Проверка работоспособности розничного сервера (не рекомендуется). |
| Продукты поиска (не рекомендуется) [DEPRECATED] |
Поиск продукта по ключевым словам и категориям (не рекомендуется). |
Get Product variant (не рекомендуется) [DEPRECATED]
Поиск вариантов продукта по измерениям (не рекомендуется).
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Код продукта
|
ProductId | True | integer |
Идентификатор главного продукта. |
|
Активная дата
|
ActiveDate | date-time |
Дата, для которую требуется цена. |
|
|
Идентификатор типа
|
TypeId | True | integer |
Идентификатор типа. |
|
Ценность
|
Value | True | string |
Значение измерения. |
|
Идентификатор каталога
|
CatalogId | integer |
Идентификатор каталога для канала. Значение по умолчанию равно нулю. |
|
|
Channel
|
ChannelId | True | integer |
Идентификатор канала. |
|
Идентификатор языка
|
LanguageId | string |
Идентификатор языка. По умолчанию он будет языком канала. |
Возвращаемое значение
Представляет экземпляр продукта
- Тело
- Product
Получение атрибутов продукта (не рекомендуется) [DEPRECATED]
Получение атрибутов продукта (не рекомендуется).
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Код продукта
|
ProductId | True | integer |
Идентификатор продукта. |
|
Идентификатор каталога
|
CatalogId | integer |
Идентификатор каталога для канала. Значение по умолчанию равно нулю. |
|
|
Channel
|
ChannelId | True | integer |
Идентификатор канала. |
|
Идентификатор языка
|
LanguageId | string |
Идентификатор языка. По умолчанию он будет языком канала. |
Возвращаемое значение
- response
- array of Attribute
Получение значений измерения (не рекомендуется) [DEPRECATED]
Значения измерения с доступностью инвентаризации для продукта на основе указанных требований (не рекомендуется).
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Код продукта
|
ProductId | True | integer |
Идентификатор продукта, значения измерения которого необходимо извлечь. |
|
Channel
|
ChannelId | True | integer |
Идентификатор канала. |
|
Идентификатор языка
|
LanguageId | string |
Идентификатор языка. По умолчанию он будет языком канала. |
Возвращаемое значение
- response
- array of Dimension
Получение инвентаризации продуктов (не рекомендуется) [DEPRECATED]
Получение инвентаризации продуктов в магазинах (не рекомендуется).
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификаторы продуктов
|
ProductIds | True | array of integer |
Идентификаторы продуктов. |
|
Долгота
|
Longitude | double |
Долгота. Значение должно быть от -15069 до 15069 градусов включительно. |
|
|
Широта
|
Latitude | double |
Широта. Значение должно быть от -90 до 90 градусов включительно. |
|
|
Радиус.
|
Radius | double |
Радиус. Значение должно быть не отрицательным. |
|
|
Единица измерения радиуса
|
RadiusUnitOfMeasure | string |
Метрики радиуса, такие как Мили или километров. Значение по умолчанию основано на конфигурации канала. |
|
|
Channel
|
ChannelId | True | integer |
Идентификатор канала. |
|
Идентификатор языка
|
LanguageId | string |
Идентификатор языка. По умолчанию он будет языком канала. |
Возвращаемое значение
- response
- array of ProductInventory
Получение каналов (не рекомендуется) [DEPRECATED]
Получение каталогов (не рекомендуется) [DEPRECATED]
Получение каталогов (не рекомендуется).
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Channel
|
ChannelId | True | integer |
Идентификатор канала. |
|
Идентификатор языка
|
LanguageId | string |
Идентификатор языка. По умолчанию он будет языком канала. |
Возвращаемое значение
- response
- array of Catalog
Получение категорий (не рекомендуется) [DEPRECATED]
Получение категорий (не рекомендуется).
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор каталога
|
CatalogId | integer |
Идентификатор каталога для канала. Значение по умолчанию равно нулю. |
|
|
Channel
|
ChannelId | True | integer |
Идентификатор канала. |
|
Идентификатор языка
|
LanguageId | string |
Идентификатор языка. По умолчанию он будет языком канала. |
Возвращаемое значение
- response
- array of Category
Получение конфигурации среды (не рекомендуется) [DEPRECATED]
Получите конфигурацию среды (не рекомендуется).
Возвращаемое значение
Класс сущности EnvironmentConfiguration.
Получение продуктов по идентификаторам (не рекомендуется) [DEPRECATED]
Поиск по продуктам по идентификаторам (не рекомендуется).
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификаторы продуктов
|
ProductIds | True | array of integer |
Идентификаторы продуктов. |
|
Пропуск расширения вариантов
|
SkipVariantExpansion | boolean |
Возвращает варианты в результатах поиска, если задано значение false, true возвращает только главный продукт. |
|
|
Активная дата
|
ActiveDate | date-time |
Дата, для которую требуется цена. |
|
|
Идентификатор каталога
|
CatalogId | integer |
Идентификатор каталога для канала. Значение по умолчанию равно нулю. |
|
|
Channel
|
ChannelId | True | integer |
Идентификатор канала. |
|
Идентификатор языка
|
LanguageId | string |
Идентификатор языка. По умолчанию он будет языком канала. |
Возвращаемое значение
- response
- array of Product
Получение расположений изображений продукта (не рекомендуется) [DEPRECATED]
Получение расположений изображений продукта (не рекомендуется).
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Код продукта
|
ProductId | True | integer |
Идентификатор продукта. |
|
Идентификатор каталога
|
CatalogId | integer |
Идентификатор каталога для канала. Значение по умолчанию равно нулю. |
|
|
Channel
|
ChannelId | True | integer |
Идентификатор канала. |
|
Идентификатор языка
|
LanguageId | string |
Идентификатор языка. По умолчанию он будет языком канала. |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
|
array of string |
Получение рекомендуемых продуктов (не рекомендуется) [DEPRECATED]
Коллекция рекомендаций по продукту с коллекцией идентификаторов продуктов (не рекомендуется).
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор клиента
|
CustomerId | string |
Номер учетной записи клиента. |
|
|
Идентификаторы продуктов
|
ProductIds | True | array of integer |
Идентификаторы продукта, используемые для получения рекомендаций по продукту. |
|
Активная дата
|
ActiveDate | date-time |
Дата, для которую требуется цена. |
|
|
Идентификатор каталога
|
CatalogId | integer |
Идентификатор каталога для канала. Значение по умолчанию равно нулю. |
|
|
Channel
|
ChannelId | True | integer |
Идентификатор канала. |
|
Идентификатор языка
|
LanguageId | string |
Идентификатор языка. По умолчанию он будет языком канала. |
Возвращаемое значение
- response
- array of Product
Проверка работоспособности (не рекомендуется) [DEPRECATED]
Проверка работоспособности розничного сервера (не рекомендуется).
Возвращаемое значение
- response
- array of HealthCheckResult
Продукты поиска (не рекомендуется) [DEPRECATED]
Поиск продукта по ключевым словам и категориям (не рекомендуется).
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Keyword
|
Keyword | string |
Текст поиска продукта. |
|
|
Пропуск расширения вариантов
|
SkipVariantExpansion | boolean |
Возвращает варианты в результатах поиска, если задано значение false, true возвращает только главный продукт. |
|
|
Идентификатор категории
|
CategoryId | integer |
Идентификатор категории. |
|
|
Активная дата
|
ActiveDate | date-time |
Дата, для которую требуется цена. |
|
|
Идентификатор каталога
|
CatalogId | integer |
Идентификатор каталога для канала. Значение по умолчанию равно нулю. |
|
|
Channel
|
ChannelId | True | integer |
Идентификатор канала. |
|
Идентификатор языка
|
LanguageId | string |
Идентификатор языка. По умолчанию он будет языком канала. |
Возвращаемое значение
- response
- array of Product
Определения
Catalog
Представляет экземпляр каталога
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор
|
Id | integer |
Идентификатор. |
|
Имя
|
Name | string |
Имя. |
|
Description
|
Description | string |
Описание. |
|
ImageUrl
|
ImageUrl | string |
URL-адрес изображения. |
|
Срок действия
|
ExpiryDate | date-time |
Дата окончания срока действия. |
Категория
Представляет экземпляр категории
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор
|
Id | integer |
Идентификатор. |
|
Имя
|
Name | string |
Имя. |
|
ImageUrl
|
ImageUrl | string |
URL-адрес изображения. |
|
ParentId
|
ParentId | integer |
Идентификатор родительской категории. |
EnvironmentConfiguration
Класс сущности EnvironmentConfiguration.
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
EnvironmentId
|
EnvironmentId | string |
Возвращает или задает Идентификатор среды. |
|
Имя среды
|
EnvironmentName | string |
Возвращает или задает имя среды. |
|
Идентификатор арендатора (TenantId)
|
TenantId | string |
Возвращает или задает Идентификатор клиента. |
|
ClientAppInsightsInstrumentationKey
|
ClientAppInsightsInstrumentationKey | string |
Возвращает или задает clientAppInsightsInstrumentationKey. |
|
HardwareStationAppInsightsInstrumentationKey
|
HardwareStationAppInsightsInstrumentationKey | string |
Возвращает или задает ключ HardwareStationAppInsightsInstrumentationKey. |
|
WindowsPhonePosAppInsightsInstrumentationKey
|
WindowsPhonePosAppInsightsInstrumentationKey | string |
Возвращает или задает windowsPhonePosAppInsightsInstrumentationKey. |
|
BaseVersion
|
BaseVersion | string |
Возвращает или задает BaseVersion. |
|
ScaleUnit
|
ScaleUnit | ScaleUnitConfiguration |
Класс сущности ScaleUnitConfiguration. |
|
AADAuthority
|
AADAuthority | string |
Возвращает или задает AADAuthority. |
|
FrameworkName
|
FrameworkName | string |
Возвращает или задает Имя платформы. |
ScaleUnitConfiguration (Конфигурация ScaleUnit)
Класс сущности ScaleUnitConfiguration.
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор
|
Id | string |
Получает или задает идентификатор. |
|
Имя
|
Name | string |
Возвращает или задает имя. |
|
Регион
|
Region | string |
Возвращает или задает регион. |
Channel
Представляет экземпляр канала
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор
|
Id | integer |
Идентификатор. |
|
Имя
|
Name | string |
Имя. |
|
OperatingUnitNumber
|
OperatingUnitNumber | string |
Номер операционной единицы. |
|
Отображаемое имя
|
DisplayName | string |
Отображаемое имя. |
HealthCheckResult
Результат HealthCheck
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Имя
|
Name | string |
Имя проверки. |
|
Result
|
Result | string |
Результат. |
Свойство
Представляет экземпляр атрибута
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор
|
Id | integer |
Идентификатор. |
|
Имя
|
Name | string |
Имя. |
|
Ценность
|
Value | string |
Значение. |
ProductInventory
Представляет экземпляр инвентаризации продуктов
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
ИД продукта
|
ProductId | integer |
Идентификатор продукта. |
|
TotalAvailableQuantity
|
TotalAvailableQuantity | double |
Общее доступное количество. |
|
OrgUnitNumber
|
OrgUnitNumber | string |
Идентификатор расположения. |
|
OrgUnitName
|
OrgUnitName | string |
Имя расположения. |
|
Address
|
Address | string |
Адрес. |
|
FormattedStoreHours
|
FormattedStoreHours | string |
Форматированные часы хранения. |
|
Расстояние
|
Distance | double |
Расстояние. |
Продукт
Представляет экземпляр продукта
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор
|
Id | integer |
Идентификатор записи. |
|
ItemId
|
ItemId | string |
Идентификатор элемента. |
|
Имя
|
Name | string |
Имя продукта. |
|
Description
|
Description | string |
Описание продукта. |
|
PrimaryImageUrl
|
PrimaryImageUrl | string |
URL-адрес основного образа. |
|
Единица измерения
|
UnitOfMeasure | string |
Единица измерения по умолчанию, настроенная для продукта. |
|
Цена
|
Price | double |
Цена. |
|
StrikePrice
|
StrikePrice | double |
Забавная цена. |
|
MinMaxPrice
|
MinMaxPrice | string |
Ценовой диапазон для продукта. |
|
Код валюты
|
CurrencyCode | string |
Код валюты. |
|
FormattedPrice
|
FormattedPrice | string |
Отформатированная цена. |
|
Скидка
|
Discount | double |
Скидка на продукт. |
Размерность
Представляет экземпляр измерения
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
TypeId
|
TypeId | integer |
Идентификатор типа. |
|
ТипИмя
|
TypeName | string |
Имя типа. |
|
Ценности
|
Values | array of DimensionValue |
Коллекция значений измерения. |
DimensionValue
Представляет экземпляр DimensionValue
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
DimensionId
|
DimensionId | string |
Идентификатор. |
|
Ценность
|
Value | string |
Значение. |
|
Description
|
Description | string |
Описание. |
|
ProductIds
|
ProductIds | array of integer |
Коллекция идентификаторов продуктов. |