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
- Momenteel worden alleen gegevens geretourneerd voor Azure-abonnementenverbruik en reserveringen, op licentiebasis (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 winkelprijzen voor reserveringen zijn te vinden in de gedeelde reserveringsdiensten die te downloaden zijn van 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 azure_consumption, azure_reservations, updated_licensebased, marketplace of software zijn. |
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
De prijslijst op basis van licentie aan het einde van de verkoop is momenteel alleen beschikbaar om te downloaden via de UX van het Partnercentrum.
URI-filterparameters
Gebruik de volgende filterparameters.
Name | Typ | Vereist | Beschrijving |
---|---|---|---|
Tijdlijn | tekenreeks | Nee | Standaard ingesteld op huidige als deze niet is doorgegeven. Mogelijke waarden zijn geschiedenis, huidige en toekomstige waarden. |
Maand | 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 de API, startend met de geschiedenis van maart 2022.
Aanvraagheaders
- Zie Partner REST-headers voor meer informatie.
Naast de bovenstaande headers kunnen prijsbestanden worden opgehaald in gecomprimeerde vorm, waardoor de bandbreedte en downloadtijden worden verminderd. 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: | Waarde | Beschrijving |
---|---|---|---|
Accept-Encoding | tekenreeks | leeg laten lopen | 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
Voorbeeldaanvraag voor nieuwe commercie
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 succes of mislukking en andere informatie over foutopsporing aangeeft. 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 aangeven van toekomstige tijd in de tijdlijn die is aangevraagd voor de bijgewerkte licentie-gebaseerde PriceSheetView, zullen partners de volgende API-antwoordcode zien: 404 Not Found.