Deneme dönüştürme tekliflerinin bir listesini alma

  • Makale
  • Okumak için 2 dakika

Deneme dönüştürme tekliflerinin listesini alma.

Önkoşullar

  • kimlik doğrulamasında açıklandığı gibi İş Ortağı Merkezi bilgileri. Bu senaryo yalnızca App+User kimlik bilgileriyle kimlik doğrulamasını destekler.

  • Müşteri kimliği ( customer-tenant-id ). Müşterinin kimliğini bilmiyorsanız bu kimliği panoda İş Ortağı Merkezi. İş Ortağı Merkezi'den CSP'yi ve ardından Müşteriler'i seçin. Müşteri listesinden müşteriyi ve ardından Hesap'ı seçin. Müşterinin Hesap sayfasında Müşteri Hesabı Bilgileri bölümünde MicrosoftKimliği'ne bakın. Microsoft Kimliği, müşteri kimliği () ile customer-tenant-id aynıdır.

  • Etkin bir deneme aboneliği için abonelik kimliği.

C#

Kullanılabilir deneme dönüştürmelerinin listesini almak için, müşteri kimliğini kullanarak müşteri kimliğiyle IAggregatePartner.Customers.ById yöntemini kullanarak müşteriyi tanıyın. Ardından, deneme aboneliği kimliğiyle Subscriptions.ById yöntemini çağırarak abonelik işlemlerine bir arabirim alın. Ardından Dönüştürmeler özelliğini kullanarak dönüştürmeler üzerinde kullanılabilir işlemlere bir arabirim elde edin ve ardından kullanılabilir Dönüştürme tekliflerinin koleksiyonunu almak için Get veya GetAsyncyöntemini çağırabilirsiniz.

// IAggregatePartner partnerOperations;
// string customerId;
// string subscriptionId;

// Get the available conversions.
var conversions =
    partnerOperations.Customers.ById(customerId).Subscriptions.ById(subscriptionId).Conversions.Get();

REST isteği

İstek söz dizimi

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

URI parametresi

Müşteri ve deneme aboneliğini tanımlamak için aşağıdaki yol parametrelerini kullanın.

Ad Tür Gerekli Açıklama
customer-id string Yes Müşteriyi tanımlayan GUID biçimli bir dize.
subscription-id string Yes Deneme aboneliğini tanımlayan GUID biçimli bir dize.

İstek üst bilgileri

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

İstek gövdesi

Yok.

İstek örneği

GET https://api.partnercenter.microsoft.com/v1/customers/0c39d6d5-c70d-4c55-bc02-f620844f3fd1/subscriptions/488745B5-2086-4912-802C-6ABB9F7C3638/conversions HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: e17f5bc6-24bf-4cbe-b632-d7fc6cec3058
MS-CorrelationId: 8daa6d54-72ab-4d6b-9c7d-9266d3734a47
X-Locale: en-US
Host: api.partnercenter.microsoft.com

REST yanıtı

Başarılı olursa, yanıt gövdesi Bir Dönüştürme kaynakları koleksiyonu içerir.

Yanıt başarı ve hata kodları

Her yanıt, başarılı veya başarısız olduğunu gösteren bir HTTP durum kodu ve ek hata ayıklama bilgileriyle 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 kodları.

Yanıt örneği

HTTP/1.1 200 OK
Content-Length: 305
Content-Type: application/json; charset=utf-8
MS-CorrelationId: 8daa6d54-72ab-4d6b-9c7d-9266d3734a47
MS-RequestId: e17f5bc6-24bf-4cbe-b632-d7fc6cec3058
MS-CV: feJByqU1X0ObaTQr.0
MS-ServerId: 030011719
Date: Thu, 15 Jun 2017 23:10:01 GMT

 {
    "totalCount": 1,
    "items": [{
            "offerId": "C0BD2E08-11AC-4836-BDC7-3712E744922F",
            "targetOfferId": "031C9E47-4802-4248-838E-778FB1D2CC05",
            "orderId": "D51A052E-043C-4A2A-AA37-2BB938CEF6C1",
            "quantity": 25,
            "billingCycle": "monthly",
            "attributes": {
                "objectType": "Conversion"
            }
        }
    ],
    "attributes": {
        "objectType": "Collection"
    }
}