Delen via


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

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.