Obter suplementos para um ID de oferta
Aplica-se a: Partner Center | Partner Center operado pela 21Vianet | Partner Center for Microsoft Cloud for US Government
Como obter os complementos para um ID de oferta.
Pré-requisitos
Credenciais conforme descrito na autenticação do Partner Center. Este cenário oferece suporte à autenticação com credenciais autônomas de Aplicativo e Aplicativo+Usuário.
Um ID de oferta. Se não tiver o ID da oferta, consulte Obter uma lista de ofertas para um mercado.
C#
Para obter os complementos para uma oferta por ID, primeiro chame o método IAggregatePartner.Offers.ByCountry com o código do país para obter uma interface para oferecer operações com base em determinado país/região. Em seguida, chame o método ByID com o ID da oferta para identificar a oferta cujos complementos você deseja recuperar. Em seguida, use a propriedade AddOns para obter uma interface para operações de complemento para a oferta atual. Finalmente, chame o método Get ou GetAsync para obter uma coleção de todos os complementos para a oferta especificada.
// IAggregatePartner partnerOperations;
// string offerId;
// string countryCode;
var offerAddOns = partnerOperations.Offers.ByCountry(countryCode).ById(offerId).AddOns.Get();
Exemplo: Aplicativo de teste de console. Projeto: Exemplo de SDK do Partner Center Classe: GetOffer.cs
Pedido REST
Sintaxe da solicitação
Método | URI do pedido |
---|---|
GET | {baseURL}/v1/offers/{offer-id}/addons?country={country-code} HTTP/1.1 |
Parâmetros de URI
Use os seguintes parâmetros para fornecer o ID da oferta e o código do país.
Nome | Tipo | Obrigatório | Descrição |
---|---|---|---|
ID da oferta | GUID | Y | Um GUID que identifica a oferta. |
país | string | Y | O código do país (por exemplo US ). |
Cabeçalhos do pedido
Para obter mais informações, consulte Cabeçalhos REST do Partner Center.
Corpo do pedido
Nenhum.
Exemplo de solicitação
GET https://api.partnercenter.microsoft.com/v1/offers/195416C1-3447-423A-B37B-EE59A99A19C4/addons?country=us HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: c15e829e-ecc7-42c2-8a4b-5e6961f4e3f8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Host: api.partnercenter.microsoft.com
Resposta do REST
Se bem-sucedido, esse método retorna uma coleção de objetos Offer no corpo da resposta.
Códigos de sucesso e erro de resposta
Cada resposta vem com um código de status HTTP que indica sucesso ou falha e informações adicionais de depuração. Use uma ferramenta de rastreamento de rede para ler esse código, tipo de erro e parâmetros adicionais. Para obter a lista completa, consulte Códigos de erro REST do Partner Center.
Exemplo de resposta
HTTP/1.1 200 OK
Content-Length: 3137
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: c15e829e-ecc7-42c2-8a4b-5e6961f4e3f8
MS-CV: P8xjUcSeY0ithZ9S.0
MS-ServerId: 202010406
Date: Wed, 01 Feb 2017 22:37:58 GMT
{
"totalCount": 2,
"items": [{
"id": "2828BE95-46BA-4F91-B2FD-0BEF192ECF60",
"name": "Exchange Online Archiving for Exchange Online",
"description": "A personal e-mail archive for users who have mailboxes on Exchange Server 2010 or later.",
"minimumQuantity": 1,
"maximumQuantity": 10000000,
"rank": 200,
"uri": "/3c95518e-8c37-41e3-9627-0ca339200f53/Offers/2828BE95-46BA-4F91-B2FD-0BEF192ECF60",
"locale": "en-US",
"country": "US",
"category": {
"id": "",
"name": "",
"rank": 0,
"locale": "en-us",
"country": "US",
"attributes": {
"objectType": "OfferCategory"
}
},
"prerequisiteOffers": ["35A36B80-270A-44BF-9290-00545D350866", "6FBAD345-B7DE-42A6-B6AB-79B363D0B371", "91FD106F-4B2C-4938-95AC-F54F74E9A239", "195416C1-3447-423A-B37B-EE59A99A19C4", "22A70120-4078-4926-9592-39ED91CB9C01", "2A727AE4-F201-497D-A9D6-C6A892DF4A87", "BD938F12-058F-4927-BBA3-AE36B1D2501C", "031C9E47-4802-4248-838E-778FB1D2CC05", "B2016E73-D9AD-4758-B8B8-D5C001BDF411", "AA98032C-5403-472F-B24F-F6654846B15D"],
"isAddOn": true,
"isAvailableForPurchase": true,
"billing": "license",
"isAutoRenewable": true,
"salesGroupId": "1",
"product": {
"id": "EE02FD1B-340E-4A4B-B355-4A514E4C8943",
"name": "Exchange Online Archiving for Exchange Online",
"unit": "Licenses"
},
"unitType": "Licenses",
"links": {
"learnMore": {
"uri": "http://g.microsoftonline.com/0BXPS00en-us/1302",
"method": "GET",
"headers": []
},
"self": {
"uri": "/offers/2828BE95-46BA-4F91-B2FD-0BEF192ECF60?country=US",
"method": "GET",
"headers": []
}
},
"attributes": {
"objectType": "Offer"
}
}, {
"id": "45320EC9-9B8E-49D0-B900-F14141A0ABD1",
"name": "Microsoft MyAnalytics",
"description": "Microsoft MyAnalytics provides insights about time and relationships to help individuals and teams achieve more at work.",
"minimumQuantity": 1,
"maximumQuantity": 10000000,
"rank": 232,
"uri": "/3c95518e-8c37-41e3-9627-0ca339200f53/Offers/45320EC9-9B8E-49D0-B900-F14141A0ABD1",
"locale": "en-US",
"country": "US",
"category": {
"id": "",
"name": "",
"rank": 0,
"locale": "en-us",
"country": "US",
"attributes": {
"objectType": "OfferCategory"
}
},
"prerequisiteOffers": ["195416C1-3447-423A-B37B-EE59A99A19C4", "2F707C7C-2433-49A5-A437-9CA7CF40D3EB", "91FD106F-4B2C-4938-95AC-F54F74E9A239", "796B6B5F-613C-4E24-A17C-EBA730D49C02", "8909E28E-5832-42F4-9886-B0A5545F3645", "2B3B8D2D-10AA-4BE4-B5FD-7F2FEB0C3091"],
"isAddOn": true,
"isAvailableForPurchase": true,
"billing": "license",
"isAutoRenewable": true,
"salesGroupId": "1",
"product": {
"id": "90A8F363-DA30-4ECD-90A7-D3A6B203486D",
"name": "Microsoft MyAnalytics",
"unit": "Licenses"
},
"unitType": "Licenses",
"links": {
"learnMore": {
"method": "GET",
"headers": []
},
"self": {
"uri": "/offers/45320EC9-9B8E-49D0-B900-F14141A0ABD1?country=US",
"method": "GET",
"headers": []
}
},
"attributes": {
"objectType": "Offer"
}
}
],
"attributes": {
"objectType": "Collection"
}
}