Ottenere un'offerta in base all'ID
Si applica a: Centro per i partner | Centro per i partner gestito da 21Vianet | Centro per i partner per Microsoft Cloud per il governo degli Stati Uniti
Ottiene una risorsa offerta corrispondente all'ID offerta.
Prerequisiti
Credenziali descritte in Autenticazione del Centro per i partner. Questo scenario supporta l'autenticazione con le credenziali app autonome e App+Utente.
ID offerta.
C#
Per trovare un'offerta specifica in base all'ID, usare la raccolta IAggregatePartner.Offers, stabilire il paese/area geografica con una chiamata a ByCountry(), quindi chiamare il metodo ByID(). Chiamare quindi il metodo Get() o Get Async().
// IAggretagePartner partnerOperations;
// string countryCode;
// string offerId;
// retrieve the offer
var offer = partnerOperations.Offers.ByCountry(countryCode).ById(offerId).Get();
Esempio: App di test della console. Project: PartnerSDK.FeatureSample Class: GetOffer.cs
Java
L'SDK Java del Centro per i partner può essere usato per gestire le risorse del Centro per i partner. Si tratta di un progetto open source gestito dalla community partner e non ufficialmente supportato da Microsoft. In caso di problemi, puoi richiedere assistenza alla community o aprire un problema in GitHub.
Per trovare un'offerta specifica per ID, usare la funzione IAggregatePartner.getOffers, stabilire il paese/area geografica con una chiamata alla funzione byCountry() e quindi chiamare la funzione byID(). Chiamare quindi la funzione get().
// IAggretagePartner partnerOperations;
// String countryCode;
// String offerId;
// Retrieve the offer
Offer offer = partnerOperations.getOffers().byCountry(countryCode).byId(offerId).get();
PowerShell
Il modulo PowerShell del Centro per i partner può essere usato per gestire le risorse del Centro per i partner. Si tratta di un progetto open source gestito dalla community partner e non ufficialmente supportato da Microsoft. In caso di problemi, puoi richiedere assistenza alla community o aprire un problema in GitHub.
Per trovare un'offerta specifica in base all'ID, eseguire il comando Get-PartnerOffer e specificare i parametri CountryCode e OfferId.
# $countryCode
# $offerId
Get-PartnerOffer -Country $countryCode -OfferId $offerId
Richiesta REST
Sintassi della richiesta
Metodo | URI della richiesta |
---|---|
GET | {baseURL}/v1/offers/{offer-id}?country={country-id} HTTP/1.1 |
Parametro URI
Nome | Tipo | Necessario | Descrizione |
---|---|---|---|
offer-id | guid | S | GUID corrispondente all'offerta. |
country-id | string | S | ID del paese o dell'area. |
Intestazioni delle richieste
- È necessario un ID impostazioni locali formattato come stringa. Per altre informazioni, vedi Intestazioni REST del Centro per i partner.
Testo della richiesta
Nessuno.
Esempio di richiesta
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: 7c1f6619-c176-4040-a88f-2c71f3ba4533
X-Locale: <locale-id>
Connection: Keep-Alive
Risposta REST
In caso di esito positivo, questo metodo restituisce una risorsa Offer nel corpo della risposta.
Codici di errore e di esito della risposta
Ogni risposta viene fornita con un codice di stato HTTP che ne indica l'esito e con informazioni di debug aggiuntive. Usa uno strumento di traccia di rete per leggere il codice, il tipo di errore e parametri aggiuntivi. Per l'elenco completo, vedi Codici di errore.
Esempio di risposta
HTTP/1.1 200 OK
Content-Length: 1918
Content-Type: application/json
MS-CorrelationId: 7c1f6619-c176-4040-a88f-2c71f3ba4533
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"
}
}
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per