Een lijst met categorieën van aanbiedingen per markt ophalen

Artikel
08/23/2023

Van toepassing op: Partnercentrum | Partnercentrum beheerd door 21Vianet | Partnercentrum voor Microsoft Cloud for US Government

In dit artikel wordt beschreven hoe u een verzameling kunt verkrijgen die alle aanbiedingscategorieën in een bepaald land/regio en een bepaalde landinstelling bevat.

Vereisten

Referenties zoals beschreven in Partnercentrum-verificatie. Dit scenario ondersteunt verificatie met zowel zelfstandige app- als App+User-referenties.

C#

Een lijst met aanbiedingscategorieën in een bepaald land/regio en een bepaalde landinstelling ophalen:

Gebruik uw verzameling IAggregatePartner.Operations om de methode With() aan te roepen voor een bepaalde context.
Controleer de eigenschap OfferCategories van het resulterende object.

// IAggregatePartner partnerOperations;

ResourceCollection<OfferCategory> offerCategoryResults = partnerOperations.With(RequestContextFactory.Instance.Create()).OfferCategories.ByCountry("US").Get();

Zie het volgende voor een voorbeeld:

Voorbeeld: Consoletest-app
Project: PartnerSDK.featureSample
Klasse: PartnerSDK.featureSample

REST-aanvraag

Aanvraagsyntaxis

Methode	Aanvraag-URI
GET	{baseURL}/v1/offercategories?country={country-id} HTTP/1.1

URI-parameter

Deze tabel bevat de vereiste queryparameters om de aanbiedingscategorieën op te halen.

Naam	Type	Vereist	Beschrijving
land-id	tekenreeks	J	De land-/regio-id.

Aanvraagheaders

Een landinstelling-id die is opgemaakt als een tekenreeks is vereist.

Zie Rest-headers van partnercentrum voor meer informatie.

Aanvraagbody

Geen.

Voorbeeld van aanvraag

GET https://api.partnercenter.microsoft.com/v1/offercategories?country=<country-id> HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 4fb54bd5-a4c3-4fac-955f-9b6e3436d606
MS-CorrelationId: 47882653-eaed-4a2e-a552-1070a3fa1089
X-Locale: <locale-id>
Connection: Keep-Alive

REST-antwoord

Als dit lukt, retourneert deze methode een verzameling OfferCategory-resources in de antwoordtekst.

Geslaagde respons- en foutcodes

Elk antwoord wordt geleverd met een HTTP-statuscode die een geslaagde of mislukte status aangeeft en aanvullende informatie over foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en aanvullende parameters te lezen. Zie Foutcodes voor een volledige lijst.

Voorbeeld van antwoord

HTTP/1.1 200 OK
Content-Length: 1184
Content-Type: application/json
MS-CorrelationId: 47882653-eaed-4a2e-a552-1070a3fa1089
MS-RequestId: 4fb54bd5-a4c3-4fac-955f-9b6e3436d606
Date: Thu, 26 Nov 2015 00:07:10 GMT

{
    "totalCount": 4,
    "items": [{
        "id": "Enterprise_Key",
        "name": "Enterprise",
        "rank": 20,
        "locale": "en-us",
        "country": "US",
        "attributes": {
            "objectType": "OfferCategory"
        }
    },
    {
        "id": "SmallBusiness_Key",
        "name": "SmallBusiness",
        "rank": 30,
        "locale": "en-us",
        "country": "US",
        "attributes": {
            "objectType": "OfferCategory"
        }
    },
    {
        "id": "Government_Key",
        "name": "Government",
        "rank": 40,
        "locale": "en-us",
        "country": "US",
        "attributes": {
            "objectType": "OfferCategory"
        }
    },
    {
        "id": "Internal_Key",
        "name": "Internal",
        "rank": 100,
        "locale": "en-us",
        "country": "US",
        "attributes": {
            "objectType": "OfferCategory"
        }
    }],
    "attributes": {
        "objectType": "Collection"
    }
}

Delen via