Delen via

Alle analysegegevens van indirecte resellers ophalen

  • Artikel

van toepassing op: Partnercentrum | Partnercentrum beheerd door 21Vianet | Partnercentrum voor Microsoft Cloud voor de Amerikaanse overheid

Hoe u alle analysegegevens van indirecte resellers voor uw klanten kunt ophalen.

Voorwaarden

REST-aanvraag

Aanvraagsyntaxis

Methode Aanvraag-URI
GET {baseURL}/partner/v1/analytics/indirectresellers HTTP/1.1

URI-parameters

Parameter Type Beschrijving
partnerGehuurderId snaar De tenant-id van de partner waarvoor u indirecte resellers-gegevens wilt ophalen.
legitimatiebewijs snaar Indirecte verkoper-ID
naam snaar De naam van de partner waarvoor u gegevens van indirecte resellers wilt ophalen.
markt snaar De markt van de partner waarvoor u indirecte resellers-gegevens wilt ophalen.
eersteAbonnementAanmakenDatum tekenreeks in utc-datum/tijdnotatie De aanmaakdatum van het eerste abonnement op basis waarvan u de gegevens van indirecte resellers wilt ophalen.
nieuwsteAbonnementAanmakenDatum Tekenreeks in UTC-datum/tijdformaat De aanmaakdatum van het meest recente abonnement.
eersteAbonnementsEindDatum tekenreeks in UTC-datum/tijdformaat De eerste keer dat een abonnement is beëindigd.
laatste abonnementsvervaldatum Tekenreeks in UTC-datum-/tijdnotatie Laatste datum waarop een abonnement is beëindigd.
eersteAbonnementOpgeschortDatum string in UTC-datumtijd De eerste keer dat een abonnement is onderbroken.
laatsteAbonnementOnderbrokenDatum tekenreeks in UTC-datum/tijdformaat Laatste datum waarop een abonnement is onderbroken.
datumEersteAbonnementGedeactiveerd tekenreeks in UTC-datum/tijdformaat De eerste keer dat een abonnement is beëindigd.
datumLaatsteAbonnementOpgeheven String in UTC-datum/tijdnotatie De laatste datum waarop een abonnement ongedaan is gemaakt.
abonnementsaantal dubbel Aantal abonnementen voor alle toegevoegde waarde-resellers
licenseCount dubbel Aantal licenties voor alle toegevoegde waarde resellers.
aantalIndirecteResellers dubbel Aantal indirecte resellers
Boven snaar Het aantal rijen met gegevens dat moet worden geretourneerd in de aanvraag. De maximumwaarde en de standaardwaarde als deze niet zijn opgegeven, is 10.000. Als er meer rijen in de query staan, bevat de hoofdtekst van het antwoord een volgende koppeling die u kunt gebruiken om de volgende pagina met gegevens aan te vragen.
overslaan Int Het aantal rijen dat moet worden overgeslagen in de query. Gebruik deze parameter om door grote gegevenssets te bladeren. top=10000 and skip=0 bijvoorbeeld de eerste 10.000 rijen met gegevens ophaalt, top=10000 and skip=10000 de volgende 10.000 rijen met gegevens, enzovoort, ophaalt.
filter snaar Het filter parameter van de aanvraag bevat een of meer instructies waarmee de rijen in het antwoord worden gefilterd. Elke instructie bevat een veld en waarde die zijn gekoppeld aan de operatoren eq of ne en instructies kunnen worden gecombineerd met behulp van and of or. U kunt de volgende velden opgeven:

partnerTenantId
id
naam
markt
eersteAbonnementCreatieDatum
nieuwsteAbonnementAanmakenDatum
firstSubscriptionEndDate
laatsteAbonnementsverloopdatum
eersteAbonnementOpgeschortDatum
latestSubscriptionSuspendedDate
firstSubscriptionDeprovisionedDate
latestSubscriptionDeprovisionedDate

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

voorbeeld:
.../indirectresellers?filter=market eq 'US' or (firstSubscriptionCreationDate le cast('2018-01-01',Edm.DateTimeOffset) and firstSubscriptionCreationDate le cast('2018-04-01',Edm.DateTimeOffset))
aggregatieniveau snaar Hiermee geeft u het tijdsbereik op waarvoor geaggregeerde gegevens moeten worden opgehaald. Dit kan een van de volgende tekenreeksen zijn: 'day', 'week' of 'month'. Als dit niet is opgegeven, is de standaardwaarde 'dag'.

aggregationLevel wordt niet ondersteund zonder een aggregationLevel. aggregationLevel geldt voor alle datumvelden aanwezig in de aggregationLevel
orderby tekenreeks Een instructie die de gegevenswaarden van het resultaat voor elke installatie sorteert. De syntaxis is ...&orderby=field[order],field [order],.... De veldparameter kan een van de volgende tekenreeksen zijn:

"partnerTenantId"
"id"
"naam"
"markt"
eersteAbonnementAanmaakdatum
laatsteAbonnementsAanmaakDatum
eindeDatumEersteAbonnement
meestRecenteAbonnementsEinddatum
eersteAbonnementOpgeschortDatum
laatsteAbonnementGeschorstDatum
eersteAbonnementGeblokkeerdDatum
laatsteAbonnementOpheffingsdatum
"subscriptionCount"
licentieAantal

De parameter volgorde is optioneel en kan worden asc of desc; om oplopende of aflopende volgorde voor elk veld op te geven. De standaardwaarde is asc.

voorbeeld:
...&orderby=market,subscriptionCount
groupby snaar Een instructie die alleen gegevensaggregatie toepast op de opgegeven velden. U kunt de volgende velden opgeven:

partnerTenantId
ID
Naam
markt
datumEersteAbonnementAanmaak
latestSubscriptionCreationDate
eersteEinddatumAbonnement
latestSubscriptionEndDate-
eersteAbonnementOpgeschortDatum
latestSubscriptionSuspendedDate
eersteAbonnementGededeprovisioneerdeDatum
latestSubscriptionDeprovisionedDate

De geretourneerde gegevensrijen bevatten de velden die zijn opgegeven in de groupby-component en de volgende velden:

indirectResellerCount
licenseCount
aantal abonnementen

De parameter groupby kan worden gebruikt met de parameter aggregationLevel.

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

Aanvraagheaders

Zie Partnercentrum REST-headersvoor meer informatie.

Aanvraaginhoud

Geen.

Voorbeeld van aanvraag

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

Als dit lukt, bevat de antwoordtekst een verzameling van bronnen voor indirecte resellers.

Geslaagde antwoorden en foutcodes

Elk antwoord wordt geleverd met een HTTP-statuscode die het succes of de mislukking aangeeft en andere foutopsporingsinformatie. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en andere parameters te lezen. Zie Foutcodesvoor de volledige lijst.

Voorbeeld van antwoord

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

Zie ook