Dela via

Hämta en erbjudandematris

  • Artikel

Den här artikeln beskriver hur du hämtar en erbjudandematris för en viss månad. Erbjudandematrisen innehåller egenskaper och inköpsregler för produkterna och sku:erna. 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. Endast program 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: Global administratör, administratörsagent eller försäljningsagent.

Details

  • Aktuella returnerar endast data för uppdaterade nya handelslicensbaserade produkter.
  • Den aktuella prissättningen inkluderar produkter som är tillgängliga under den aktuella månaden till det datum då API:et anropas. Föregående månader inkluderar datum från och med den sista dagen i den valda månaden.
  • Den här metoden returnerar data 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/offermatrix(Month='{date}')/$value

URI-filterparametrar

Använd följande filterparametrar.

Namn Typ Obligatoriskt Beskrivning
Månad sträng Nej Måste följa YYYYMM för prisdokumentet som begärs.

Begärandehuvuden

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.

Sidhuvud Värdetyp Värde beskrivning
Accept-Encoding sträng Tömma Valfritt. Om den utelämnade filströmmen inte komprimeras.

Exempel på begäran

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-svar

Om det lyckas returnerar den här metoden en erbjudandematris som en filström. Filströmmen är antingen en .csv-fil eller en komprimerad zip-version av .csv.

Svarsframgång och felkoder

Varje svar levereras med en HTTP-statuskod som anger lyckad eller misslyckad och ytterligare felsökningsinformation. Använd ett verktyg för nätverksspårning för att läsa den här koden, feltypen och ytterligare parametrar. Den fullständiga listan finns i Felkoder.

Svarsexempel

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 ==============

Nästa steg