Delen via

Een aanbiedingsmatrix ophalen

  • Artikel

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 ondersteunt momenteel alleen gebruikerstoegang waarbij partners zich in een van de volgende rollen moeten bevinden: 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. Details over het aanvragen van gecomprimeerde bestanden volgen.

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

Naast deze 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 volgende 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 dit weglaat, wordt de bestandsstroom 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