Faturalamayı etkinleştirmek için ticari market SaaS ürünleri için korumalı alan aboneliğini etkinleştirme

  • Makale

Faturalamayı etkinleştirmek için tümleştirme korumalı alanı hesaplarından ticari market Hizmet Olarak Yazılım (SaaS) ürünleri aboneliğini etkinleştirme.

Not

Yalnızca tümleştirme korumalı alanı hesaplarından ticari market SaaS ürünleri için bir aboneliği etkinleştirmek mümkündür. Üretim aboneliğiniz varsa, kurulum işlemini tamamlamak için yayımcının sitesini ziyaret etmeniz gerekir. Abonelik faturalaması ancak kurulum tamamlandıktan sonra başlar.

Önkoşullar

  • İş Ortağı Merkezi kimlik doğrulamasında açıklandığı gibi kimlik bilgileri. Bu senaryo hem tek başına Uygulama hem de App+User kimlik bilgileriyle kimlik doğrulamayı destekler.
  • Ticari market SaaS ürünleri için etkin aboneliğe sahip bir müşterinin olduğu tümleştirme korumalı alan iş ortağı hesabı.
  • İş Ortağı Merkezi .NET SDK'sını kullanan iş ortakları için bu özelliğe erişmek için SDK sürüm 1.14.0 veya üzerini kullanmanız gerekir.

Önemli

Haziran 2023 itibarıyla en son İş Ortağı Merkezi .NET SDK sürümü 3.4.0 arşivlenmiştir. SDK sürümünü, yararlı bilgiler içeren bir benioku dosyasıyla birlikte GitHub'dan indirebilirsiniz.

İş ortaklarının İş Ortağı Merkezi REST API'lerini kullanmaya devam etmesi teşvik edilir.

C#

Ticari market SaaS ürünleri aboneliğini etkinleştirmek için aşağıdaki adımları kullanın:

  1. Abonelik işlemleri için bir arabirim sağlayın. Müşteriyi tanımlamanız ve deneme aboneliğinin abonelik tanımlayıcısını belirtmeniz gerekir.

    var subscriptionOperations = partnerOperations.Customers.ById(customerId).Subscriptions.ById(subscriptionId);

  2. Etkinleştirme işlemini kullanarak aboneliği etkinleştirin .

    var subscriptionActivationResult = subscriptionOperations.Activate();

REST isteği

İstek söz dizimi

Yöntem İstek URI'si
POST {baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/activate HTTP/1.1

URI parametresi

Ad Tür Gerekli Açıklama
customer-tenant-id Guıd Y Değer, müşteri belirtmenize olanak tanıyan GUID biçimli bir müşteri kiracı tanımlayıcısıdır (customer-tenant-id).
subscription-id Guıd Y Değer, bir abonelik belirtmenize olanak tanıyan GUID biçimli bir abonelik tanımlayıcısıdır (subscription-id).

İstek üst bilgileri

Daha fazla bilgi için bkz . İş Ortağı Merkezi REST üst bilgileri.

İstek gövdesi

Yok.

İstek örneği

POST https://api.partnercenter.microsoft.com/v1/customers/42b5f772-5c5c-4bce-b9d7-bdadeecca411/subscriptions/87363db7-39ab-dd25-d371-94340aaa2f97/activate HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-CorrelationId: 1438ea3d-b515-45c7-9ec1-27ee0cc8e6bd
MS-RequestId: 655890ba-4d2b-4d09-a95f-4ea1348686a5

REST yanıtı

Bu yöntem subscription-id ve durum özelliklerini döndürür.

Yanıt başarısı ve hata kodları

Her yanıt, başarıyı veya başarısızlığı ve ek hata ayıklama bilgilerini gösteren bir HTTP durum koduyla birlikte gelir. Bu kodu, hata türünü ve ek parametreleri okumak için bir ağ izleme aracı kullanın. Tam liste için bkz. İş Ortağı Merkezi REST hata kodları.

Yanıt örneği

HTTP/1.1 200 OK
Content-Length: 79
Content-Type: application/json
MS-CorrelationId: 1438ea3d-b515-45c7-9ec1-27ee0cc8e6bd
MS-RequestId: 655890ba-4d2b-4d09-a95f-4ea1348686a5

{
    "subscriptionId":"87363db7-39ab-dd25-d371-94340aaa2f97",
    "status":"Success"
}