Een aanbiedingsmatrix ophalen
In dit artikel wordt uitgelegd hoe u een aanbiedingsmatrix krijgt voor een bepaalde maand. De aanbiedingsmatrix bevat eigenschappen en aankoopregels voor de producten en SKU's. 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 beheerder, beheerderagent of verkoopagent.
DETAILS
- Huidige retourneert alleen gegevens voor bijgewerkte nieuwe handelslicentieproducten.
- Huidige prijzen omvatten producten die beschikbaar zijn tijdens de huidige maand tot de datum waarop de API wordt aangeroepen. Vorige maanden bevatten datum vanaf de laatste dag van de geselecteerde maand.
- Deze methode retourneert gegevens 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/offermatrix(Month='{date}')/$value |
URI-filterparameters
Gebruik de volgende filterparameters.
Name | Type | Vereist | Beschrijving |
---|---|---|---|
Month | tekenreeks | Nee | Moet voldoen aan JJJJMM voor het aangevraagde prijzenoverzicht. |
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 u de bestandsstroom weglaat, wordt deze niet gecomprimeerd. |
Aanvraagvoorbeeld
GET https://api.partner.microsoft.com/v1.0/sales/offermatrix(Month='202101')/$value HTTP/1.1
Authorization: Bearer
Accept-Encoding: deflate
Host: api.partner.microsoft.com
REST-antwoord
Als dit lukt, retourneert deze methode een aanbiedingsmatrix als bestandsstroom. Bestandsstroom is een .csv-bestand of een gecomprimeerde zip-versie van de .csv.
Geslaagde antwoorden en foutcodes
Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft dat de fout is geslaagd of mislukt en aanvullende informatie over foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en aanvullende parameters te lezen. Zie Foutcodes voor de volledige lijst.
Responsvoorbeeld
HTTP/1.1 200 OK
Cache-Control: private
Content-Length: 42180180
Content-Type: application/octet-stream
Content-Disposition: attachment; filename=updatedoffice.csv
Request-ID: 9f8bed52-e4df-4d0c-9ca6-929a187b0731
Date: Wed, 02 Feb 2021 03:41:20 GMT
"ProductTitle","ProductId","SkuId","SkuTitle","ProvisioningId","ProvisioningString","MinLicenses","MaxLicenses","AssetOwnershipLimit","AssetOwnershipLimitType","ProductSkuPreRequisites","ProductSkuConversion","Description","AllowedCountries"
"Microsoft 365 Business Basic","CFQ7TTC0LH18","0001","Microsoft 365 Business Basic","3b555118-da6a-4418-894f-7df1e2096870","O365_BUSINESS_ESSENTIALS","1","300","2","ConcurrentCount","","CFQ7TTC0LDPB/0001,CFQ7TTC0LF8Q/0001","Best for businesses that need professional...","AD;AE;AF;AG;AI;AL;AM;AO..."
======= Truncated ==============
Gerelateerde inhoud
Feedback
https://aka.ms/ContentUserFeedback.
Binnenkort beschikbaar: In de loop van 2024 zullen we GitHub-problemen geleidelijk uitfaseren als het feedbackmechanisme voor inhoud en deze vervangen door een nieuw feedbacksysteem. Zie voor meer informatie:Feedback verzenden en weergeven voor