Dela via

Hämta all analysinformation för indirekta återförsäljare

  • Artikel

Gäller för: Partnercenter | Partnercenter som drivs av 21Vianet | Partnercenter för Microsoft Cloud for US Government

Så här hämtar du all analysinformation om indirekta återförsäljare för dina kunder.

Förutsättningar

  • Autentiseringsuppgifter enligt beskrivningen i Partnercenter-autentisering. Det här scenariot stöder endast autentisering med användarautentiseringsuppgifter.

REST-begäran

Syntax för begäran

Metod URI för förfrågan
GET {baseURL}/partner/v1/analytics/indirectresellers HTTP/1.1

URI-parametrar

Parameter Typ Beskrivning
partnerTenantId sträng Klientorganisations-ID:t för den partner som du vill hämta data om indirekta återförsäljare för.
id sträng ID för indirekt återförsäljare
name sträng Namnet på den partner som du vill hämta data om indirekta återförsäljare för.
marknad sträng Marknaden för partnern som du vill hämta data om indirekta återförsäljare för.
firstSubscriptionCreationDate sträng i UTC-datumtidsformat Skapandedatumet för den första prenumerationen baserat på vilken du vill hämta data från indirekta återförsäljare.
latestSubscriptionCreationDate sträng i UTC-datumtidsformat Skapandedatumet för den senaste prenumerationen.
firstSubscriptionEndDate sträng i UTC-datumtidsformat Första gången någon prenumeration avslutades.
latestSubscriptionEndDate sträng i UTC-datumtidsformat Senaste datum då en prenumeration avslutades.
firstSubscriptionSuspendedDate sträng i UTC-datumtid Första gången någon prenumeration avbröts.
latestSubscriptionSuspendedDate sträng i UTC-datumtidsformat Senaste datum då en prenumeration stängdes av.
firstSubscriptionDeprovisionedDate sträng i UTC-datumtidsformat Första gången någon prenumeration avetablerades.
latestSubscriptionDeprovisionedDate sträng i UTC-datumtidsformat Senaste datum då en prenumeration avetablerades.
subscriptionCount dubbel Antal prenumerationer för alla mervärdesåterförsäljare
licenseCount dubbel Antal licenser för alla mervärdesåterförsäljare.
indirectResellerCount dubbel Antal indirekta återförsäljare
top sträng Antalet rader med data som ska returneras i begäran. Det maximala värdet och standardvärdet om det inte anges är 10 000. Om det finns fler rader i frågan innehåller svarstexten en nästa länk som du kan använda för att begära nästa sida med data.
hoppa över heltal Antalet rader som ska hoppa över i frågan. Använd den här parametern för att bläddra igenom stora datamängder. Hämtar till exempel top=10000 and skip=0 de första 10 000 raderna med data, top=10000 and skip=10000 hämtar de kommande 10 000 raderna med data och så vidare.
filter sträng Filterparametern för begäran innehåller en eller flera instruktioner som filtrerar raderna i svaret. Varje instruktion innehåller ett fält och ett värde som är associerade med operatorerna eq eller och -instruktioner kan kombineras med eller and orne . Du kan ange följande fält:

partnerTenantId
id
Namn
marknad
firstSubscriptionCreationDate
latestSubscriptionCreationDate
firstSubscriptionEndDate
latestSubscriptionEndDate
firstSubscriptionSuspendedDate
latestSubscriptionSuspendedDate
firstSubscriptionDeprovisionedDate
latestSubscriptionDeprovisionedDate

Exempel:
.../indirectresellers?filter=market eq 'US'

Exempel:
.../indirectresellers?filter=market eq 'US' or (firstSubscriptionCreationDate le cast('2018-01-01',Edm.DateTimeOffset) and firstSubscriptionCreationDate le cast('2018-04-01',Edm.DateTimeOffset))
aggregationLevel sträng Anger det tidsintervall för vilket aggregerade data ska hämtas. Kan vara en av följande strängar: "dag", "vecka" eller "månad". Om det är ospecificerat är standardvärdet "dag".

aggregationLevelstöds inte utan .aggregationLevel aggregationLevel gäller för alla datumfält som finns i aggregationLevel
orderby sträng En instruktion som beställer resultatdatavärdena för varje installation. Syntax: ...&orderby=field[order],field [order],.... Fältparametern kan vara en av följande strängar:

"partnerTenantId"
"ID"
"name"
"marknad"
"firstSubscriptionCreationDate"
"latestSubscriptionCreationDate"
"firstSubscriptionEndDate"
"latestSubscriptionEndDate"
"firstSubscriptionSuspendedDate"
"latestSubscriptionSuspendedDate"
"firstSubscriptionDeprovisionedDate"
"latestSubscriptionDeprovisionedDate"
"subscriptionCount"
"licenseCount"

Orderparametern är valfri och kan vara asc eller desc; för att ange stigande eller fallande ordning för varje fält. Standardvärdet är asc.

Exempel:
...&orderby=market,subscriptionCount
groupby sträng En instruktion som endast tillämpar dataaggregering på de angivna fälten. Du kan ange följande fält:

partnerTenantId
ID
Namn
marknad
firstSubscriptionCreationDate
latestSubscriptionCreationDate
firstSubscriptionEndDate
latestSubscriptionEndDate
firstSubscriptionSuspendedDate
latestSubscriptionSuspendedDate
firstSubscriptionDeprovisionedDate
latestSubscriptionDeprovisionedDate

De datarader som returneras innehåller de fält som anges i groupby -satsen och följande fält:

indirectResellerCount
licenseCount
subscriptionCount

Parametern groupby kan användas med parametern aggregationLevel .

Exempel:
...&groupby=ageGroup,market&aggregationLevel=week

Begärandehuvuden

Mer information finns i REST-huvuden för Partnercenter.

Begärandetext

Inga.

Exempel på begäran

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

REST-svar

Om det lyckas innehåller svarstexten en samling resurser för indirekta återförsäljare .

Svarsframgång och felkoder

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

Svarsexempel

{
    "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
}

Se även