Получите информацию о доступности по идентификатору

Статья
03/07/2025

Возвращает доступность указанного продукта и номера SKU, используя идентификатор доступности. Идентификаторы доступности являются изменяемыми и динамическими, они регулярно перезаписываются. Партнеры всегда должны удостовериться, что получают актуальную информацию о доступности, при отправке элементов строки корзины или выполнении других операций, требующих идентификатора доступности.

Предварительные условия

Учетные данные, как описано в разделе Аутентификация в Центре партнеров. Этот сценарий поддерживает проверку подлинности с помощью как самостоятельных учетных данных приложения, так и учетных данных приложения и пользователя.
Идентификатор продукта.
Идентификатор SKU.
Идентификатор доступности.

C#

Чтобы получить сведения о конкретной доступности, начните с действий, описанных в разделе "Получение номера SKU по идентификатору ", чтобы получить интерфейс для определенных операций SKU . В полученном интерфейсе выберите свойство Доступности, чтобы открыть интерфейс с доступными операциями для Доступностей. После этого передайте идентификатор доступности методу ById(), чтобы получить операции для этой конкретной доступности, а затем вызовите Get() или GetAsync(), чтобы получить сведения о доступности.

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

Пакет SDK для Java центра партнеров можно использовать для управления ресурсами Центра партнеров. Это проект с открытым исходным кодом, поддерживаемый сообществом партнеров и официально не поддерживаемый корпорацией Майкрософт. При необходимости вы можете получить помощь от сообщества или опубликовать проблему в GitHub.

Чтобы получить сведения о конкретной доступности, начните с действий, описанных в разделе "Получение номера SKU по идентификатору ", чтобы получить интерфейс для определенных операций SKU . В полученном интерфейсе выберите функцию getAvailabilities, чтобы получить интерфейс с доступными операциями для управления доступностями. После этого передайте идентификатор доступности функции byId(), чтобы получить операции для этой конкретной доступности, а затем вызовите функцию get(), чтобы получить сведения о доступности.

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

Модуль PowerShell Центра партнеров можно использовать для управления ресурсами Центра партнеров. Это проект с открытым исходным кодом, поддерживаемый сообществом партнеров и официально не поддерживаемый корпорацией Майкрософт. При необходимости вы можете получить помощь от сообщества или опубликовать проблему в GitHub.

Чтобы получить сведения о конкретной доступности, выполните get-PartnerProductAvailabilityи укажите параметры AvailabilityId, CountryCode, ProductId и SkuId, чтобы получить сведения о доступности.

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

Запрос REST

Синтаксис запроса

Способ	URI запроса
GET	{baseURL}/v1/products/{product-id}/skus/{sku-id}/availabilities/{availability-id}?country={country-code} HTTP/1.1

Параметр URI

Используйте следующий путь и параметры запроса, чтобы получить определенную доступность с помощью идентификатора доступности.

Имя.	Тип	Обязательно	Описание
идентификатор продукта	строка	Да	Строка с форматированием GUID, определяющая продукт.
идентификатор SKU	строка	Да	Строка с форматированием GUID, определяющая номер SKU.
идентификатор доступности	строка	Да	Строка в формате GUID, идентифицирующая наличие.
код страны	строка	Да	Идентификатор страны или региона.
ВключитьСостояниеЖизненногоЦикла	строка	Нет	Строковый флаг, который можно установить в значение true, чтобы возвращать значения состояния жизненного цикла для предложений на основе лицензий New Commerce. Эти значения не будут возвращены, если флаг не включен.

Заголовки запросов

Для получения более подробной информации см. заголовки REST в Центре партнеров.

Текст запроса

Нет.

Пример запроса

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

Внимание

По состоянию на июнь 2023 г. последняя версия пакета SDK для .NET для Центра партнеров 3.4.0 теперь архивируется. Вы можете скачать релиз SDK на GitHub вместе с файлом readme, содержащим полезные сведения.

Партнерам рекомендуется продолжать использовать REST API Центра партнеров.

Ответ REST

В случае успеха, тело ответа содержит ресурс Availability.

Коды успешного и ошибочного ответа

Каждый ответ содержит код состояния HTTP, указывающий на успешность или сбой и дополнительные сведения об отладке. Используйте средство трассировки сети для чтения этого кода, типа ошибки и других параметров. Полный список см. в разделе "Коды ошибок Центра партнеров".

Этот метод возвращает следующие коды ошибок:

Код состояния HTTP	Код ошибки	Описание
404	400013	Продукт не найден.
404	400018	Номер SKU не найден.
404	400019	Доступность не найдена. Эта ошибка может возникать при оформлении заказа. Партнеры, которые получают эту ошибку, должны выполнить новый GET-запрос, чтобы убедиться, что у них актуальный идентификатор доступности, и повторить проверку наличия товаров в корзине.

Пример ответа на резервирование виртуальных машин в Azure (план 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": []
        }
    }
}

Пример ответа для новых коммерческих лицензионных услуг

Примечание.

Новые коммерческие возможности для служб на основе лицензий включают множество новых функций и доступны для всех поставщиков облачных решений. Для получения дополнительной информации см. обзор новых коммерческих возможностей.

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

Поделиться через