Obtener los complementos de un id. de oferta
Se aplica a: Centro de partners | Centro de partners operado por 21Vianet | Centro de partners para Microsoft Cloud for US Government
Cómo obtener los complementos de un identificador de oferta.
Requisitos previos
Credenciales tal como se describen en el artículo Autenticación del Centro de partners. Este escenario admite la autenticación con credenciales de aplicación independiente y app+usuario.
Un identificador de oferta. Si no tiene el identificador de oferta, consulte Obtener una lista de ofertas para un mercado.
C#
Para obtener los complementos de una oferta por identificador, primero llame al método IAggregatePartner.Offers.ByCountry con el código de país para obtener una interfaz para ofrecer operaciones basadas en el país o región especificados. A continuación, llame al método ByID con el identificador de oferta para identificar la oferta cuyos complementos desea recuperar. A continuación, use la propiedad AddOns para obtener una interfaz para las operaciones de complemento para la oferta actual. Por último, llame al método Get o GetAsync para obtener una colección de todos los complementos de la oferta especificada.
// IAggregatePartner partnerOperations;
// string offerId;
// string countryCode;
var offerAddOns = partnerOperations.Offers.ByCountry(countryCode).ById(offerId).AddOns.Get();
Ejemplo: Aplicación de prueba de consola. Project: Partner Center SDK Samples Class: GetOffer.cs
Solicitud REST
Sintaxis de la solicitud
Método | URI de solicitud |
---|---|
GET | {baseURL}/v1/offers/{offer-id}/addons?country={country-code} HTTP/1.1 |
Parámetros de URI
Use los parámetros siguientes para proporcionar el identificador de oferta y el código de país.
Nombre | Tipo | Obligatorio | Descripción |
---|---|---|---|
offer-id | guid | S | GUID que identifica la oferta. |
country | string | Y | Código de país (por ejemplo US ). |
Encabezados de solicitud
Para obtener más información, consulta Encabezados REST del Centro de partners.
Cuerpo de la solicitud
No.
Ejemplo de solicitud
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: 26d2b3b1-c76a-4aeb-8298-1654c91d9eb8
X-Locale: en-US
Host: api.partnercenter.microsoft.com
Respuesta REST
Si se ejecuta correctamente, este método devuelve una colección de objetos Offer en el cuerpo de la respuesta.
Códigos de error y de respuesta correctos
Cada respuesta incluye un código de estado HTTP que indica si la operación se ha realizado correctamente o con errores y proporciona información de depuración adicional. Use una herramienta de seguimiento de red para leer este código, el tipo de error y los parámetros adicionales. Para obtener la lista completa, consulta Códigos de error de REST del Centro de partners.
Ejemplo de respuesta
HTTP/1.1 200 OK
Content-Length: 3137
Content-Type: application/json; charset=utf-8
MS-CorrelationId: 26d2b3b1-c76a-4aeb-8298-1654c91d9eb8
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"
}
}
Comentaris
https://aka.ms/ContentUserFeedback.
Properament: al llarg del 2024 eliminarem gradualment GitHub Issues com a mecanisme de retroalimentació del contingut i el substituirem per un nou sistema de retroalimentació. Per obtenir més informació, consulteu:Envieu i consulteu els comentaris de