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 inkluderar egenskaper och regler för inköp 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. Enbart applikationer 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: Administratörsagent eller Försäljningsagent.

Detaljer

  • 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 följer.

REST-begäran

Syntax för begäran

Metod Begäran URI
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 använda formatet YYYYMM för prisbladet som begärs.

Begärandehuvuden

Förutom de här rubrikerna 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 följande rubrikvärde. 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.

Header Värdetyp Värde Beskrivning
Accept-Encoding sträng Tömma Valfritt. Om det utelämnas komprimeras inte filströmmen.

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

Relaterat innehåll