Ottenere la disponibilità in base all'ID
Ottiene la disponibilità per il prodotto e lo SKU specificati usando un ID di disponibilità. Gli ID di disponibilità sono modificabili e dinamici, vengono rielaborati regolarmente. I partner devono sempre assicurarsi di ottenere la disponibilità corrente durante l'invio di articoli del carrello o l'esecuzione di altre attività che richiedono l'ID di disponibilità.
Credenziali descritte in Autenticazione del Centro per i partner. Questo scenario supporta l'autenticazione con le credenziali app autonome e App+Utente.
ID prodotto.
ID SKU.
ID di disponibilità.
Per ottenere i dettagli di una disponibilità specifica, iniziare seguendo la procedura descritta in Ottenere uno SKU per ID per ottenere l'interfaccia per le operazioni di uno SKU specifico. Nell'interfaccia risultante selezionare la proprietà Availabilities per ottenere un'interfaccia con le operazioni disponibili per Disponibilità. Successivamente, passare l'ID di disponibilità al metodo ById() per ottenere le operazioni per la disponibilità specifica e quindi chiamare Get() o GetAsync() per recuperare i dettagli di disponibilità.
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();
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 ottenere i dettagli di una disponibilità specifica, iniziare seguendo la procedura descritta in Ottenere uno SKU per ID per ottenere l'interfaccia per le operazioni di uno SKU specifico. Nell'interfaccia risultante selezionare la funzione getAvailabilities per ottenere un'interfaccia con le operazioni disponibili per Availabilities. Successivamente, passare l'ID di disponibilità alla funzione byId() per ottenere le operazioni per la disponibilità specifica e quindi chiamare la funzione get() per recuperare i dettagli di disponibilità.
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();
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 ottenere i dettagli di una disponibilità specifica, eseguire get-PartnerProductAvailability e specificare i parametri AvailabilityId, CountryCode, ProductId e SkuId per recuperare i dettagli di disponibilità.
Get-PartnerProductAvailability -Product $productId -SkuId $skuId -AvailabilityId $availabilityId
metodo | URI della richiesta |
---|---|
GET | {baseURL}/v1/products/{product-id}/skus/{sku-id}/availabilities/{availability-id}?country={country-code} HTTP/1.1 |
Usare il percorso e i parametri di query seguenti per ottenere una disponibilità specifica usando un ID di disponibilità.
Nome | Digita | Obbligatorio | Descrizione |
---|---|---|---|
product-id | string | Sì | Stringa formattata GUID che identifica il prodotto. |
sku-id | string | Sì | Stringa formattata CON GUID che identifica lo SKU. |
availability-id | string | Sì | Stringa con formattazione GUID che identifica la disponibilità. |
codice paese | string | Sì | ID paese/area geografica. |
IncludeLifeCycleState | string | No | Flag stringa che può essere impostato su true per restituire i valori dello stato del ciclo di vita per le offerte basate su licenza di New Commerce. Questi valori non verranno restituiti se il flag non è incluso. |
Per altre informazioni, vedi Intestazioni REST del Centro per i partner.
Nessuno.
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: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
MS-PartnerCenter-Client: Partner Center .NET SDK
Host: api.partnercenter.microsoft.com
Importante
A partire da giugno 2023, la versione più recente di .NET SDK del Centro per i partner 3.4.0 è ora archiviata. È possibile scaricare la versione dell'SDK da GitHub, insieme a un file leggimi che contiene informazioni utili.
I partner sono invitati a continuare a usare le API REST del Centro per i partner.
In caso di esito positivo, il corpo della risposta contiene una risorsa di disponibilità .
Ogni risposta viene fornita con un codice di stato HTTP che indica l'esito positivo o negativo e informazioni di debug aggiuntive. Usare uno strumento di traccia di rete per leggere questo codice, il tipo di errore e altri parametri. Per l'elenco completo, vedere Codici di errore del Centro per i partner.
Questo metodo restituisce i codici di errore seguenti:
Codice di stato HTTP | Codice errore | Descrizione |
---|---|---|
404 | 400013 | Prodotto non trovato. |
404 | 400018 | Lo SKU non è stato trovato. |
404 | 400019 | Disponibilità non trovata. Questo errore può verificarsi durante il check-out di un carrello. I partner che ricevono questo errore devono emettere un nuovo GET per assicurarsi che abbiano l'ID di disponibilità corrente e riprovare a eseguire il check-out del carrello. |
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Server: Microsoft-IIS/10.0
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd,aaaa0000-bb11-2222-33cc-444444dddddd
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": []
}
}
}
Nota
Le nuove esperienze commerciali per i servizi basati su licenza includono molte nuove funzionalità e sono disponibili per tutti i provider di soluzioni cloud. Per altre informazioni, vedere la panoramica delle nuove esperienze commerciali.
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Server: Microsoft-IIS/10.0
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd,aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 70324727-62d8-4195-8f99-70ea25058d02,70324727-62d8-4195-8f99-70ea25058d02
X-Locale: en-US,en-US
X-SourceFiles: =?UTF-8?B?QzpcVXNlcnNcbWFtZW5kZVxkZXZcZHBzLXJwZVxSUEUuUGFydG5lci5TZXJ2aWNlLkNhdGFsb2dcV2ViQXBpc1xDYXRhbG9nU2VydmljZS5WMi5XZWJcdjFccHJvZHVjdHNcRFpIMzE4WjBCUTNRXHNrdXNcMDAwMVxhdmFpbGFiaWxpdGllcw==?=
X-Powered-By: ASP.NET
Date: Wed, 14 Mar 2018 22:19:37 GMT
Content-Length: 808
{
"id": "CFQ7TTC0K971",
"productId": "CFQ7TTC0LH18",
"skuId": "0001",
"catalogItemId": "CFQ7TTC0LH18:0001:CFQ7TTC0K971",
"defaultCurrency": {
"code": "USD",
"symbol": "$"
},
"segment": "commercial",
"country": "US",
"isPurchasable": true,
"isRenewable": true,
"renewalInstructions": [
{
"applicableTermIds": [
"5aeco6mffyxo"
],
"renewalOptions": [
{
"renewToId": "CFQ7TTC0LH18:0001",
"isAutoRenewable": true
}
]
},
…
],
"terms": [
{
"id": "5aeco6mffyxo",
"duration": "P1Y",
"description": "One-Year commitment for monthly/yearly billing",
"billingCycle": "Annual",
"cancellationPolicies": [
{
"refundOptions": [
{
"sequenceId": 0,
"type": "Full",
"expiresAfter": "P1D"
}
]
}
]
},
…
],
"product": { ... },
"sku": { ... },
"links": {
"self": {
"uri": "/products/CFQ7TTC0LH18/skus/0001/availabilities/CFQ7TTC0K971?country=US",
"method": "GET",
"headers": []
}
}
}