Condividi tramite

Ottenere una matrice di offerte

  • Articolo

Questo articolo illustra come ottenere una matrice di offerte per un determinato mese. La matrice dell'offerta include proprietà e regole di acquisto per i prodotti e gli SKU. Questo metodo supporta i filtri per ottenere la cronologia per mese.

Prerequisiti

  • Credenziali descritte in Autenticazione per l'API Partner. Questo scenario supporta solo l'autenticazione dell'utente dell'applicazione. La sola applicazione non è ancora supportata. I partner che riscontrano l'errore http:400 devono consultare la documentazione relativa all'autenticazione dell'API partner.
  • Questa API supporta attualmente solo l'accesso utente in cui i partner devono trovarsi in uno dei ruoli seguenti: Agente amministratore o Agente di vendita.

Dettagli

  • Il valore corrente restituisce i dati solo per i nuovi prodotti basati sulle licenze commerciali aggiornati.
  • I prezzi correnti includono i prodotti disponibili durante il mese corrente fino alla data in cui viene chiamata l'API. I mesi precedenti includono la data dell'ultimo giorno del mese selezionato.
  • Questo metodo restituisce i dati come flusso di file. Il flusso di file è un file .csv o una versione compressa zip del .csv. Per informazioni dettagliate su come richiedere file compressi, seguire questa procedura.

Richiesta REST

Sintassi della richiesta

metodo URI della richiesta
GET https://api.partner.microsoft.com/v1.0/sales/offermatrix(Month='{date}')/$value

Parametri di filtro URI

Usare i parametri di filtro seguenti.

Nome Digita Obbligatorio Descrizione
Mese string No Deve essere conforme a AAAAMM per il listino prezzi richiesto.

Intestazioni delle richieste

Oltre a queste intestazioni, i file dei prezzi possono essere recuperati come compressi riducendo la larghezza di banda e i tempi di download. Per impostazione predefinita, i file non vengono compressi. Per ottenere versioni compresse dei file, è possibile includere il valore di intestazione seguente. Tenere presente che i fogli compressi sono disponibili solo da aprile 2020 in poi, tutti i fogli precedenti ad aprile 2020 sono disponibili solo come non compressi.

Intestazione Tipo di valore valore Descrizione
Accept-Encoding string sgonfiare Facoltativo. Se omesso, il flusso di file non viene compresso.

Esempio di richiesta

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

Risposta REST

In caso di esito positivo, questo metodo restituisce una matrice di offerta come flusso di file. Il flusso di file è un file .csv o una versione compressa zip del .csv.

Codici di errore e di esito della risposta

Ogni risposta viene fornita con un codice di stato HTTP che ne indica l'esito e con informazioni di debug aggiuntive. Usa uno strumento di traccia di rete per leggere il codice, il tipo di errore e parametri aggiuntivi. Per l'elenco completo, vedi Codici di errore.

Risposta di esempio

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

Contenuto correlato