Abrufen der Verfügbarkeit nach ID

Artikel
11/05/2024

Ruft die Verfügbarkeit für das angegebene Produkt und die SKU mithilfe einer Verfügbarkeits-ID ab. Verfügbarkeits-IDs sind änderbar und dynamisch, sie werden regelmäßig erneut ausgeführt. Partner sollten immer sicherstellen, dass sie die aktuelle Verfügbarkeit erhalten, wenn Sie Artikel im Warenkorb übermitteln oder andere Aktivitäten ausführen, die die Verfügbarkeits-ID erfordern.

Voraussetzungen

Anmeldeinformationen, wie unter Partner Center-Authentifizierung beschrieben. Dieses Szenario unterstützt die Authentifizierung mit eigenständigen App- und App+Benutzeranmeldeinformationen.
Eine Produkt-ID.
Eine SKU-ID.
Eine Verfügbarkeits-ID.

C#

Um Details zu einer bestimmten Verfügbarkeit zu erhalten, beginnen Sie mit den Schritten unter "Abrufen einer SKU nach ID ", um die Schnittstelle für die Vorgänge einer bestimmten SKU abzurufen. Wählen Sie auf der resultierenden Schnittstelle die Availabilities-Eigenschaft aus, um eine Schnittstelle mit den verfügbaren Vorgängen für Availabilities abzurufen. Übergeben Sie danach die Verfügbarkeits-ID an die ById() -Methode, um die Vorgänge für diese bestimmte Verfügbarkeit abzurufen, und rufen Sie dann Get() oder GetAsync() auf, um die Verfügbarkeitsdetails abzurufen.

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

Das Partner Center Java SDK kann zum Verwalten von Partner Center-Ressourcen verwendet werden. Es handelt sich um ein Open-Source-Projekt, das von der Partnercommunity verwaltet wird und von Microsoft nicht offiziell unterstützt wird. Sie können Hilfe von der Community erhalten oder ein Issue auf GitHub öffnen, wenn ein Problem auftritt.

Um Details zu einer bestimmten Verfügbarkeit zu erhalten, beginnen Sie mit den Schritten unter "Abrufen einer SKU nach ID ", um die Schnittstelle für die Vorgänge einer bestimmten SKU abzurufen. Wählen Sie aus der resultierenden Schnittstelle die getAvailabilities-Funktion aus, um eine Schnittstelle mit den verfügbaren Vorgängen für Availabilities abzurufen. Übergeben Sie danach die Verfügbarkeits-ID an die byId() -Funktion, um die Vorgänge für diese bestimmte Verfügbarkeit abzurufen, und rufen Sie dann die Get() -Funktion auf, um die Verfügbarkeitsdetails abzurufen.

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

Das Partner Center PowerShell-Modul kann zum Verwalten von Partner Center-Ressourcen verwendet werden. Es handelt sich um ein Open-Source-Projekt, das von der Partnercommunity verwaltet wird und von Microsoft nicht offiziell unterstützt wird. Sie können Hilfe von der Community erhalten oder ein Issue auf GitHub öffnen, wenn ein Problem auftritt.

Um Details zu einer bestimmten Verfügbarkeit zu erhalten, führen Sie die Get-PartnerProductAvailability-Methode aus, und geben Sie die Parameter AvailabilityId, CountryCode, ProductId und SkuId an, um die Verfügbarkeitsdetails abzurufen.

Get-PartnerProductAvailability -Product $productId -SkuId $skuId -AvailabilityId $availabilityId

REST-Anforderung

Anforderungssyntax

Methode	Anforderungs-URI
GET	{baseURL}/v1/products/{product-id}/skus/{sku-id}/availabilities/{availability-id}?country={country-code} HTTP/1.1

URI-Parameter

Verwenden Sie die folgenden Pfad- und Abfrageparameter, um eine bestimmte Verfügbarkeit mithilfe einer Verfügbarkeits-ID abzurufen.

Name	Type	Erforderlich	Beschreibung
product-id	Zeichenfolge	Ja	Eine GUID-formatierte Zeichenfolge, die das Produkt identifiziert.
sku-id	Zeichenfolge	Ja	Eine GUID-formatierte Zeichenfolge, die die SKU identifiziert.
availability-id	Zeichenfolge	Ja	Eine GUID-formatierte Zeichenfolge, die die Verfügbarkeit identifiziert.
Ländercode	Zeichenfolge	Ja	Eine Landes-/Regions-ID.
IncludeLifeCycleState	Zeichenfolge	No	Ein Zeichenfolgenkennzeichnung, das auf "true" festgelegt werden kann, um Lebenszyklusstatuswerte für lizenzbasierte New Commerce-Angebote zurückzugeben. Diese Werte werden nicht zurückgegeben, wenn das Flag nicht enthalten ist.

Anforderungsheader

Weitere Informationen finden Sie unter Partner Center-REST-Header.

Anforderungstext

Keine.

Anforderungsbeispiel

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

Wichtig

Ab Juni 2023 ist jetzt die neueste Partner Center .NET SDK-Version 3.4.0 archiviert. Sie können das SDK-Release von GitHub zusammen mit einer Infodatei herunterladen, die nützliche Informationen enthält.

Partnern wird empfohlen, weiterhin die Partner Center-REST-APIs zu verwenden.

REST-Antwort

Bei erfolgreicher Ausführung enthält der Antworttext eine Verfügbarkeitsressource .

Erfolgs- und Fehlercodes der Antwort

Jede Antwort enthält einen HTTP-Statuscode, der Erfolg oder Fehler sowie zusätzliche Debuginformationen angibt. Verwenden Sie ein Netzwerkablaufverfolgungstool, um diesen Code, fehlertyp und andere Parameter zu lesen. Die vollständige Liste finden Sie unter Partner Center-Fehlercodes.

Diese Methode gibt die folgenden Fehlercodes zurück:

HTTP-Statuscode	Fehlercode	BESCHREIBUNG
404	400013	Das Produkt wurde nicht gefunden.
404	400018	SKU wurde nicht gefunden.
404	400019	Verfügbarkeit nicht gefunden. Dieser Fehler kann beim Auschecken eines Warenkorbs auftreten. Partner, die diesen Fehler erhalten, sollten einen neuen GET ausgeben, um sicherzustellen, dass sie über die aktuelle Verfügbarkeits-ID verfügen und den Warenkorb erneut testen.

Antwortbeispiel für Azure VM Reservations (Azure Plan)

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": []
        }
    }
}

Antwortbeispiel für neue commerce-lizenzbasierte Dienste

Hinweis

Die neuen Commerce-Umgebungen für lizenzbasierte Dienste enthalten zahlreiche neue Funktionen und stehen allen Cloud Solution Providern (CSP) zur Verfügung. Weitere Informationen finden Sie in der Übersicht über neue Commerce-Erfahrungen.

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": []
        }
    }
}

Freigeben über