Få ett erbjudande genom ID

gäller för: Partnercenter | Partnercenter som drivs av 21Vianet | Partnercenter för Microsoft Cloud for US Government

Hämtar en erbjudande resurs som matchar erbjudande-ID:t.

Förutsättningar

• Autentiseringsuppgifter enligt beskrivningen i Partner Center-autentisering. Det här scenariot stöder autentisering med både fristående app- och App+User-autentiseringsuppgifter.

• Ett erbjudande-ID.

C#

Om du vill hitta ett specifikt erbjudande efter ID använder du din IAggregatePartner.Offers-samling, etablerar landet/regionen med ett anrop till ByCountry()och anropar sedan metoden ByID(). Anropa därefter metoden Get() eller Get Async().

// IAggretagePartner partnerOperations;
// string countryCode;
// string offerId;

// retrieve the offer
var offer = partnerOperations.Offers.ByCountry(countryCode).ById(offerId).Get();

Exempel: Testapp för konsol. Projekt: PartnerSDK.FeatureSample Klass: GetOffer.cs

Java

Java SDK för Partnercenter kan användas för att hantera Partnercenter-resurser. Det är ett projekt med öppen källkod som underhålls av partnercommunityn och stöds inte officiellt av Microsoft. Du kan få hjälp från communityn eller öppna ett problem på GitHub om du får problem.

Om du vill hitta ett specifikt erbjudande efter ID använder du funktionen IAggregatePartner.getOffers, etablerar landet/regionen med ett anrop till funktionen byCountry() och anropar sedan funktionen byID(). Anropa sedan funktionen get().

// IAggretagePartner partnerOperations;
// String countryCode;
// String offerId;

// Retrieve the offer
Offer offer = partnerOperations.getOffers().byCountry(countryCode).byId(offerId).get();

PowerShell

PowerShell-modulen Partner Center kan användas för att hantera Partnercenter-resurser. Det är ett projekt med öppen källkod som underhålls av partnercommunityn och stöds inte officiellt av Microsoft. Du kan få hjälp från communityn eller öppna ett problem på GitHub om du får problem.

Om du vill hitta ett specifikt erbjudande efter ID kör du kommandot Get-PartnerOffer och anger parametrarna CountryCode och OfferId.

# $countryCode
# $offerId

Get-PartnerOffer -Country $countryCode -OfferId $offerId

REST-begäran

Syntax för begäran

Metod	Förfrågnings-URI
FÅ	{baseURL}/v1/offers/{offer-id}?country={country-id} HTTP/1.1

URI-parametern

Namn	Typ	Krävs	Beskrivning
erbjudande-ID	guide	Y	Ett GUID som motsvarar erbjudandet.
land-id	sträng	Y	Lands-/region-ID.

Begäransrubriker

• Ett locale-ID som är formaterat som en sträng krävs. Mer information finns i REST-huvuden för Partnercenter.

Begärandetext

Ingen.

Exempel på begäran

GET https://api.partnercenter.microsoft.com/v1/offers/<offer-id>?country=<country-id> HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: ac943950-ba3d-47a0-bd2a-c5617a7fefe8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: <locale-id>
Connection: Keep-Alive

REST-svar

Om det lyckas returnerar den här metoden en Erbjudande resurs i svarstexten.

Svarsframgång och felkoder

Varje svar levereras med en HTTP-statuskod som anger lyckad eller misslyckad och ytterligare felsökningsinformation. Använd ett verktyg för nätverksspårning för att läsa den här koden, feltypen och ytterligare parametrar. Den fullständiga listan finns i Felkoder.

Svarsexempel

HTTP/1.1 200 OK
Content-Length: 1918
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: ac943950-ba3d-47a0-bd2a-c5617a7fefe8
Date: Mon, 23 Nov 2015 23:13:01 GMT

{
    "id": "031C9E47-4802-4248-838E-778FB1D2CC05",
    "name": "Office 365 Business Premium",
    "description": "For businesses with 1 to 300 users that need the latest desktop version of Office,
                    plus anywhere access to email, filesharing, and online conferencing.",
    "minimumQuantity": 1,
    "maximumQuantity": 300,
    "rank": 56,
    "uri": "/3c95518e-8c37-41e3-9627-0ca339200f53/Offers/031C9E47-4802-4248-838E-778FB1D2CC05",
    "locale": "en-us",
    "country": "US",
    "category": {
        "id": "SmallBusiness_Key",
        "name": "Small Business",
        "rank": 30,
        "locale": "en-us",
        "country": "US",
        "attributes": {
            "objectType": "OfferCategory"
        }
    },
    "prerequisiteOffers": [],
    "isAddOn": false,
    "isAvailableForPurchase": true,
    "billing": "license",
    "isAutoRenewable": true,
    "product": {
        "id": "f245ecc8-75af-4f8e-b61f-27d8114de5f3",
        "name": "Office 365 Business Premium",
        "unit": "Licenses"
    },
    "unitType": "Licenses",
    "links": {
        "learnMore": {
            "uri": "http: //g.microsoftonline.com/0BXPS00en/909",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "Offer"
    }
}