Abrufen der Verfügbarkeit nach ID
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, Standard von der Partnercommunity unterstützt und nicht offiziell von Microsoft 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, Standard von der Partnercommunity unterstützt und nicht offiziell von Microsoft 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. |
Anforderungsheader
Weitere Informationen finden Sie unter Partner Center-REST-Header.
Anforderungstext
Keine.
Beispiel für eine Anfrage
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
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 Aufschluss darüber gibt, ob der Vorgang erfolgreich war, sowie ggf. zusätzliche Debuginformationen. Verwende ein Tool für die Netzwerkablaufverfolgung, um diesen Code, den Fehlertyp und zusätzliche 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: 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": []
}
}
}
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: 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
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für