Katalóguselemek leltárának ellenőrzése a Partnerközpont API-kkal

A katalóguselemek adott készletének ellenőrzése.

Előfeltételek

• Hitelesítő adatok a Partnerközpont hitelesítésében leírtak szerint. Ez a forgatókönyv támogatja az önálló alkalmazással és az App+Felhasználói hitelesítő adatokkal való hitelesítést is.

• Egy vagy több termékazonosító. Igény szerint termékváltozat-azonosítók is megadhatóak.

• A megadott termék/termékváltozat-azonosító(ok) által hivatkozott termékváltozat(ok) készletének ellenőrzéséhez szükséges további környezetek. Ezek a követelmények terméktípusonként/termékváltozatonként változhatnak, és az SKUInventoryVariables tulajdonságából határozhatók meg.

C#

A leltár ellenőrzéséhez hozzon létre egy InventoryCheckRequest objektumot egy InventoryItem objektummal minden ellenőrizendő elemhez. Ezután használjon egy IAggregatePartner.Extensions-tartozékot, hatókört a Termékre, majd válassza ki az országot/régiót a ByCountry() metódussal. Végül hívja meg a CheckInventory() metódust az InventoryCheckRequest objektummal.

IAggregatePartner partnerOperations;
string customerId;
string subscriptionId;
string countryCode;
string productId;

// Build the inventory check request details object.
var inventoryCheckRequest = new InventoryCheckRequest()
{
    TargetItems = new InventoryItem[]{ new InventoryItem { ProductId = productId } },
    InventoryContext = new Dictionary<string, string>()
    {
      { "customerId", customerId },
      { "azureSubscriptionId", subscriptionId }
      { "armRegionName", armRegionName }
    }
};

// Get the inventory results.
var inventoryResults = partnerOperations.Extensions.Product.ByCountry(countryCode).CheckInventory(inventoryCheckRequest);

REST-kérés

Kérés szintaxisa

Metódus	Kérés URI-ja
POST	{baseURL}/v1/extensions/product/checkInventory?country={country-code} HTTP/1.1

URI-paraméter

A leltár ellenőrzéséhez használja az alábbi lekérdezési paramétert.

Név	Típus	Kötelező	Leírás
országkód	sztring	Igen	Egy ország/régió azonosítója.

Kérésfejlécek

További információ: Partnerközpont – REST fejlécek.

Kérés törzse

A készletkérelem részletei, amelyek egy vagy több InventoryItem-erőforrást tartalmazó InventoryCheckRequest-erőforrásból állnak.

Győződjön meg arról, hogy a kérelem törzsében megadott Azure-előfizetés regisztrálva van, és engedélyezve van az Azure RI-k megvásárlásához. A regisztrációs folyamat részleteiért lásd : Előfizetés regisztrálása.

Példa kérése

POST https://api.partnercenter.microsoft.com/v1/extensions/product/checkinventory?country=US HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: d1b1981a-e088-4610-870a-eebec96d6bcd
MS-CorrelationId: 4acb26a1-3536-4081-bc7d-092869a4961a
X-Locale: en-US
MS-PartnerCenter-Client: Partner Center .NET SDK
Content-Type: application/json

{"TargetItems":[{"ProductId":"DZH318Z0BQ3P"}],"InventoryContext":{"customerId":"d6bf25b7-e0a8-4f2d-a31b-97b55cfc774d","azureSubscriptionId":"3A231FBE-37FE-4410-93FD-730D3D5D4C75","armRegionName":"Europe"}}

Fontos

2023 júniusától a partnerközpont .NET SDK legújabb, 3.4.0-s kiadását archiváljuk. Az SDK-kiadást letöltheti a GitHubról, valamint egy hasznos információkat tartalmazó olvasófájlt.

A partnereket arra ösztönzik, hogy továbbra is használják a Partnerközpont REST API-jait.

REST-válasz

Ha sikeres, a válasz törzse a korlátozás részleteivel feltöltött InventoryItem objektumok gyűjteményét tartalmazza, ha vannak ilyenek.

Feljegyzés

Ha egy bemeneti InventoryItem elem olyan elemet jelöl, amely nem található a katalógusban, akkor az nem fog szerepelni a kimeneti gyűjteményben.

Válasz sikeresség és hibakódok

Minden válaszhoz tartozik egy HTTP-állapotkód, amely jelzi a sikert vagy a hibát, valamint további hibakeresési információkat. A kód, a hibatípus és a további paraméterek olvasásához használjon hálózati nyomkövetési eszközt. A teljes listát a Partnerközpont hibakódjaiban találja.

Példa válaszra

HTTP/1.1 200 OK
Content-Length: 1021
Content-Type: application/json; charset=utf-8
MS-CorrelationId: 4acb26a1-3536-4081-bc7d-092869a4961a
MS-RequestId: d1b1981a-e088-4610-870a-eebec96d6bcd
X-Locale: en-US
[
    {
        "productId": "DZH318Z0BQ3P",
        "skuId": "0039",
        "isRestricted": true,
        "restrictions": [
            {
                "reasonCode": "NotAvailableForSubscription",
                "description": "Restriction identified of type 'Location' with values 'japanwest'.",
                "properties": {
                    "type": "Location",
                    "values": "japanwest"
                }
            }
        ]
    },
    {
        "productId": "DZH318Z0BQ3P",
        "skuId": "0038",
        "isRestricted": true,
        "restrictions": [
            {
                "reasonCode": "NotAvailableForSubscription",
                "description": "Restriction identified of type 'Location' with values 'japanwest'.",
                "properties": {
                    "type": "Location",
                    "values": "japanwest"
                }
            }
        ]
    },
    {
        "productId": "DZH318Z0BQ3P",
        "skuId": "000S",
        "isRestricted": false,
        "restrictions": []
    },
    {
        "productId": "DZH318Z0BQ3P",
        "skuId": "0011",
        "isRestricted": false,
        "restrictions": []
    }
]