Sdílet prostřednictvím

Získání všech analytických informací nepřímých prodejců

  • Článek

platí pro: Partnerské centrum | Partnerské centrum provozované společností 21Vianet | Partnerské centrum pro Microsoft Cloud pro státní správu USA

Jak získat všechny analytické informace nepřímých prodejců pro vaše zákazníky.

Požadavky

Požadavek REST

Syntaxe požadavku

Metoda Požadavek URI
GET {baseURL}/partner/v1/analytics/indirectresellers HTTP/1.1

Parametry identifikátoru URI

Parametr Typ Popis
partnerTenantId řetězec ID tenanta partnera, pro kterého chcete načíst data nepřímých prodejců.
id řetězec ID nepřímého prodejce
Jméno řetězec Název partnera, pro kterého chcete načíst data nepřímých prodejců.
trh řetězec Trh partnera, pro kterého chcete načíst data nepřímých prodejců.
datumPrvníhoVytvořeníPředplatného řetězec ve formátu data a času UTC Datum vytvoření prvního předplatného, na základě kterého chcete načíst data nepřímých prodejců.
datum vytvoření nejnovějšího předplatného řetězec v UTC časovém formátu Datum vytvoření nejnovějšího předplatného.
datum ukončení prvního předplatného řetězec ve formátu data a času podle UTC Poprvé bylo ukončeno jakékoliv předplatné.
nejnovějšíDatumKoncePředplatného řetězec textu ve formátu data a času UTC Datum posledního ukončení předplatného
datumPrvníhoPozastaveníPředplatného řetězec v UTC datovém čase Poprvé bylo pozastaveno jakékoliv předplatné.
datum nejnovějšího pozastavení předplatného řetězec v UTC časovém formátu Datum posledního pozastavení předplatného
datum prvního zrušení předplatného řetězec ve formátu data a času UTC Poprvé bylo zrušeno jakékoli předplatné.
DatumDeaktivaceNejnovějšíhoPředplatného řetězec ve formátu data a času UTC Datum, kdy bylo naposledy odebráno libovolné předplatné.
počet předplatných dvojitý Počet předplatných pro všechny prodejce s přidanou hodnotou
počet licencí dvojitý Počet licencí pro všechny prodejce s přidanou hodnotou
PočetNepřímýchProdejců dvojitý Počet nepřímých prodejců
vrchol řetězec Počet řádků dat, které se mají v požadavku vrátit. Maximální hodnota a výchozí hodnota, pokud není zadána, je 10 000. Pokud dotaz obsahuje více řádků, text odpovědi obsahuje další odkaz, který můžete použít k vyžádání další stránky dat.
přeskočit Int Počet řádků, které se mají v dotazu přeskočit. Pomocí tohoto parametru můžete procházet velké datové sady. Například top=10000 and skip=0 načte prvních 10 000 řádků dat, top=10000 and skip=10000 načte dalších 10 000 řádků dat atd.
filtr řetězec Parametr filtru požadavku obsahuje jeden nebo více příkazů, které filtrují řádky v odpovědi. Každý příkaz obsahuje pole a hodnotu přidruženou k operátorům eq nebo ne a příkazy lze kombinovat pomocí and nebo or. Můžete zadat následující pole:

partnerTenantId
id
název
trh
datumPrvníhoVytvořeníPředplatného
datum založení nejnovějšího předplatného
datum konce prvního předplatného
nejnovější datum konce předplatného
prvníDatumPozastaveníPředplatného
Nejnovější datum pozastavení předplatného
datum prvního zrušení předplatného
datum posledního zneplatnění předplatného

Příklad :
.../indirectresellers?filter=market eq 'US'

Příklad :
.../indirectresellers?filter=market eq 'US' or (firstSubscriptionCreationDate le cast('2018-01-01',Edm.DateTimeOffset) and firstSubscriptionCreationDate le cast('2018-04-01',Edm.DateTimeOffset))
úroveň agregace řetězec Určuje časový rozsah, pro který se mají načítat agregovaná data. Může to být jeden z následujících řetězců: "den", "týden" nebo "měsíc". Pokud není zadáno, výchozí hodnota je "den".

aggregationLevel se nepodporuje bez aggregationLevel. aggregationLevel platí pro všechna datumová pole v aggregationLevel
orderby řetězec Příkaz, který objedná hodnoty výsledných dat pro každou instalaci. Syntaxe je ...&orderby=field[order],field [order],.... Parametr pole může být jedním z následujících řetězců:

partnerTenantId
"ID"
"jméno"
trh
datumPrvníhoVytvořeníPředplatného
"datumVytvořeníNejnovějšíhoPředplatného"
datumKoncePrvníhoPředplatného
nejnovějšíDatumUkončeníPředplatného
"datumPrvníhoPozastaveníPředplatného"
datum posledního pozastavení předplatného
"datumPrvníhoOdprovisionováníPředplatného"
"datumZrušeníPosledníhoPředplatného"
počet předplatných
počet licencí

Parametr pořadí je volitelný a může být asc nebo desc; pro každé pole zadejte vzestupné nebo sestupné pořadí. Výchozí hodnota je asc.

Příklad :
...&orderby=market,subscriptionCount
groupby řetězec Příkaz, který použije agregaci dat pouze na zadaná pole. Můžete zadat následující pole:

partnerTenantId
id
název
trhu
datumPrvníhoVytvořeníPředplatného
nejnovější datum vytvoření předplatného
datum ukončení prvního předplatného
nejnovější datum konce předplatného
datum prvního pozastavení předplatného
datumPosledníhoPozastaveníPředplatného
prvníDatumDeaktivacePředplatného
nejnovější SubscriptionDeprovisionedDate

Vrácené datové řádky obsahují pole zadaná v klauzuli groupby a následující pole:

Počet nepřímých prodejců
počet licencí
počet předplatných

Parametr groupby lze použít s parametrem aggregationLevel.

Příklad :
...&groupby=ageGroup,market&aggregationLevel=week

Hlavičky požadavku

Další informace najdete v tématu REST hlaviček Partnerského centra.

Text požadavku

Žádný.

Příklad požadavku

GET https://api.partnercenter.microsoft.com/partner/v1/analytics/indirectresellers HTTP 1.1
Authorization: Bearer <token>
Accept: application/json
Content-Type: application/json
Content-Length: 0

Odpověď REST

V případě úspěchu obsahuje tělo odpovědi kolekci nepřímých prodejců prostředky.

Kódy úspěšnosti a chyb odpovědi

Každá odpověď obsahuje stavový kód HTTP, který označuje úspěch nebo selhání a další informace o ladění. Ke čtení tohoto kódu, typu chyby a dalších parametrů použijte nástroj pro trasování sítě. Úplný seznam najdete v tématu Kódy chyb.

Příklad odpovědi

{
    "partnerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "id": "1111111",
    "name": "RESELLER NAME",
    "market": "US",
    "firstSubscriptionCreationDate": "2016-10-18T19:16:25.107",
    "latestSubscriptionCreationDate": "2016-10-18T19:16:25.107",
    "firstSubscriptionEndDate": "2018-11-07T00:00:00",
    "latestSubscriptionEndDate": "2018-11-07T00:00:00",
    "firstSubscriptionSuspendedDate": "0001-01-01T00:00:00",
    "latestSubscriptionSuspendedDate": "0001-01-01T00:00:00",
    "firstSubscriptionDeprovisionedDate": "0001-01-01T00:00:00",
    "latestSubscriptionDeprovisionedEndDate": "0001-01-01T00:00:00",
    "subscriptionCount": 10,
    "licenseCount": 20
}

Viz také