Заметки о выпуске пакета SDK для .NET

  • Статья

Следующие заметки о выпуске доступны для новых версий пакета SDK Для Microsoft Partner Center .NET. Примеры пакета SDK для .NET можно найти на сайте GitHub. Справочник по API .NET Центра партнеров можно найти в браузере API .NET.

Важно!

По состоянию на июнь 2023 г. последняя версия пакета SDK для .NET для Центра партнеров 3.4.0 теперь архивируется. Вы можете скачать выпуск пакета SDK из GitHub вместе с файлом чтения, содержащим полезные сведения.

Партнерам рекомендуется продолжать использовать REST API Центра партнеров.

Версия 3.4.0

Пакет SDK microsoft Partner Center .NET версии 3.4.0 теперь доступен. Также доступны обновленные примеры на сайте GitHub.

Эта версия включает следующие изменения:

Транзакция и управление ими

Следующие API обновляются для предоставления свойств времени окончания срока.

Pricing object теперь присутствует в следующем ответе API:

Акции

Предоставление ограничений:

Версия 3.3.0

Пакет SDK для .NET для Microsoft Partner Center версии 3.3.0 теперь доступен. Также доступны обновленные примеры на сайте GitHub.

Эта версия включает следующие изменения:

Транзакция и управление ими

Следующие API обновляются, чтобы включить отмену подписки Azure, если клиент скомпрометирован (мошенничество):

"OperationId" теперь присутствует в следующих ответах API:

Новые сообщения об ошибках GDAP:

Аудит

Для следующих компонентов добавлен новый тип ресурса AzureEntitlement и DirectProviderIndirectResellerDap:

Версия 3.2.0

Microsoft Partner Center .NET SDK версии 3.2.0 теперь является общедоступной. Также доступны обновленные примеры на сайте GitHub.

Эта версия включает следующие изменения:

Чтобы использовать пакет SDK для .NET версии 3.2.0, партнеры должны иметь Newtonsoft.Json 13.0.1 и более поздних версий. Так как версии до версии 13.0.1 имеют высокий уровень уязвимостей.

Новые контракты API

Ниже приведены API для поддержки расписания миграции NCE:

Обновления контракт API

Версия 3.1.2

Microsoft Partner Center .NET SDK версии 3.1.2 теперь является общедоступной. Также доступны обновленные примеры на сайте GitHub. Эта версия включает следующие изменения:

Обновления общедоступному контракту

Добавлено AddOnMigrations поле в NewCommerceEligibility объект
Проверка подписки для миграции

Версия 3.1.1

Важно!

Версия 3.1.0 не рекомендуется к использованию. Не скачивайте пакет SDK для .NET версии 3.1.0

Пакет SDK microsoft Partner Center .NET версии 3.1.1 теперь является общим. Также доступны обновленные примеры на сайте GitHub. Эта версия включает следующие изменения:

Транзакция и управление ими

Новое поле в общедоступном контракте

Добавление идентификатора повышения в запланированное изменение
Управление запланированными изменениями для новых коммерческих подписок

  • Patch {baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}

Новая поддержка пакета SDK для значения состояния подписки "отключена".

API Центра партнеров начнут возвращать новые состояния "отключено" через 90 дней после выпуска пакета SDK версии 3.1.1. Партнеры имеют 90 дней до того, как API возвращает состояние "отключено", чтобы дать им время обновить свои пакеты SDK и соблюдать принципы управления изменениями.

Новые Обновления API

Перенос подписок запросов — это API, в котором партнеры могут запрашивать все перенесенные дочерние элементы для заданных условий ввода.

  • GET {baseURL}/v1/migrations/newcommerce

API событий миграции New Commerce используется для получения сведений о событиях миграции на основе текущего идентификатора подписки или идентификатора миграции.

  • GET {baseURL}/v1/customers/{customer-tenant-id}/migrations/newcommerce/events

Версия 3.0.1

Пакет SDK microsoft Partner Center .NET версии 3.0.1 теперь является общим. Также доступны обновленные примеры на сайте GitHub. Эта версия включает следующие изменения:

Транзакция и управление ими

