Share via

Een prijslijst ophalen

  • Artikel

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: Globale Beheer, Beheer Agent 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, bijgewerkte licentiebasis, marketplace of software.

Notitie

updatedlicensebased PriceSheetView is momenteel alleen beschikbaar voor partners die deel uitmaken van de nieuwe technische preview van Microsoft 365/Microsoft Dynamics 365.

Notitie

De prijslijst voor software is vanaf 1 april 2022 beschikbaar via API.

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

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 nieuwe technische preview van Microsoft 365/Microsoft Dynamics 365.

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 nieuwe technische preview van Microsoft 365/Microsoft Dynamics 365.

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.

Volgende stappen