De beschikbaarheid per id ophalen

Artikel
11/05/2024

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.
IncludeLifeCycleState	tekenreeks	Nee	Een tekenreeksvlag die kan worden ingesteld op true om waarden voor levenscyclusstatussen te retourneren voor aanbiedingen op basis van nieuwe commercelicenties. Deze waarden worden niet geretourneerd als de vlag niet is opgenomen.

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: aaaa0000-bb11-2222-33cc-444444dddddd
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 er succes- of foutopsporingsinformatie is en extra informatie over foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en andere 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: aaaa0000-bb11-2222-33cc-444444dddddd,aaaa0000-bb11-2222-33cc-444444dddddd
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: aaaa0000-bb11-2222-33cc-444444dddddd,aaaa0000-bb11-2222-33cc-444444dddddd
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": []
        }
    }
}

Delen via