Pobierz dostępność według identyfikatora

Artykuł
03/07/2025

Pobiera dostępność określonego produktu i jednostki SKU przy użyciu identyfikatora dostępności. Identyfikatory dostępności są modyfikowalne i dynamiczne, są regularnie ponownie wyświetlane. Partnerzy powinni zawsze upewnić się, że uzyskują bieżącą dostępność podczas przesyłania pozycji wiersza koszyka lub wykonywania innych działań, które wymagają identyfikatora dostępności.

Wymagania wstępne

Poświadczenia zgodnie z opisem w temacie Uwierzytelnianie w Centrum partnerskim. Ten scenariusz obsługuje uwierzytelnianie zarówno przy użyciu poświadczeń samej aplikacji, jak i poświadczeń aplikacja+użytkownik.
Identyfikator produktu.
Identyfikator jednostki SKU.
Identyfikator dostępności.

C#

Aby uzyskać szczegółowe informacje o określonej dostępności, zacznij od wykonania kroków opisanych w Uzyskaj jednostkę SKU według identyfikatora aby uzyskać interfejs dla określonych operacji jednostki SKU. Z wynikowego interfejsu wybierz właściwość Dostępności, aby uzyskać interfejs z dostępnymi operacjami dla Dostępności. Następnie przekaż identyfikator dostępności do metody ById(), aby uzyskać operacje dla tej konkretnej dostępności, a następnie wywołaj metodę Get() lub GetAsync(), aby pobrać szczegóły dostępności.

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

Zestaw Partner Center Java SDK może być używany do zarządzania zasobami Partner Center. Jest to projekt typu open source obsługiwany przez społeczność partnerów i nie jest oficjalnie obsługiwany przez firmę Microsoft. Jeśli wystąpi problem, możesz uzyskać pomoc od społeczności lub otworzyć problem w usłudze GitHub .

Aby uzyskać szczegółowe informacje o określonej dostępności, zacznij od wykonania kroków opisanych w Uzyskaj jednostkę SKU według ID, aby uzyskać interfejs do operacji określonej jednostki SKU. Z wynikowego interfejsu wybierz funkcję getAvailabilities , aby uzyskać dostęp do dostępnych operacji dla dostępności. Następnie przekaż identyfikator dostępności do funkcji byId(), aby uzyskać operacje dla tej konkretnej dostępności, a następnie wywołaj funkcję get(), aby pobrać szczegóły dostępności.

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

Moduł PowerShell Partner Center może służyć do zarządzania zasobami Partner Center. Jest to projekt typu open source obsługiwany przez społeczność partnerów i nie jest oficjalnie obsługiwany przez firmę Microsoft. Jeśli wystąpi problem, możesz uzyskać pomoc od społeczności lub otworzyć problem w usłudze GitHub .

Aby uzyskać szczegółowe informacje o określonej dostępności, wykonaj polecenie Get-PartnerProductAvailability i określ parametry AvailabilityId, CountryCode, ProductId i SkuId , aby pobrać szczegóły dostępności.

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

Żądanie REST

Składnia żądania

Metoda	URI żądania
GET	{baseURL}/v1/products/{product-id}/skus/{sku-id}/availabilities/{availability-id}?country={country-code} HTTP/1.1

Parametr identyfikatora URI

Użyj następującej ścieżki i parametrów zapytania, aby uzyskać określoną dostępność przy użyciu identyfikatora dostępności.

Nazwisko	Typ	Wymagane	opis
identyfikator produktu	string	Tak	Ciąg sformatowany jako GUID, który identyfikuje produkt.
SKU-ID	string	Tak	Ciąg sformatowany jako identyfikator GUID, który identyfikuje SKU.
identyfikator dostępności	string	Tak	Ciąg sformatowany w formacie GUID, który identyfikuje dostępność.
kod kraju	string	Tak	Identyfikator kraju/regionu.
UwzględnijStanCykluŻycia	string	Nie	Ciąg znaków, który może być ustawiony na wartość true, aby zwracać wartości stanu cyklu życia dla ofert opartych na licencjach New Commerce. Te wartości nie zostaną zwrócone, jeśli flaga nie zostanie dołączona.

Nagłówki żądań

Aby uzyskać więcej informacji, zobacz Nagłówki REST dla Centrum Partnerów.

Treść żądania

Brak.

Przykład żądania

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

Ważne

Od czerwca 2023 r. najnowsza wersja zestawu .NET SDK Centrum partnerskiego 3.4.0 jest teraz archiwizowana. Możesz pobrać wersję zestawu SDK z usługi GitHub wraz z plikiem readme zawierającym przydatne informacje.

Zachęcamy partnerów do dalszego korzystania z REST API Centrum Partnerów.

Odpowiedź REST

W przypadku powodzenia treść odpowiedzi zawiera zasób dostępności.

Kody sukcesu i błędów odpowiedzi

Każda odpowiedź zawiera kod stanu HTTP, który wskazuje powodzenie lub niepowodzenie i dodatkowe informacje o debugowaniu. Użyj narzędzia do śledzenia sieci, aby odczytać ten kod, typ błędu i inne parametry. Aby uzyskać pełną listę, zobacz Kody błędów Centrum partnerskiego.

Ta metoda zwraca następujące kody błędów:

Kod stanu HTTP	Kod błędu	opis
404	400013	Nie można odnaleźć produktu.
404	400018	Nie odnaleziono SKU.
404	400019	Nie można odnaleźć dostępności. Ten błąd może wystąpić podczas realizowania zakupu koszyka. Partnerzy, którzy otrzymują ten błąd, powinni wysłać nowe żądanie GET, aby upewnić się, że mają bieżący identyfikator dostępności i ponowić próbę sfinalizowania zakupu koszyka.

Przykład odpowiedzi dla rezerwacji maszyn wirtualnych w usłudze Azure (plan Azure)

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

Przykład odpowiedzi dla nowych usług opartych na licencjach handlowych

Uwaga

Nowe funkcje handlowe dla usług opartych na licencjach obejmują wiele nowych funkcji i są dostępne dla wszystkich dostawców rozwiązań w chmurze (CSP). Aby uzyskać więcej informacji, zobacz omówienie nowych środowisk handlowych.

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

Udostępnij za pośrednictwem