Hämta ett prisdokument
Den här artikeln förklarar hur du får ett prisdokument för en viss marknad och vy. Den här metoden stöder filter för att hämta historik per månad.
Förutsättningar
- Autentiseringsuppgifter enligt beskrivningen i Partner-API-autentisering. Det här scenariot stöder endast autentisering av programanvändare. Applikationsläge stöds inte ännu. Partner som upplever http-fel:400 bör läsa dokumentationen för partner-API-autentisering.
- Det här API:et stöder för närvarande endast användaråtkomst där partner måste ha någon av följande roller: Administratörsagent eller Försäljningsagent.
Detaljer
- Aktuell data returnerar endast uppgifter för förbrukning och reservationer för Azure-planer, licensbaserade (ny handelsupplevelse) och Marketplace-produkter.
- Den aktuella prissättningen inkluderar alla mätare och produkter som är tillgängliga under den aktuella månaden till det datum då API:et anropas. Föregående månader inkluderar alla mätare och produkter som är tillgängliga för den angivna månaden.
- Priserna för förbrukningsmätare är endast i USD, partner ska använda API:et för utländska växelkurser för att beräkna kostnader för lokal valuta.
- Förbrukningsmätarepriser är uppskattade detaljhandelspriser. Partnerrabatter är tillgängliga via partnerintjänad kredit.
- Priser för reservationer inkluderar CSP-partnerrabatterna. Uppskattade detaljhandelspriser för reservationer finns i de gemensamma tjänster för reservationer som kan laddas ned från sidan "Priser och erbjudanden" i Partner Center.
- Mer information om priser för Azure-plan finns i prisdokumentationen för Azure-plan.
- Partnerpriser och API:er för utländsk växelkurs ingår inte i PartnerCenter SDK.
- Den här metoden returnerar prislistan som en filström. Filströmmen är antingen en .csv fil eller en komprimerad zip-version av .csv. Information om hur du begär komprimerade filer finns nedan.
REST-begäran
Syntax för begäran
Metod | URI för förfrågan |
---|---|
GET | https://api.partner.microsoft.com/v1.0/sales/pricesheets(Market='{market}',PricesheetView='{view}')/$value |
Obligatoriska URI-parametrar
Använd följande sökvägsparametrar för att begära den marknad och typ av prisdokument som du vill använda.
Namn | Typ | Obligatoriskt | Beskrivning |
---|---|---|---|
Marknad | sträng | Ja | Lands-/regionkod med två bokstäver för den marknad som begärs |
Prisbladsvisning | sträng | Ja | Den typ av prisdokument som begärs kan vara azure_consumption, azure_reservations, uppdateradlicensbaserad, marknadsplats eller programvara. |
Anteckning
updatedlicensebased PriceSheetView är för närvarande endast tillgängligt för partner som ingår i Microsoft 365/Microsoft Dynamics 365 ny teknisk förhandsversion av handelsupplevelsen.
Anteckning
Licensbaserade prisdokumentet för slutet av försäljningen är endast tillgängligt för nedladdning via PartnerCenter UX för tillfället.
URI-filterparametrar
Använd följande filterparametrar.
Namn | Typ | Obligatoriskt | Beskrivning |
---|---|---|---|
Tidslinje | sträng | Nej | Standardvärdet används om inget anges. Möjliga värden är historik, aktuell och framtida. |
Månad | sträng | Nej | Krävs endast om historik begärs, och måste följa YYYYMM för den prislista som begärs. |
Anteckning
Framtida priser stöds inte för Marketplace. Från och med den 1 april 2022 kommer partner att kunna visa historik över programvarupriser via API:et från och med mars 2022.
Begäranhuvuden
- Mer information finns i PARTNER REST-huvuden.
Förutom ovanstående rubriker kan prisfiler hämtas som komprimerade, vilket minskar bandbredden och nedladdningstiderna. Som standard komprimeras inte filerna. Om du vill hämta komprimerade versioner av filerna kan du inkludera rubrikvärdet nedan. Observera att komprimerade blad endast är tillgängliga från april 2020 och framåt, alla blad före april 2020 är endast tillgängliga som inte komprimerade.
Header | Värdetyp | Värde | Beskrivning |
---|---|---|---|
Accept-Encoding | sträng | Tömma | Valfritt. Om filströmmen utelämnas komprimeras den inte. |
Exempel på begäran
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
Exempel på begäran om ny handel
Kommentar
updatedlicensebased PriceSheetView är för närvarande endast tillgängligt för partner som ingår i Microsoft 365/Microsoft Dynamics 365 ny teknisk förhandsversion av handelsupplevelsen.
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-svar
Om det lyckas returnerar den här metoden prislistan som en filström. Filströmmen är antingen en .csv fil eller en komprimerad zip-version av .csv.
Svarsexempel för ny handel
Kommentar
updatedlicensebased PriceSheetView är för närvarande endast tillgängligt för partner som ingår i Microsoft 365/Microsoft Dynamics 365 ny teknisk förhandsversion av handelsupplevelsen.
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 ==============
Svarsframgång och felkoder
Varje svar levereras med en HTTP-statuskod som anger lyckad eller misslyckad och annan felsökningsinformation. Använd ett verktyg för nätverksspårning för att läsa den här koden, feltypen och andra parametrar. Den fullständiga listan finns i Felkoder.
Om inga ändringar förväntas för den nya handelslicensbaserade framtida prislistan returneras ingen framtida prislista. När du överför ett framtida datum till tidslinjen som begärts för den uppdaterade licensbaserade PriceSheetView ser partner följande API-svarskod: 404 Inte hittad.