Obtención de la disponibilidad por identificadorGet the availability by ID

Se aplica aApplies To

  • Centro de partnersPartner Center

Obtiene la disponibilidad para el producto y la SKU especificados mediante un identificador de disponibilidad.Gets the availability for the specified product and SKU using an availability ID.

Requisitos previosPrerequisites

  • Credenciales tal como se describen en el artículo Autenticación del Centro de partners.Credentials as described in Partner Center authentication. Este escenario admite la autenticación con las credenciales de aplicación y aplicación independientes.This scenario supports authentication with both standalone App and App+User credentials.

  • Un identificador de producto.A product ID.

  • IDENTIFICADOR DE SKU.A SKU ID.

  • IDENTIFICADOR de disponibilidad.An availability ID.

C#C#

Para obtener detalles de una disponibilidadespecífica, empiece por los pasos descritos en obtención de una SKU por identificador para obtener la interfaz para las operaciones de una SKU específica.To get details of a specific availability, start by using the steps in Get a SKU by ID to get the interface for a specific SKU's operations. En la interfaz resultante, seleccione la propiedad Availabilities para obtener una interfaz con las operaciones disponibles para las disponibilidades.From the resulting interface, select the Availabilities property to obtain an interface with the available operations for Availabilities. Después, pase el identificador de disponibilidad al método ById () para obtener las operaciones de esa disponibilidad concreta y, a continuación, llame a get () o GetAsync () para recuperar los detalles de disponibilidad.After that, pass the availability ID to the ById() method to get the operations for that specific availability and then call Get() or GetAsync() to retrieve the availability details.

IAggregatePartner partnerOperations;
string countryCode;
string productId;
string skuId;
string availabilityId;

// Get the availability details.
var availability = partnerOperations.Products.ByCountry(countryCode).ById(productId).Skus.ById(skuId).Availabilities.ById(availabilityId).Get();

JavaJava

Los partners suelen usar el SDK de Java del Centro de partners para administrar los recursos del Centro de partners.The Partner Center Java SDK is commonly used by partners to manage their Partner Center resources. Se trata de un proyecto de código abierto que mantiene la comunidad de partners.It's an open-source project maintained by the partner community. Dado que este módulo lo mantiene la comunidad de partners, Microsoft no lo admite oficialmente.Since this module is maintained by the partner community, it isn't officially supported by Microsoft. Puedes obtener ayuda de la comunidad o abrir una incidencia en GitHub si se produce un problema.You can get help from the community or open an issue on GitHub if you experience a problem.

Para obtener detalles de una disponibilidadespecífica, empiece por los pasos descritos en obtención de una SKU por identificador para obtener la interfaz para las operaciones de una SKU específica.To get details of a specific availability, start by using the steps in Get a SKU by ID to get the interface for a specific SKU's operations. En la interfaz resultante, seleccione la función getAvailabilities para obtener una interfaz con las operaciones disponibles para las disponibilidades.From the resulting interface, select the getAvailabilities function to obtain an interface with the available operations for Availabilities. Después, pase el identificador de disponibilidad a la función byId () para obtener las operaciones de esa disponibilidad concreta y, a continuación, llame a la función get () para recuperar los detalles de disponibilidad.After that, pass the availability ID to the byId() function to get the operations for that specific availability and then call the get() function to retrieve the availability details.

IAggregatePartner partnerOperations;
String countryCode;
String productId;
String skuId;
String availabilityId;

// Get the availability details.
Availability availability = partnerOperations.getProducts().byCountry(countryCode).byId(productId).getSkus().byId(skuId).getAvailabilities().byId(availabilityId).get();

PowerShellPowerShell

Los partners suelen usar el módulo de PowerShell del Centro de partners para administrar los recursos del Centro de partners.The Partner Center PowerShell module is commonly used by partners to manage their Partner Center resources. Se trata de un proyecto de código abierto que mantiene la comunidad de partners.It's an open-source project maintained by the partner community. Dado que este módulo lo mantiene la comunidad de partners, Microsoft no lo admite oficialmente.Since this module is maintained by the partner community, it isn't officially supported by Microsoft. Puedes obtener ayuda de la comunidad o abrir una incidencia en GitHub si se produce un problema.You can get help from the community or open an issue on GitHub if you experience a problem.

Para obtener detalles de una disponibilidadespecífica, ejecute Get-PartnerProductAvailability y especifique los parámetros AvailabilityId, CountryCode, ProductIDy SkuId para recuperar los detalles de disponibilidad.To get details of a specific availability, execute the Get-PartnerProductAvailability and specify the AvailabilityId, CountryCode, ProductId, and SkuId parameters to retrieve the availability details.

Get-PartnerProductAvailability -Product $productId -SkuId $skuId -AvailabilityId $availabilityId

Solicitud RESTREST request

