Obtener una lista de categorías de ofertas, según el mercado
Se aplica a: Centro de partners | Centro de partners operado por 21Vianet | Centro de partners para Microsoft Cloud for US Government
En este artículo se describe cómo obtener una colección que contiene todas las categorías de oferta de un país o región determinados y la configuración regional.
Requisitos previos
- Credenciales tal como se describen en el artículo Autenticación del Centro de partners. Este escenario admite la autenticación con las credenciales de aplicación independiente y app+usuario.
C#
Para obtener una lista de categorías de ofertas en un país o región determinados y la configuración regional:
Use la colección IAggregatePartner.Operations para llamar al método With() en un contexto determinado.
Inspeccione la propiedad OfferCategories del objeto resultante.
// IAggregatePartner partnerOperations;
ResourceCollection<OfferCategory> offerCategoryResults = partnerOperations.With(RequestContextFactory.Instance.Create()).OfferCategories.ByCountry("US").Get();
Para obtener un ejemplo, vea lo siguiente:
- Ejemplo: Aplicación de prueba de la consola
- Project: PartnerSDK.FeatureSample
- Clase: PartnerSDK.FeatureSample
Solicitud REST
Sintaxis de la solicitud
Método | URI de la solicitud |
---|---|
GET | {baseURL}/v1/offercategories?country={country-id} HTTP/1.1 |
Parámetro de URI
En esta tabla se enumeran los parámetros de consulta necesarios para obtener las categorías de oferta.
Nombre | Tipo | Obligatorio | Descripción |
---|---|---|---|
country-id | string | Y | El id. del país o región. |
Encabezados de solicitud
Se requiere un identificador de configuración regional con formato de cadena.
Para obtener más información, consulta Encabezados REST del Centro de partners.
Cuerpo de la solicitud
Ninguno.
Ejemplo de solicitud
GET https://api.partnercenter.microsoft.com/v1/offercategories?country=<country-id> HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 4fb54bd5-a4c3-4fac-955f-9b6e3436d606
MS-CorrelationId: 47882653-eaed-4a2e-a552-1070a3fa1089
X-Locale: <locale-id>
Connection: Keep-Alive
Respuesta REST
Si se ejecuta correctamente, este método devuelve una colección de recursos OfferCategory 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 una lista completa, consulte Códigos de error.
Ejemplo de respuesta
HTTP/1.1 200 OK
Content-Length: 1184
Content-Type: application/json
MS-CorrelationId: 47882653-eaed-4a2e-a552-1070a3fa1089
MS-RequestId: 4fb54bd5-a4c3-4fac-955f-9b6e3436d606
Date: Thu, 26 Nov 2015 00:07:10 GMT
{
"totalCount": 4,
"items": [{
"id": "Enterprise_Key",
"name": "Enterprise",
"rank": 20,
"locale": "en-us",
"country": "US",
"attributes": {
"objectType": "OfferCategory"
}
},
{
"id": "SmallBusiness_Key",
"name": "SmallBusiness",
"rank": 30,
"locale": "en-us",
"country": "US",
"attributes": {
"objectType": "OfferCategory"
}
},
{
"id": "Government_Key",
"name": "Government",
"rank": 40,
"locale": "en-us",
"country": "US",
"attributes": {
"objectType": "OfferCategory"
}
},
{
"id": "Internal_Key",
"name": "Internal",
"rank": 100,
"locale": "en-us",
"country": "US",
"attributes": {
"objectType": "OfferCategory"
}
}],
"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