Новое поле в общедоступном контракте

  • POST {baseURL}/v1/customers/{customer_id}/subscriptions/{subscription_id}/transition
  • GET {baseUrl}/v1/customers/{customer_id}/subscriptions/{subscription_id}/transitions
  • GET/PATCH {baseUrl}/v1/customers/{customer_id}/subscriptions/{subscription_id}
    • Добавлено RefundableQuantity свойство в Subscription модель
    • Добавлено CustomTermEndDate свойство в ScheduledNextTermInstructions модель
    • Добавлено MigratedFromSubscriptionId свойство в Subscription модель
  • POST {baseUrl}/v1/customers/{customer_tenant_id}/migrations/newcommerce/validate
    • Добавлено AddOnMigrations свойство в NewCommerceMigration модель
  • POST {baseUrl}/v1/customers/{customer_tenant_id}/migrations/newcommerce
    • Добавлено AddOnMigrations свойство в NewCommerceMigration модель
  • GET {baseUrl}/v1/customers/{customer_tenant_id}/migrations/newcommerce/{migration_id}
    • Добавлено AddOnMigrations свойство в NewCommerceMigration модель
  • POST {baseURL}/v1/customers/{customer_id}/carts
    • Добавлены новые CartErrorCode значения перечисления
    • Добавлена новая AdditionalInformation модель в CartError модель
    • Добавлено CustomTermEndDate свойство в CartLineItem модель
  • GET/PUT {baseURL}/v1/customers/{customer_id}/carts/{cart_id}
    • Добавлены новые CartErrorCode значения перечисления
    • Добавлена новая AdditionalInformation модель в CartError модель
    • Добавлено CustomTermEndDate свойство в CartLineItem модель
  • GET/POST {baseURL}/v1/customers/{customer_id}/orders
    • Добавлено CustomTermEndDate свойство в OrderLineItem модель
  • GET/PATCH {baseURL}/v1/customers/{customer_id}/orders/{order_id}
    • Добавлено CustomTermEndDate свойство в OrderLineItem модель

Средство пакетной миграции NCE

Чтобы упростить потребности партнеров в эффективной миграции больших объемов подписок, мы включили средство пакетной миграции (BAM). Средство BAM позволяет партнерам переносить подписки в NCE с помощью следующего подхода:

  • Упрощенное открытый код пример приложения пакета SDK для .NET
  • Использование Excel для управления изменениями миграции
  • Простое средство, поддерживающее высококачественные, повторяемые и настраиваемые сценарии миграции в пакетах

Подробные инструкции см. в статье New Commerce Experience Batch Migration Tool (BAM).

Безопасность

Новый API

  • Исправление {baseURL}/v1/customers/{customer-tenant-id}
    • Удаление API DAP — удаление свойства набора AllowDelegatedAccess DAP значение false

Аудит и веб-перехватчик

Обновлен аудит. Добавлены новые типы операций для "Управление переубором", "DAP Администратор связь завершена корпорацией Майкрософт" и "Обнаружено событие мошенничества Azure".

Аудит ресурсов

Версия 3.0.0

Microsoft Partner Center .NET SDK версии 3.0.0 теперь является общедоступной. Также доступны обновленные примеры на сайте GitHub. Эта версия включает следующие изменения:

Общие обновления

Обновление System.ComponentModel.Annotations до последней версии (5.0) для решения существующих проблем совместимости.

Транзакция и управление ими

Новый API

  • POST {baseUrl}/v1/customers/{customer_tenant_id}/migrations/newcommerce/validate
  • POST {baseUrl}/v1/customers/{customer_tenant_id}/migrations/newcommerce
  • GET {baseUrl}/v1/customers/{customer_tenant_id}/migrations/newcommerce/{migration-id}
  • GET {baseURL}/customers/{customerId}/subscriptions/overage

Новое поле в общедоступном контракте

  • PATCH {baseURL}/v1/customers/{customer_id}/subscriptions/{subscription_id}
  • POST {baseURL}/v1/customers/{customer_id}/subscriptions/{subscription_id}/transition
  • GET {baseUrl}/v1/customers/{customer_id}/subscriptions/{subscription_id}/transitions
  • POST/PUT {baseURL}/v1/customers/{customer-tenant-id}/cart
  • POST {baseURL}/v1/customers/{customer-tenant-id}/orders
  • PUT {baseURL}/v1/customers/{customer-id}/carts/{cart-id}

Каталог, цены, акции

Новый API

  • POST {baseURL}/v1/customers/{customerId}/promotionEligibilities
  • GET {baseURL}/v1/productpromotions/{promotion-id}?country={country-code}
  • GET {baseURL}/v1/productpromotions?country={country-code}&segment={segment}