Sintaxis de la solicitudRequest syntax

MétodoMethod URI de la solicitudRequest URI
GETGET {baseurl}/v1/products/{product-ID}/SKUs/{SKU-ID}/Availabilities/{Availability-ID}? Country = {Country-code} http/1.1{baseURL}/v1/products/{product-id}/skus/{sku-id}/availabilities/{availability-id}?country={country-code} HTTP/1.1

Parámetro de URIURI parameter

Use la ruta de acceso y los parámetros de consulta siguientes para obtener una disponibilidad específica mediante un identificador de disponibilidad.Use the following path and query parameters to get a specific availability using an availability ID.

NombreName TipoType ObligatorioRequired DescripciónDescription
ID. de productoproduct-id stringstring Yes Cadena con formato de GUID que identifica el producto.A GUID formatted string that identifies the product.
identificador de SKUsku-id stringstring Yes Cadena con formato de GUID que identifica la SKU.A GUID formatted string that identifies the SKU.
identificador de disponibilidadavailability-id stringstring Yes Cadena con formato de GUID que identifica la disponibilidad.A GUID formatted string that identifies the availability.
país: códigocountry-code stringstring Yes IDENTIFICADOR de país o región.A country/region ID.

Encabezados de solicitudRequest headers

Para obtener más información, consulta Encabezados REST del Centro de partners.For more information, see Partner Center REST headers.

Cuerpo de la solicitudRequest body

Ninguno.None.

Ejemplo de solicitudRequest example

GET http://api.partnercenter.microsoft.com/v1/products/DZH318Z0BQ3Q/skus/0001/availabilities/DZH318XZXPHL?country=US HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 2e12a576-ded5-437e-a5ec-dbfbcbd1624c
MS-CorrelationId: 83b644b5-e54a-4bdc-b354-f96c525b3c58
X-Locale: en-US
MS-PartnerCenter-Client: Partner Center .NET SDK
Host: api.partnercenter.microsoft.com

Respuesta RESTREST response

Si se realiza correctamente, el cuerpo de la respuesta contiene un recurso de disponibilidad .If successful, the response body contains an Availability resource.

Códigos de error y de respuesta correctosResponse success and error codes

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.Each response comes with an HTTP status code that indicates success or failure and additional debugging information. Use una herramienta de seguimiento de red para leer este código, el tipo de error y los parámetros adicionales.Use a network trace tool to read this code, error type, and additional parameters. Para obtener la lista completa, consulte códigos de error del centro de Partners.For the full list, see Partner Center error codes.

Este método devuelve los siguientes códigos de error:This method returns the following error codes:

Código de estado HTTPHTTP Status Code Código de errorError code DescripciónDescription
404404 400013400013 No se encontró el producto.Product was not found.
404404 400018400018 No se encontró la SKU.Sku was not found.
404404 400019400019 No se encontró la disponibilidad.Availability not found.

Ejemplo de respuestaResponse example

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Server: Microsoft-IIS/10.0
MS-CorrelationId: 83b644b5-e54a-4bdc-b354-f96c525b3c58,83b644b5-e54a-4bdc-b354-f96c525b3c58
MS-RequestId: 2e12a576-ded5-437e-a5ec-dbfbcbd1624c,2e12a576-ded5-437e-a5ec-dbfbcbd1624c
X-Locale: en-US,en-US
X-SourceFiles: =?UTF-8?B?QzpcVXNlcnNcbWFtZW5kZVxkZXZcZHBzLXJwZVxSUEUuUGFydG5lci5TZXJ2aWNlLkNhdGFsb2dcV2ViQXBpc1xDYXRhbG9nU2VydmljZS5WMi5XZWJcdjFccHJvZHVjdHNcRFpIMzE4WjBCUTNRXHNrdXNcMDAwMVxhdmFpbGFiaWxpdGllc1xEWkgzMThaMEhNS1E=?=
X-Powered-By: ASP.NET
Date: Wed, 14 Mar 2018 22:19:43 GMT
Content-Length: 440

{
    "id": "DZH318XZXPHL",
    "productId": "DZH318Z0BQ3Q",
    "skuId": "0001",
    "catalogItemId": "DZH318Z0BQ3Q:0001:DZH318XZXPHL",
    "defaultCurrency": {
        "code": "USD",
        "symbol": "$"
    },
    "segment": "commercial",
    "country": "US",
    "isPurchasable": true,
    "isRenewable": false,
    "terms": [{
        "duration": "P1Y",
        "description": "1 Year Prepaid"
    }],
    "product": { ... },
    "sku": { ... },
    "links": {
        "self": {
            "uri": "/products/DZH318Z0BQ3Q/skus/0001/availabilities/DZH318XZXPHL?country=US",
            "method": "GET",
            "headers": []
        }
    }
}