De beschikbaarheid per id ophalen
Hiermee haalt u de beschikbaarheid voor het opgegeven product en de SKU op met behulp van een beschikbaarheids-id. Beschikbaarheids-id's zijn veranderlijk en dynamisch, ze worden regelmatig opnieuw uitgegeven. Partners moeten altijd de huidige beschikbaarheid krijgen bij het indienen van winkelwagenlijnitems of het uitvoeren van andere activiteiten waarvoor de beschikbaarheids-id is vereist.
Vereisten
Referenties zoals beschreven in verificatie in partnercentrum. Dit scenario ondersteunt verificatie met zowel zelfstandige app- als app+gebruikersreferenties.
Een product-id.
Een SKU-id.
Een beschikbaarheids-id.
C#
Als u details van een specifieke beschikbaarheid wilt ophalen, begint u met de stappen in Een SKU ophalen op id om de interface voor de bewerkingen van een specifieke SKU op te halen. Selecteer in de resulterende interface de eigenschap Beschikbaarheid om een interface te verkrijgen met de beschikbare bewerkingen voor beschikbaarheid. Geef daarna de beschikbaarheids-id door aan de ById() -methode om de bewerkingen voor die specifieke beschikbaarheid op te halen en roep vervolgens Get() of GetAsync() aan om de beschikbaarheidsgegevens op te halen.
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
De Partner Center Java SDK kan worden gebruikt voor het beheren van Partnercentrum-resources. Het is een opensource-project dat wordt onderhouden door de partnercommunity en niet officieel wordt ondersteund door Microsoft. U kunt hulp krijgen van de community of een probleem openen op GitHub als u een probleem ondervindt.
Als u details van een specifieke beschikbaarheid wilt ophalen, begint u met de stappen in Een SKU ophalen op id om de interface voor de bewerkingen van een specifieke SKU op te halen. Selecteer in de resulterende interface de functie getAvailabilities om een interface te verkrijgen met de beschikbare bewerkingen voor beschikbaarheid. Geef daarna de beschikbaarheids-id door aan de byId() -functie om de bewerkingen voor die specifieke beschikbaarheid op te halen en roep vervolgens de get() -functie aan om de beschikbaarheidsgegevens op te halen.
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
De PowerShell-module partnercentrum kan worden gebruikt voor het beheren van Partnercentrum-resources. Het is een opensource-project dat wordt onderhouden door de partnercommunity en niet officieel wordt ondersteund door Microsoft. U kunt hulp krijgen van de community of een probleem openen op GitHub als u een probleem ondervindt.
Als u details van een specifieke beschikbaarheid wilt ophalen, voert u de get-PartnerProductAvailability uit en geeft u de parameters AvailabilityId, CountryCode, ProductId en SkuId op om de beschikbaarheidsgegevens op te halen.
Get-PartnerProductAvailability -Product $productId -SkuId $skuId -AvailabilityId $availabilityId
REST-aanvraag
Aanvraagsyntaxis
| Wijze | Aanvraag-URI |
|---|---|
| GET | {baseURL}/v1/products/{product-id}/skus/{sku-id}/beschikbaarheid/{availability-id}?country={country-code} HTTP/1.1 |
URI-parameter
Gebruik het volgende pad en queryparameters om een specifieke beschikbaarheid op te halen met behulp van een beschikbaarheids-id.
| Name | Type | Vereist | Beschrijving |
|---|---|---|---|
| product-id | tekenreeks | Ja | Een tekenreeks met GUID-indeling die het product identificeert. |
| sku-id | tekenreeks | Ja | Een tekenreeks met GUID-indeling die de SKU identificeert. |
| beschikbaarheids-id | tekenreeks | Ja | Een tekenreeks met GUID-indeling die de beschikbaarheid identificeert. |
| landcode | tekenreeks | Ja | Een land-/regio-id. |
Aanvraagheaders
Zie Rest-headers in Partnercentrum voor meer informatie.
Aanvraagtekst
Geen.
Aanvraagvoorbeeld
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
Belangrijk
Vanaf juni 2023 wordt de nieuwste Versie van Partner Center .NET SDK 3.4.0 gearchiveerd. U kunt de SDK-release downloaden van GitHub, samen met een leesmij-bestand dat nuttige informatie bevat.
Partners worden aangemoedigd om de REST API's van partnercentrum te blijven gebruiken.
REST-antwoord
Als dit lukt, bevat de antwoordtekst een beschikbaarheidsresource .
Geslaagde antwoorden en foutcodes
Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft dat de fout is geslaagd of mislukt en aanvullende informatie over foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en aanvullende parameters te lezen. Zie foutcodes in Partnercentrum voor de volledige lijst.
Deze methode retourneert de volgende foutcodes:
| HTTP-statuscode | Foutcode | Beschrijving |
|---|---|---|
| 404 | 400013 | Het product is niet gevonden. |
| 404 | 400018 | Er is geen SKU gevonden. |
| 404 | 400019 | Beschikbaarheid niet gevonden. Deze fout kan optreden bij het uitchecken van een winkelwagen. Partners die deze fout krijgen, moeten een nieuwe GET uitgeven om ervoor te zorgen dat ze de huidige beschikbaarheids-id hebben en het winkelwagentje opnieuw proberen uit te checken. |
Antwoordvoorbeeld voor Azure VM-reserveringen (Azure-abonnement)
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": []
}
}
}
Antwoordvoorbeeld voor nieuwe commercelicentieservices
Notitie
De nieuwe commerce-ervaringen voor services op basis van licenties omvatten veel nieuwe mogelijkheden en zijn beschikbaar voor alle CSP's (Cloud Solution Provider). Zie het overzicht van nieuwe commerce-ervaringen voor meer informatie.
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": []
}
}
}
Feedback
Binnenkort beschikbaar: In de loop van 2024 zullen we GitHub-problemen geleidelijk uitfaseren als het feedbackmechanisme voor inhoud en deze vervangen door een nieuw feedbacksysteem. Zie voor meer informatie: https://aka.ms/ContentUserFeedback.
Feedback verzenden en weergeven voor