Новое поле в общедоступном контракте

  • GET {baseURL}/v1/offers/{offer-id}?country={country-code}
  • GET {baseURL}/v1/products/{product-id}/skus?country={country-code}&targetSegment={target-segment}
  • GET {baseURL}/v1/products/{product-id}/skus/{sku-id}?country={country-code}
  • GET {baseURL}/v1/products?country={country}&targetView={targetView}&targetSegment={targetSegment}
  • POST {baseURL}/v1/customers/{customer-tenant-id}/products?targetView={targetView}
  • GET {baseURL}/v1/products/{product-id}?country={country}
  • POST {baseURL}/v1/customers/{customer-tenant-id}/products/{product-id}/skus
  • GET {baseURL}/v1/products/{product-id}/skus?country={country-code}&targetSegment={target-segment}
  • GET {baseURL}/v1/products/{product-id}/skus/{sku-id}?country={country-code}
  • GET {baseURL}/v1/products/{product-id}/skus/{sku-id}/availabilities?country={country-code}&targetSegment={target-segment}
  • POST {baseURL}/v1/customers/{customer-tenant-id}/products/{product-id}/skus/{sku-id}
  • GET {baseURL}/v1/products/{product-id}/skus/{sku-id}/availabilities/{availability-id}?country={country-code}

Customer

Новый API

  • GET {baseURL}/v1/customers/{customer-id}/validationStatus?type=account

Аудит и веб-перехватчик

Обновление аудита. Добавлены новые типы операций для добавления SoftwareAttestation и добавления устройств и политик Обновления

Аудит ресурсов (материалы для разработчиков приложений в Центре партнеров) | Документация Майкрософт

  • GET {baseURL}/v1/products/{product-id}/skus?country={country-code}&targetSegment={target-segment}
  • GET {baseURL}/v1/products/{product-id}/skus/{sku-id}?country={country-code}
  • GET {baseURL}/v1/products?country={country}&targetView={targetView}&targetSegment={targetSegment}
  • POST {baseURL}/v1/customers/{customer-tenant-id}/products?targetView={targetView}
  • GET {baseURL}/v1/products/{product-id}?country={country}
  • POST {baseURL}/v1/customers/{customer-tenant-id}/products/{product-id}/skus
  • GET {baseURL}/v1/products/{product-id}/skus?country={country-code}&targetSegment={target-segment}
  • GET {baseURL}/v1/products/{product-id}/skus/{sku-id}?country={country-code}
  • GET {baseURL}/v1/products/{product-id}/skus/{sku-id}/availabilities?country={country-code}&targetSegment={target-segment}
  • POST {baseURL}/v1/customers/{customer-tenant-id}/products/{product-id}/skus/{sku-id}
  • GET {baseURL}/v1/products/{product-id}/skus/{sku-id}/availabilities/{availability-id}?country={country-code}
  • PUT {baseURL}/customers/{customerId}/subscriptions/overage
  • GET {baseURL}/customers/{customerId}/subscriptions/overage

Версия 2.0.1

Пакет SDK для .NET Для Microsoft Partner Center версии 2.0.1 теперь является общим. Также доступны обновленные примеры на сайте GitHub. Эта версия включает следующие изменения:

Примечание.

Некоторые изменения, представленные в рамках new commerce Experiences ("NCE"), которые в настоящее время доступны на основе приглашений только для партнеров, которые являются частью Microsoft 365/Microsoft Dynamics 365 new commerce experience technical preview. Партнеры, которые не являются частью новой коммерческой частной предварительной версии, не должны заметить влияние и должны быть обратно совместимыми.

Распространенный почтовый сервис

  • Изменение ссылки на библиотеку проверки подлинности. Ссылка изменяется с библиотеки проверки подлинности Azure Active Directory (ADAL) на библиотеку проверки подлинности Майкрософт (MSAL)

    Для правильной работы MSAL в вашем приложении или примере .NET необходимо вносить следующие изменения:

    • Добавление https://login.microsoftonline.com/common/oauth2/nativeclient в качестве redirectUrl для мобильных и классических приложений

    • Добавьте домен в раздел UserAuthentication в файле конфигурации приложения.

      Домен — это домен Azure Active Directory или идентификатор клиента, в котором было создано приложение Azure AD.

  • Коды ошибок — добавлен новый код ошибки

    • 408: время ожидания запроса
    • 504: время ожидания шлюза

Управление выставлением счетов

  • Элементы строки счета — новые атрибуты, добавленные в следующие API:

    • GET /invoices/{invoice-id}/lineitems?provider={provider}&invoicelineitemtype=billinglineitems
    • GET /invoices/unbilled/lineitems?provider=onetime&invoicelineitemtype=billinglineitems

    Новые атрибуты:

    • productQualifiers
    • subscriptionStartDate
    • subscriptionEndDate
    • referenceId
    • creditReasonCode (применимо только к NCE)
    • promotionId

  • Ежедневный рейтинг элементов строки использования — новые атрибуты, добавленные в следующий API:

    • GET /invoices/{invoice-id}/lineitems?provider=onetime&invoicelineitemtype=usagelineitems

    Новые атрибуты:

    • hasPartnerEarnedCredit (применимо только к NCE)
    • creditType (применимо только к NCE)
    • rateOfCredit (применимо только к NCE)

