Een prijslijst ophalen
In dit artikel wordt uitgelegd hoe u een prijzenoverzicht voor een bepaalde markt en weergave kunt verkrijgen. Deze methode ondersteunt filters voor het ophalen van geschiedenis per maand.
Vereisten
- Referenties zoals beschreven in partner-API-verificatie. Dit scenario biedt alleen ondersteuning voor verificatie van toepassingsgebruikers. Alleen toepassingen worden nog niet ondersteund. Partners met http-fout:400 moeten de documentatie voor partner-API-verificatie raadplegen.
- Deze API biedt momenteel alleen ondersteuning voor gebruikerstoegang waarbij partners zich in een van de volgende rollen moeten bevinden: Beheerderagent of Verkoopagent.
DETAILS
- Huidige retourneert alleen gegevens voor azure-abonnementsverbruik en -reserveringen, op basis van licentie (nieuwe commerce-ervaring) en Marketplace-producten.
- Huidige prijzen omvatten alle meters en producten die beschikbaar zijn tijdens de huidige maand tot de datum waarop de API wordt aangeroepen. Vorige maanden omvatten alle meters en producten die beschikbaar zijn voor de opgegeven maand.
- De prijzen van verbruiksmeters bevinden zich alleen in USD, partners gebruiken de API voor wisselkoersen om de lokale valutakosten te berekenen.
- De prijzen van verbruiksmeter zijn geschatte detailhandelprijzen. Partnerkortingen zijn beschikbaar via partnertegoeden.
- Reserveringsmeterprijzen zijn inclusief de CSP-partnerkortingen. Geschatte retailprijzen voor reserveringen vindt u op de gedeelde reserveringen die kunnen worden gedownload via de pagina Prijzen en aanbiedingen van het Partnercentrum.
- Meer informatie over prijzen voor Azure-abonnementen vindt u in de prijsdocumentatie voor Azure-abonnementen.
- Partnerprijzen en API's voor wisselkoersen maken geen deel uit van de Partner Center SDK.
- Deze methode retourneert de prijslijst als een bestandsstroom. Bestandsstroom is een .csv-bestand of een gecomprimeerde zip-versie van de .csv. Hieronder vindt u meer informatie over het aanvragen van gecomprimeerde bestanden.
REST-aanvraag
Aanvraagsyntaxis
| Wijze | Aanvraag-URI |
|---|---|
| GET | https://api.partner.microsoft.com/v1.0/sales/pricesheets(Market='{market}',PricesheetView='{view}')/$value |
Vereiste URI-parameters
Gebruik de volgende padparameters om de gewenste markt en het type prijzenoverzicht aan te vragen.
| Name | Type | Vereist | Beschrijving |
|---|---|---|---|
| Markt | tekenreeks | Ja | Land-/regiocode van twee letters voor de markt die wordt aangevraagd |
| PricesheetView | tekenreeks | Ja | Het type prijzenoverzicht dat wordt aangevraagd, kan worden azure_consumption, azure_reservations, updatedlicensebased, licensebasedbeta (om de kolom wijzigingsindicator), marketplace of software op te nemen. |
Notitie
updatedlicensebased PriceSheetView is momenteel alleen beschikbaar voor partners die deel uitmaken van de Microsoft 365/Microsoft Dynamics 365 nieuwe commerce-ervaring technical preview.
Notitie
Het prijzenoverzicht einde van de verkooplicentie is op dit moment alleen beschikbaar om te downloaden via de UX van het Partnercentrum.
URI-filterparameters
Gebruik de volgende filterparameters.
| Name | Type | Vereist | Beschrijving |
|---|---|---|---|
| Tijdlijn | tekenreeks | Nee | Standaard ingesteld op huidige als deze niet is doorgegeven. Mogelijke waarden zijn geschiedenis, huidige en toekomstige waarden. |
| Month | tekenreeks | Nee | Alleen vereist als geschiedenis wordt aangevraagd, moet voldoen aan JJJJMM voor het aangevraagde prijzenoverzicht. |
Notitie
Toekomstige prijzen worden niet ondersteund voor Marketplace. Vanaf 1 april 2022 kunnen partners de geschiedenis van de softwareprijslijst bekijken via API, vanaf maart 2022 geschiedenis.
Aanvraagheaders
- Zie Partner REST-headers voor meer informatie.
Naast de bovenstaande headers kunnen prijsbestanden worden opgehaald als gecomprimeerde bandbreedte en downloadtijden. De bestanden worden standaard niet gecomprimeerd. Als u gecomprimeerde versies van de bestanden wilt ophalen, kunt u de onderstaande headerwaarde opnemen. Realiseer u dat gecomprimeerde bladen alleen beschikbaar zijn vanaf april 2020, alle bladen vóór april 2020 alleen beschikbaar zijn als niet gecomprimeerd.
| Koptekst | Waardetype: | Weergegeven als | Beschrijving |
|---|---|---|---|
| Accept-Encoding | tekenreeks | Deflate | Optioneel. Als de bestandsstroom wordt weggelaten, wordt deze niet gecomprimeerd. |
Aanvraagvoorbeeld
GET https://api.partner.microsoft.com/v1.0/sales/pricesheets(Market='ad',PricesheetView='azure_consumption')/$value?timeline=history&month=201909 HTTP/1.1
Authorization: Bearer
Host: api.partner.microsoft.com
Voorbeeld van aanvraag voor nieuwe handel
Notitie
updatedlicensebased PriceSheetView is momenteel alleen beschikbaar voor partners die deel uitmaken van de Microsoft 365/Microsoft Dynamics 365 nieuwe commerce-ervaring technical preview.
GET https://api.partner.microsoft.com/v1.0/sales/pricesheets(Market='US',PricesheetView='updatedlicensebased')/$value?timeline=history&month=202101 HTTP/1.1
Authorization: Bearer
Accept-Encoding: deflate
Host: api.partner.microsoft.com
REST-antwoord
Als dit lukt, retourneert deze methode de prijslijst als bestandsstroom. Bestandsstroom is een .csv-bestand of een gecomprimeerde zip-versie van de .csv.
Antwoordvoorbeeld voor nieuwe commerce
Notitie
updatedlicensebased PriceSheetView is momenteel alleen beschikbaar voor partners die deel uitmaken van de Microsoft 365/Microsoft Dynamics 365 nieuwe commerce-ervaring technical preview.
HTTP/1.1 200 OK
Cache-Control: private
Content-Length: 42180180
Content-Type: application/octet-stream
Content-Disposition: attachment; filename=sheets.csv
Request-ID: 9f8bed52-e4df-4d0c-9ca6-929a187b0731
Date: Wed, 02 Feb 2021 03:41:20 GMT
"ProductTitle","ProductId","SkuId","SkuTitle","Publisher","SkuDescription","UnitOfMeasure","TermDuration","BillingPlan","Market","Currency","UnitPrice","PricingTierRangeMin","PricingTierRangeMax","EffectiveStartDate","EffectiveEndDate","Tags","ERP Price"
"Advanced Communications","CFQ7TTC0HDK0","0001","Advanced Communications","Microsoft Corporation","Advanced meetings, calling, workflow integration, and management tools for IT.","","P1Y","Annual","US","USD","115.2","","","2/1/2019 12:00:00 AM","2/4/2021 8:35:31 PM","License","144"
======= Truncated ==============
Geslaagde antwoorden en foutcodes
Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft dat de fout is geslaagd of mislukt en andere informatie over foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en andere parameters te lezen. Zie Foutcodes voor de volledige lijst.
Als er geen wijzigingen worden verwacht voor de nieuwe handelsprijzenlijst op basis van een licentie, wordt er geen toekomstige prijslijst geretourneerd. Bij het doorgeven van de toekomst aan de tijdlijn die is aangevraagd voor de bijgewerkte pricesheetview op basis van de bijgewerkte licentie, zien partners de volgende API-antwoordcode: 404 Niet gevonden.