Центр партнеров Майкрософт [не рекомендуется]
Этот соединитель позволяет подключаться к API MPC и собирать некоторые сведения, включая сведения о клиентах, заказах и подписках.
Этот соединитель доступен в следующих продуктах и регионах:
| Услуга | 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 |
| Метаданные соединителя | |
|---|---|
| Publisher | Microsoft |
| Website | https://docs.microsoft.com/en-us/partner-center/develop/ |
| Политика конфиденциальности | https://privacy.microsoft.com/en-us/privacystatement |
| Категории | ИТ-операции; Управление бизнесом |
Создание подключения
Соединитель поддерживает следующие типы проверки подлинности:
| По умолчанию | Параметры для создания подключения. | Все регионы | Недоступен для совместного использования |
По умолчанию
Применимо: все регионы
Параметры для создания подключения.
Это недоступно для общего доступа. Если приложение power предоставляется другому пользователю, пользователю будет предложено явно создать новое подключение.
Ограничения регулирования
| Имя | Вызовы | Период обновления |
|---|---|---|
| Вызовы API для каждого подключения | 100 | 60 секунд |
Действия
| Получение всех клиентов (не рекомендуется) [DEPRECATED] |
Получение списка клиентов (не рекомендуется). |
| Получение заказов клиентов (не рекомендуется) [DEPRECATED] |
Возвращает коллекцию всех заказов для указанного клиента (не рекомендуется). |
| Получение подписок клиентов (не рекомендуется) [DEPRECATED] |
Возвращает коллекцию всех подписок для указанного клиента (не рекомендуется). |
| Получение сведений о клиенте (не рекомендуется) [DEPRECATED] |
Возвращает ресурс клиента, соответствующий идентификатору клиента (не рекомендуется). |
| Получение счетов (не рекомендуется) [DEPRECATED] |
Получение коллекции счетов (не рекомендуется). |
Получение всех клиентов (не рекомендуется) [DEPRECATED]
Получение списка клиентов (не рекомендуется).
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Size
|
Size | string |
Количество результатов, отображаемых одновременно. |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Общее число
|
totalCount | integer |
Общее количество элементов в коллекции |
|
items
|
items | array of object |
items |
|
Идентификатор
|
items.id | string |
Идентификатор клиента. |
|
Идентификатор арендатора
|
items.companyProfile.tenantId | string |
Идентификатор клиента для идентификатора Microsoft Entra. Это также называется MicrosoftID. |
|
Домен
|
items.companyProfile.domain | string |
Имя клиента, например contoso.onmicrosoft.com. |
|
Название компании
|
items.companyProfile.companyName | string |
Имя компании или организации. |
|
Связь с партнером
|
items.relationshipToPartner | string |
Определяет программу лицензирования, которую партнер использует для этого клиента: "none", "торговый посредник", "помощник", "синдикация" или "microsoft_support". |
Получение заказов клиентов (не рекомендуется) [DEPRECATED]
Возвращает коллекцию всех заказов для указанного клиента (не рекомендуется).
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор клиента
|
CustomerTenantID | True | string |
Идентификатор клиента. |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Общее число
|
totalCount | integer |
Общее количество заказов клиентов. |
|
items
|
items | array of object |
items |
|
Идентификатор
|
items.id | string |
Идентификатор заказа. |
|
Альтернативный идентификатор
|
items.alternateId | string |
Понятный идентификатор заказа. |
|
Идентификатор клиента
|
items.referenceCustomerId | string |
Идентификатор клиента. |
|
Цикл выставления счетов
|
items.billingCycle | string |
Указывает частоту выставления счетов партнером за этот заказ. |
|
Код Валюты
|
items.currencyCode | string |
Валюта, используемая при размещении заказа. |
|
Обозначение денежной единицы
|
items.currencySymbol | string |
Символ валюты, связанный с кодом валюты. |
|
lineItems
|
items.lineItems | array of object |
lineItems |
|
номер позиции
|
items.lineItems.lineItemNumber | integer |
Номер элемента строки. |
|
Идентификатор предложения
|
items.lineItems.offerId | string |
Идентификатор предложения. |
|
ID подписки
|
items.lineItems.subscriptionId | string |
Идентификатор подписки. |
|
Длительность термина
|
items.lineItems.termDuration | string |
Представление срока действия термина ISO 8601. |
|
Идентификатор промоушена
|
items.lineItems.promotionId | string |
Идентификатор промоушена. |
|
Настраиваемая дата окончания срока
|
items.lineItems.customTermEndDate | string |
Дата окончания первого срока выставления счетов новой подписки. |
|
Тип проводки
|
items.lineItems.transactionType | string |
Тип транзакции элемента строки. |
|
Дружественное имя
|
items.lineItems.friendlyName | string |
Партнер присваивает подписке дружественное имя, чтобы помочь разрешить неоднозначность. |
|
количество
|
items.lineItems.quantity | integer |
Количество |
|
Дата создания
|
items.creationDate | string |
Дата создания заказа в формате даты и времени. |
|
Состояние
|
items.status | string |
Состояние заказа. |
|
Тип проводки
|
items.transactionType | string |
Тип транзакции заказа. Поддерживаемые значения: UserPurchase, SystemPurchase или SystemBilling |
Получение подписок клиентов (не рекомендуется) [DEPRECATED]
Возвращает коллекцию всех подписок для указанного клиента (не рекомендуется).
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор клиента
|
CustomerTenantID | True | string |
Идентификатор клиента. |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Общее число
|
totalCount | integer |
Общее количество подписок для клиента. |
|
items
|
items | array of object |
items |
|
Идентификатор
|
items.id | string |
Идентификатор подписки. |
|
Идентификатор предложения
|
items.offerId | string |
Идентификатор предложения. |
|
Название предложения
|
items.offerName | string |
Имя предложения. |
|
Дружественное имя
|
items.friendlyName | string |
Партнер присваивает подписке дружественное имя, чтобы помочь разрешить неоднозначность. |
|
Идентификатор
|
items.productType.id | string |
Идентификатор подписки. |
|
Отображаемое имя
|
items.productType.displayName | string |
Отображаемое имя. |
|
Количество
|
items.quantity | integer |
Предоставляет количество подписок после подготовки. |
|
Тип единицы
|
items.unitType | string |
Единицы, определяющие количество для подписки. |
|
Имеет Purchasable Addons
|
items.hasPurchasableAddons | boolean |
Значение, указывающее, имеет ли подписка доступные надстройки. |
|
Дата создания
|
items.creationDate | string |
Дата создания в формате даты и времени. |
|
Дата начала действия
|
items.effectiveStartDate | string |
Действимая дата начала для этой подписки в формате даты и времени. |
|
Дата окончания обязательства
|
items.commitmentEndDate | string |
Дата окончания обязательства для этой подписки в формате даты и времени. |
|
Отмена разрешена до даты
|
items.cancellationAllowedUntilDate | string |
Последняя дата отмены. |
|
Дата окончания цикла выставления счетов
|
items.billingCycleEndDate | string |
Дата окончания цикла выставления счетов для этой подписки в формате даты и времени. |
|
Состояние
|
items.status | string |
Указывает состояние подготовки: "success", "pending" или "failed". |
|
Автоматическое продление
|
items.autoRenewEnabled | boolean |
autoRenewEnabled |
|
Пробная версия
|
items.isTrial | boolean |
Значение, указывающее, является ли подписка пробной версией. |
|
Тип выставления счетов
|
items.billingType | string |
Указывает, как взимается плата за подписку: "нет", "использование" или "лицензия". |
|
Цикл выставления счетов
|
items.billingCycle | string |
Указывает частоту выставления счетов партнером за этот заказ. |
|
Длительность термина
|
items.termDuration | string |
Представление срока действия термина ISO 8601. |
|
Длительность срока продления
|
items.renewalTermDuration | string |
Представление срока действия термина ISO 8601. |
|
Является продуктом Майкрософт
|
items.isMicrosoftProduct | boolean |
Значение, указывающее, является ли подписка продуктом Майкрософт. |
|
Partner ID
|
items.partnerId | string |
Идентификатор MPN торгового посредника записи, используемый в косвенной модели партнера. |
|
Необходимое внимание
|
items.attentionNeeded | boolean |
Требуется внимание. |
|
Тип контракта
|
items.contractType | string |
Тип контракта: "subscription", "productKey" или "redemptionCode". |
|
Имя издателя
|
items.publisherName | string |
Имя издателя. |
|
Идентификатор промоушена
|
items.promotionId | string |
Идентификатор повышения, если применяется к подписке. |
|
Идентификатор заказа
|
items.orderId | string |
Идентификатор заказа, размещенного для начала подписки. |
Получение сведений о клиенте (не рекомендуется) [DEPRECATED]
Возвращает ресурс клиента, соответствующий идентификатору клиента (не рекомендуется).
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Идентификатор клиента
|
CustomerTenantID | True | string |
Идентификатор клиента |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Идентификатор
|
id | string |
Идентификатор клиента. |
|
Идентификатор коммерции.
|
commerceId | string |
Идентификатор коммерции. |
|
Идентификатор арендатора
|
companyProfile.tenantId | string |
Идентификатор клиента для идентификатора Microsoft Entra. Это также называется MicrosoftID. |
|
Название компании (профиль компании).
|
companyProfile.companyName | string |
Имя компании или организации. |
|
Домен
|
companyProfile.domain | string |
Имя клиента, например contoso.onmicrosoft.com. |
|
Страна (профиль компании)
|
companyProfile.address.country | string |
Страна. |
|
Регион (профиль компании).
|
companyProfile.address.region | string |
Область. |
|
Город (профиль компании)
|
companyProfile.address.city | string |
Город. |
|
State (Корпоративный профиль)
|
companyProfile.address.state | string |
Государство. |
|
Адресная строка1 (профиль компании)
|
companyProfile.address.addressLine1 | string |
Первая строка адреса. |
|
Почтовый индекс (профиль компании)
|
companyProfile.address.postalCode | string |
Почтовый индекс или почтовый индекс. |
|
Номер телефона (профиль компании)
|
companyProfile.address.phoneNumber | string |
Номер телефона контакта в компании или организации клиента. |
|
Электронная почта (профиль компании)
|
companyProfile.email | string |
Отправить по электронной почте. |
|
ИД профиля
|
billingProfile.id | string |
Идентификатор профиля. |
|
Имя (профиль выставления счетов)
|
billingProfile.firstName | string |
Имя контакта по выставлению счетов в компании клиента. |
|
Фамилия (профиль выставления счетов)
|
billingProfile.lastName | string |
Фамилия контакта выставления счетов. |
|
Электронная почта (профиль выставления счетов)
|
billingProfile.email | string |
Адрес электронной почты контакта по выставлению счетов |
|
Язык и региональные параметры (профиль выставления счетов)
|
billingProfile.culture | string |
Их предпочитаемая культура для связи и валюты, например "en-us". |
|
Язык (профиль выставления счетов)
|
billingProfile.language | string |
Их предпочтительный язык для общения. |
|
Название компании (профиль выставления счетов)
|
billingProfile.companyName | string |
Имя компании или организации. |
|
Страна (профиль выставления счетов)
|
billingProfile.defaultAddress.country | string |
Страна или регион в формате кода страны ISO. |
|
Регион (профиль выставления счетов)
|
billingProfile.defaultAddress.region | string |
Область. |
|
Город (профиль выставления счетов)
|
billingProfile.defaultAddress.city | string |
Город. |
|
Состояние (профиль выставления счетов)
|
billingProfile.defaultAddress.state | string |
Государство. |
|
AddressLine1 (профиль выставления счетов)
|
billingProfile.defaultAddress.addressLine1 | string |
Первая строка адреса. |
|
Почтовый индекс (профиль выставления счетов)
|
billingProfile.defaultAddress.postalCode | string |
Почтовый индекс или почтовый индекс. |
|
Имя (профиль выставления счетов)
|
billingProfile.defaultAddress.firstName | string |
Первое имя контакта в компании или организации клиента. |
|
Фамилия (профиль выставления счетов)
|
billingProfile.defaultAddress.lastName | string |
Фамилия контакта в компании или организации клиента. |
|
Номер телефона (профиль выставления счетов)
|
billingProfile.defaultAddress.phoneNumber | string |
Номер телефона контакта в компании или организации клиента. |
|
Связь с партнером
|
relationshipToPartner | string |
Определяет программу лицензирования, которую партнер использует для этого клиента: "none", "торговый посредник", "помощник", "синдикация" или "microsoft_support". |
|
Разрешить делегированный доступ
|
allowDelegatedAccess | boolean |
Указывает, предоставлен ли партнеру делегированные права администратора этим клиентом. |
|
Пользовательские домены
|
customDomains | array of string |
Список пользовательских доменов клиента. |
Получение счетов (не рекомендуется) [DEPRECATED]
Получение коллекции счетов (не рекомендуется).
Параметры
| Имя | Ключ | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
Size
|
Size | integer |
Количество ресурсов счета, возвращаемых в ответе. Это необязательный параметр. |
|
|
Смещение
|
Offset | string |
Индекс первого счета, отсчитываемый от нуля, для возврата. |
Возвращаемое значение
| Имя | Путь | Тип | Описание |
|---|---|---|---|
|
Общее число
|
totalCount | integer |
Общее количество элементов в коллекции. |
|
items
|
items | array of object |
items |
|
Идентификатор
|
items.id | string |
Идентификатор счета. |
|
Дата счета
|
items.invoiceDate | string |
Дата создания счета. |
|
Дата начала периода биллинга
|
items.billingPeriodStartDate | string |
Дата начала периода выставления счетов в формате UTC. |
|
Дата окончания периода биллинга
|
items.billingPeriodEndDate | string |
Дата окончания периода выставления счетов в формате UTC. |
|
Общая плата
|
items.totalCharges | float |
Общая сумма расходов. Включает в себя расходы на транзакции и любые корректировки. |
|
Платная сумма
|
items.paidAmount | float |
Сумма, выплачиваемая партнером. Отрицательное значение, если платеж был получен. |
|
Код Валюты
|
items.currencyCode | string |
Код, указывающий валюту, используемую для всех сумм и итогов элементов счета. |
|
Обозначение денежной единицы
|
items.currencySymbol | string |
Символ валюты, используемый для всех сумм и итогов элементов счета. |
|
Ссылка на скачивание PDF
|
items.pdfDownloadLink | string |
Ссылка на скачивание счета в формате PDF. Эта ссылка не возвращается в рамках результатов поиска и заполняется только в том случае, если счет обращается по идентификатору. Срок действия этой ссылки истекает через 30 минут. |
|
invoiceDetails
|
items.invoiceDetails | array of object |
Сведения о счете. |
|
Тип элемента строки счета
|
items.invoiceDetails.invoiceLineItemType | string |
Тип сведений о счете: "none", "usage_line_items", "billing_line_items". |
|
Поставщик выставления счетов
|
items.invoiceDetails.billingProvider | string |
Поставщик выставления счетов: "none", "office", "azure" или "azure_data_market". |
|
Тип документа
|
items.documentType | string |
Тип документа счета: "Кредитная заметка", "Счет". |
|
Тип счета
|
items.invoiceType | string |
Тип счета: "повторяющийся", "one_time". |