Управление заказами

  • Ресурсы подписки — добавлено новое свойство.

    • CancellationAllowedUntilDate — (применимо только к NCE)

  • Переход ресурсов (применимо только к NCE) — добавлено новое свойство

    • FromSubscriptionId

Управление учетными записями клиентов

  • Проверка адреса : ответ изменяется с логического элемента на новую модель для API:

    • POST /validations/address

    Новая модель ответа:

    • AddressValidationResponse

  • Не рекомендуется использовать синхронный API клиента.

Версия 1.17.0

Пакет SDK microsoft Partner Center .NET версии 1.17.0 теперь является общим. Также доступны обновленные примеры на сайте GitHub. Эта версия включает следующие изменения:

  • Обновление аудита. Добавлены новые типы операций, которые будут знать, когда клиент одобрил и завершил DAP.

  • Обновлен аудит— добавлены новые типы ресурсов и операций для поддержки сценария роли каталога клиента

  • Обновления пакета SDK для учетной записи клиентов — поддержка следующих API

    • GET /customers/{customer-tenant-id}/directSignedMicrosoftCustomerAgreementStatus
    • GET /customers/{идентификатор_арендатора_клиента}/qualifications
    • POST /customers/{идентификатор_клиента}/qualifications?code={проверочный_код}

  • Следующие изменения, представленные как часть Новой коммерции, которые в настоящее время доступны на основе приглашения только для партнеров, которые являются частью Microsoft 365/Microsoft Dynamics 365 new commerce experience technical preview. Партнеры, которые не являются частью частной коммерческой предварительной версии, не должны замечать последствия и должны быть обратно совместимыми.

    • Изменения каталога:
      • GET /products/{идентификатор_продукта}/skus/{идентификатор_SKU}
    • Приобретение и управление:
      • GET /customers/{идентификатор_клиента}/subscriptions
      • GET /customers/{идентификато_клиента}/subscriptions/{идентификатор_подписки}
      • PATCH /customers/{идентификатор_клиента}/subscriptions/{идентификатор_подписки}
      • GET /customers/{идентификатор_клиента}/subscriptions/{идентификатор_подписки}/transitioneligibilities
      • GET /customers/{идентификатор_клиента}/subscriptions/{идентификатор_подписки}/transitions
      • POST /customers/{идентификатор_клиента}/subscriptions/{идентификатор_подписки}/transitions

Версия 1.16.3

Пакет SDK microsoft Partner Center .NET версии 1.16.3 теперь является общим. Также доступны обновленные примеры на сайте GitHub. Эта версия включает следующие изменения:

Версия 1.16.2

Пакет SDK microsoft Partner Center .NET версии 1.16.2 теперь является общим. Также доступны обновленные примеры на сайте GitHub. Эта версия включает следующие изменения:

  • Обновление поддерживаемых типов операций для записей аудита. Новые добавленные:

    • CreateSelfServePolicy;
    • UpdateSelfServePolicy;
    • DeleteSelfServePolicy;
    • RemovePartnerRelationship;
    • DeleteTipCustomer;
    • CreateRelatedReferral;
    • UpdateRelatedReferral.

  • Функция создания запроса на обслуживание объявлена нерекомендуемой.

  • Разделы поддержки объявлены нерекомендуемыми.

Версия 1.16.1

Пакет SDK microsoft Partner Center .NET версии 1.16.1 теперь является общим. Также доступны обновленные примеры на сайте GitHub. Эта версия включает следующие изменения:

Мы переносили существующий пакет SDK Центра партнеров Майкрософт из платформа .NET Framework на платформу .NET Standard 2.0. Эта миграция обеспечит совместимость пакета SDK с существующими приложениями с помощью платформа .NET Framework 4.6.1 и более поздних версий. Пакет SDK поддерживает .NET Core 2.0 и выше. Прежде чем переносить его в существующие приложения, проверьте поддержку реализации .NET.

Версия 1.15.3

Пакет SDK microsoft Partner Center .NET версии 1.15.3 теперь является общим. Также доступны обновленные интерфейсы REST API и примеры GitHub. Эта версия включает следующие изменения: