Abrufen eines Angebots mittels ID

anwendbar auf: Partnerzentrum | Partnerzentrum betrieben von 21Vianet | Partnerzentrum für die Microsoft-Cloud für die US-Regierung

Ruft eine Angebotsressource ab, die mit der Angebots-ID übereinstimmt.

Voraussetzungen

• Anmeldeinformationen wie unter Partner Center-Authentifizierung beschrieben. Dieses Szenario unterstützt die Authentifizierung mit eigenständigen App- und App+Benutzeranmeldeinformationen.

• Eine Angebots-ID.

C#

Um ein bestimmtes Angebot nach ID zu suchen, verwenden Sie Ihre IAggregatePartner.Offers-Sammlung , richten Sie das Land/die Region mit einem Aufruf von ByCountry() ein, und rufen Sie dann die ByID()- Methode auf. Rufen Sie dann die Methode Get() oder Get Async() auf.

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

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

Beispiel: Konsolentest-App. Projekt: PartnerSDK.FeatureSample Klasse: GetOffer.cs

Java

Das Partner Center Java SDK kann zum Verwalten von Partner Center-Ressourcen verwendet werden. Es handelt sich um ein Open-Source-Projekt, das von der Partnercommunity verwaltet wird und von Microsoft nicht offiziell unterstützt wird. Sie können Hilfe von der Community erhalten oder ein Issue auf GitHub öffnen, wenn ein Problem auftritt.

Um ein bestimmtes Angebot nach ID zu suchen, verwenden Sie Ihre IAggregatePartner.getOffers-Funktion , richten Sie das Land/die Region mit einem Aufruf der byCountry( )-Funktion ein, und rufen Sie dann die byID()- Funktion auf. Rufen Sie dann die Funktion get() auf.

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

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

PowerShell

Das Partner Center PowerShell-Modul kann zum Verwalten von Partner Center-Ressourcen verwendet werden. Es handelt sich um ein Open-Source-Projekt, das von der Partnercommunity verwaltet wird und von Microsoft nicht offiziell unterstützt wird. Sie können Hilfe von der Community erhalten oder ein Issue auf GitHub öffnen, wenn ein Problem auftritt.

Um ein bestimmtes Angebot anhand der ID zu suchen, führen Sie den Befehl Get-PartnerOffer aus, und geben Sie die Parameter CountryCode und OfferId an.

# $countryCode
# $offerId

Get-PartnerOffer -Country $countryCode -OfferId $offerId

REST-Anforderung

Anforderungssyntax

Methode	Anforderungs-URI
ERHALTEN	{baseURL}/v1/offers/{angebots-id}?country={country-id} HTTP/1.1

URI-Parameter

Name	Typ	Erforderlich	BESCHREIBUNG
Angebots-ID	GUID	Ja	Eine GUID, die dem Angebot entspricht.
Länder-ID	String	Ja	Die Länder-/Regions-ID.

Anforderungsheader

• Eine Gebietsschema-ID im Format einer Zeichenfolge ist erforderlich. Weitere Informationen finden Sie unter Partner Center REST-Header.

Anfragekörper

Keiner.

Beispielanfrage

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-Antwort

Bei erfolgreicher Ausführung gibt diese Methode eine Offer-Ressource im Antworttext zurück.

Antworterfolgs- und Fehlercodes

Jede Antwort enthält einen HTTP-Statuscode, der Erfolg oder Fehler sowie zusätzliche Debuginformationen angibt. Verwende ein Tool für die Netzwerkablaufverfolgung, um diesen Code, den Fehlertyp und zusätzliche Parameter zu lesen. Die vollständige Liste findest du unter Fehlercodes.

Antwortbeispiel

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"
    }
}