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

  • Článek

Platí pro: Partnerské centrum | Partnerské centrum provozované společností 21Vianet | Partnerské centrum pro Microsoft Cloud for US Government

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 Identifikátor URI žádosti
GET {baseURL}/partner/v1/analytics/indirectresellers HTTP/1.1

Parametry identifikátoru URI

Parametr Typ Description
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
name řetězec Název partnera, pro kterého chcete načíst data nepřímých prodejců.
Trhu řetězec Trh partnera, pro kterého chcete načíst data nepřímých prodejců.
firstSubscriptionCreationDate string ve formátu data a času UTC Datum vytvoření prvního předplatného, na jehož základě chcete načíst data nepřímých prodejců.
latestSubscriptionCreationDate string ve formátu data a času UTC Datum vytvoření nejnovějšího předplatného.
firstSubscriptionEndDate string ve formátu data a času UTC První ukončení předplatného
latestSubscriptionEndDate string ve formátu data a času UTC Poslední datum ukončení předplatného.
firstSubscriptionSuspendedDate string v date a čase UTC Poprvé bylo jakékoli předplatné pozastaveno.
latestSubscriptionSuspendedDate string ve formátu data a času UTC Nejpozději k datu pozastavení předplatného
firstSubscriptionDeprovisionedDate string ve formátu data a času UTC Poprvé došlo ke zrušení zřízení libovolného předplatného.
latestSubscriptionDeprovisionedDate string ve formátu data a času UTC Poslední datum zrušení zřízení předplatného.
subscriptionCount double Počet předplatných pro všechny prodejce s přidanou hodnotou
licenseCount double Počet licencí pro všechny prodejce s přidanou hodnotou.
indirectResellerCount double Počet nepřímých prodejců
top ř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 10000. Pokud je v dotazu 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 rozsáhlé 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.
filter řetězec Parametr filter požadavku obsahuje jeden nebo více příkazů, které filtrují řádky v odpovědi. Každý příkaz obsahuje pole a hodnotu, které jsou přidružené k operátorům eq nebo a příkazy lze kombinovat pomocí nebo andor.ne Můžete zadat následující pole:

partnerTenantId
id
Název
Trhu
firstSubscriptionCreationDate
latestSubscriptionCreationDate
firstSubscriptionEndDate
latestSubscriptionEndDate
firstSubscriptionSuspendedDate
latestSubscriptionSuspendedDate
firstSubscriptionDeprovisionedDate
latestSubscriptionDeprovisionedDate

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))
aggregationLevel řetězec Určuje časový rozsah, pro který se mají načíst agregovaná data. Může to být jeden z následujících řetězců: "day", "week" nebo "month". Pokud není zadán, výchozí hodnota je "day" (den).

aggregationLevelnení podporován bez .aggregationLevel aggregationLevel se vztahuje na všechna kalendářní pole , která jsou v aggregationLevel
Orderby řetězec Příkaz, který seřídí hodnoty výsledných dat pro každou instalaci. Syntaxe je ...&orderby=field[order],field [order],.... Parametr pole může být jeden z následujících řetězců:

"partnerTenantId"
"id"
"name"
"trh"
"firstSubscriptionCreationDate"
"latestSubscriptionCreationDate"
"firstSubscriptionEndDate"
"latestSubscriptionEndDate"
"firstSubscriptionSuspendedDate"
"latestSubscriptionSuspendedDate"
"firstSubscriptionDeprovisionedDate"
"latestSubscriptionDeprovisionedDate"
"subscriptionCount"
"licenseCount"

Parametr order je volitelný a může být asc nebo desc; určující vzestupné nebo sestupné pořadí pro každé pole. Výchozí formát 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
firstSubscriptionCreationDate
latestSubscriptionCreationDate
firstSubscriptionEndDate
latestSubscriptionEndDate
firstSubscriptionSuspendedDate
latestSubscriptionSuspendedDate
firstSubscriptionDeprovisionedDate
latestSubscriptionDeprovisionedDate

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

indirectResellerCount
licenseCount
subscriptionCount

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 Hlavičky REST 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 text odpovědi kolekci prostředků nepřímých prodejců .

Úspěšné odpovědi a kódy chyb

Každá odpověď obsahuje stavový kód HTTP, který označuje úspěch nebo neúspěch, 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": "AAAAAAAA-BBBB-CCCC-DDDD-EEEEEEEEEEEE",
    "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é