Kimliğine göre kullanılabilirliği alma
Belirtilen ürün ve SKU için kullanılabilirlik kimliğini kullanarak kullanılabilirliği alır. Kullanılabilirlik kimlikleri değişebilir ve dinamiktir, düzenli aralıklarla yeniden oluşturulur. İş ortakları, sepet satırı öğeleri gönderirken veya kullanılabilirlik kimliğini gerektiren diğer etkinlikleri yürütürken her zaman geçerli kullanılabilirliği elde ettiğinden emin olmalıdır.
Önkoşullar
İş Ortağı Merkezi kimlik doğrulamasında açıklandığı gibi kimlik bilgileri. Bu senaryo hem tek başına Uygulama hem de Uygulama+Kullanıcı kimlik bilgileriyle kimlik doğrulamayı destekler.
Ürün kimliği.
SKU kimliği.
Kullanılabilirlik kimliği.
C#
Belirli bir kullanılabilirlik durumunun ayrıntılarını almak için, belirli bir SKU'nun işlemlerinin arabirimini almak üzere Kimliğe göre SKU alma makalesindeki adımları kullanarak başlayın. Elde edilen arabirimden Kullanılabilirlik özelliğini seçerek Kullanılabilirlik için kullanılabilir işlemleri içeren bir arabirim elde edin. Bundan sonra, kullanılabilirlik kimliğini ById() yöntemine geçirerek ilgili kullanılabilirliğe yönelik işlemleri alın ve ardından kullanılabilirlik ayrıntılarını almak için Get() veya GetAsync() öğesini çağırın.
IAggregatePartner partnerOperations;
string countryCode;
string productId;
string skuId;
string availabilityId;
// Get the availability details.
var availability = partnerOperations.Products.ByCountry(countryCode).ById(productId).Skus.ById(skuId).Availabilities.ById(availabilityId).Get();
Java
İş Ortağı Merkezi Java SDK'sı, İş Ortağı Merkezi kaynaklarını yönetmek için kullanılabilir. İş ortağı topluluğu tarafından sürdürülen ve Microsoft tarafından resmi olarak desteklenmeyen açık kaynaklı bir projedir. Bir sorunla karşılaşırsanız topluluktan yardım alabilir veya GitHub'da bir sorun açabilirsiniz.
Belirli bir kullanılabilirlik durumunun ayrıntılarını almak için, belirli bir SKU'nun işlemlerinin arabirimini almak üzere Kimliğe göre SKU alma makalesindeki adımları kullanarak başlayın. Elde edilen arabirimden getAvailabilities işlevini seçerek Kullanılabilirlik için kullanılabilir işlemleri içeren bir arabirim elde edin. Bundan sonra, kullanılabilirlik kimliğini byId() işlevine geçirerek ilgili kullanılabilirliğe yönelik işlemleri alın ve kullanılabilirlik ayrıntılarını almak için get() işlevini çağırın.
IAggregatePartner partnerOperations;
String countryCode;
String productId;
String skuId;
String availabilityId;
// Get the availability details.
Availability availability = partnerOperations.getProducts().byCountry(countryCode).byId(productId).getSkus().byId(skuId).getAvailabilities().byId(availabilityId).get();
PowerShell
İş Ortağı Merkezi PowerShell modülü, İş Ortağı Merkezi kaynaklarını yönetmek için kullanılabilir. İş ortağı topluluğu tarafından sürdürülen ve Microsoft tarafından resmi olarak desteklenmeyen açık kaynaklı bir projedir. Bir sorunla karşılaşırsanız topluluktan yardım alabilir veya GitHub'da bir sorun açabilirsiniz.
Belirli bir kullanılabilirliğin ayrıntılarını almak için Get-PartnerProductAvailability komutunu yürüterek kullanılabilirlik ayrıntılarını almak için AvailabilityId, CountryCode, ProductId ve SkuId parametrelerini belirtin.
Get-PartnerProductAvailability -Product $productId -SkuId $skuId -AvailabilityId $availabilityId
REST isteği
İstek söz dizimi
| Metot | İstek URI'si |
|---|---|
| GET | {baseURL}/v1/products/{product-id}/skus/{sku-id}/availabilities/{availability-id}?country={country-code} HTTP/1.1 |
URI parametresi
Kullanılabilirlik kimliğini kullanarak belirli bir kullanılabilirlik elde etmek için aşağıdaki yolu ve sorgu parametrelerini kullanın.
| Adı | Tür | Zorunlu | Açıklama |
|---|---|---|---|
| product-id | string | Yes | Ürünü tanımlayan GUID biçimli bir dize. |
| sku-id | string | Yes | SKU'yu tanımlayan GUID biçimli bir dize. |
| availability-id | string | Yes | Kullanılabilirliği tanımlayan GUID biçimli bir dize. |
| ülke kodu | string | Yes | Ülke/bölge kimliği. |
İstek üst bilgileri
Daha fazla bilgi için bkz . İş Ortağı Merkezi REST üst bilgileri.
Request body
Yok.
İstek örneği
GET http://api.partnercenter.microsoft.com/v1/products/DZH318Z0BQ3Q/skus/0001/availabilities/DZH318XZXPHL?country=US HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 2e12a576-ded5-437e-a5ec-dbfbcbd1624c
MS-CorrelationId: 83b644b5-e54a-4bdc-b354-f96c525b3c58
X-Locale: en-US
MS-PartnerCenter-Client: Partner Center .NET SDK
Host: api.partnercenter.microsoft.com
Ö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.
REST yanıtı
Başarılı olursa, yanıt gövdesi bir Kullanılabilirlik kaynağı içerir.
Yanıt başarısı ve hata kodları
Her yanıt, başarılı veya başarısız olduğunu belirten 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 hata kodları.
Bu yöntem aşağıdaki hata kodlarını döndürür:
| HTTP Durum Kodu | Hata kodu | Açıklama |
|---|---|---|
| 404 | 400013 | Ürün bulunamadı. |
| 404 | 400018 | SKU bulunamadı. |
| 404 | 400019 | Kullanılabilirlik bulunamadı. Bir sepet kullanıma alınırken bu hata oluşabilir. Bu hatayı alan iş ortakları, geçerli kullanılabilirlik kimliğine sahip olduklarından emin olmak için yeni bir GET vermeli ve sepeti kullanıma almayı yeniden denemelidir. |
Azure VM rezervasyonları için yanıt örneği (Azure planı)
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Server: Microsoft-IIS/10.0
MS-CorrelationId: 83b644b5-e54a-4bdc-b354-f96c525b3c58,83b644b5-e54a-4bdc-b354-f96c525b3c58
MS-RequestId: 2e12a576-ded5-437e-a5ec-dbfbcbd1624c,2e12a576-ded5-437e-a5ec-dbfbcbd1624c
X-Locale: en-US,en-US
X-SourceFiles: =?UTF-8?B?QzpcVXNlcnNcbWFtZW5kZVxkZXZcZHBzLXJwZVxSUEUuUGFydG5lci5TZXJ2aWNlLkNhdGFsb2dcV2ViQXBpc1xDYXRhbG9nU2VydmljZS5WMi5XZWJcdjFccHJvZHVjdHNcRFpIMzE4WjBCUTNRXHNrdXNcMDAwMVxhdmFpbGFiaWxpdGllc1xEWkgzMThaMEhNS1E=?=
X-Powered-By: ASP.NET
Date: Wed, 14 Mar 2018 22:19:43 GMT
Content-Length: 440
{
"id": "DZH318XZXPHL",
"productId": "DZH318Z0BQ3Q",
"skuId": "0001",
"catalogItemId": "DZH318Z0BQ3Q:0001:DZH318XZXPHL",
"defaultCurrency": {
"code": "USD",
"symbol": "$"
},
"segment": "commercial",
"country": "US",
"isPurchasable": true,
"isRenewable": false,
"terms": [{
"duration": "P1Y",
"description": "1 Year Prepaid"
}],
"product": { ... },
"sku": { ... },
"links": {
"self": {
"uri": "/products/DZH318Z0BQ3Q/skus/0001/availabilities/DZH318XZXPHL?country=US",
"method": "GET",
"headers": []
}
}
}
Yeni ticari lisans tabanlı hizmetler için yanıt örneği
Not
Lisans tabanlı hizmetler için yeni ticaret deneyimleri birçok yeni özellik içerir ve tüm Bulut Çözümü Sağlayıcısı (CSP' ler) tarafından kullanılabilir. Daha fazla bilgi için bkz . Yeni ticaret deneyimlerine genel bakış.
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Server: Microsoft-IIS/10.0
MS-CorrelationId: 83b644b5-e54a-4bdc-b354-f96c525b3c58,83b644b5-e54a-4bdc-b354-f96c525b3c58
MS-RequestId: 70324727-62d8-4195-8f99-70ea25058d02,70324727-62d8-4195-8f99-70ea25058d02
X-Locale: en-US,en-US
X-SourceFiles: =?UTF-8?B?QzpcVXNlcnNcbWFtZW5kZVxkZXZcZHBzLXJwZVxSUEUuUGFydG5lci5TZXJ2aWNlLkNhdGFsb2dcV2ViQXBpc1xDYXRhbG9nU2VydmljZS5WMi5XZWJcdjFccHJvZHVjdHNcRFpIMzE4WjBCUTNRXHNrdXNcMDAwMVxhdmFpbGFiaWxpdGllcw==?=
X-Powered-By: ASP.NET
Date: Wed, 14 Mar 2018 22:19:37 GMT
Content-Length: 808
{
"id": "CFQ7TTC0K971",
"productId": "CFQ7TTC0LH18",
"skuId": "0001",
"catalogItemId": "CFQ7TTC0LH18:0001:CFQ7TTC0K971",
"defaultCurrency": {
"code": "USD",
"symbol": "$"
},
"segment": "commercial",
"country": "US",
"isPurchasable": true,
"isRenewable": true,
"renewalInstructions": [
{
"applicableTermIds": [
"5aeco6mffyxo"
],
"renewalOptions": [
{
"renewToId": "CFQ7TTC0LH18:0001",
"isAutoRenewable": true
}
]
},
…
],
"terms": [
{
"id": "5aeco6mffyxo",
"duration": "P1Y",
"description": "One-Year commitment for monthly/yearly billing",
"billingCycle": "Annual",
"cancellationPolicies": [
{
"refundOptions": [
{
"sequenceId": 0,
"type": "Full",
"expiresAfter": "P1D"
}
]
}
]
},
…
],
"product": { ... },
"sku": { ... },
"links": {
"self": {
"uri": "/products/CFQ7TTC0LH18/skus/0001/availabilities/CFQ7TTC0K971?country=US",
"method": "GET",
"headers": []
}
}
}
Geri Bildirim
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz. https://aka.ms/ContentUserFeedback.
Gönderin ve geri bildirimi görüntüleyin