Teilen über

Abrufen aller Informationen zur Analyse von indirekten Vertriebspartnern

  • Artikel

Gilt für: Partner Center | Partner Center-Betrieb durch 21Vianet | Partner Center für Microsoft Cloud for US Government

So erhalten Sie alle indirekten Händleranalyseinformationen für Ihre Kunden.

Voraussetzungen

  • Anmeldeinformationen, wie unter Partner Center-Authentifizierung beschrieben. Dieses Szenario unterstützt nur die Authentifizierung mit Benutzeranmeldeinformationen.

REST-Anforderung

Anforderungssyntax

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

URI-Parameter

Parameter Typ Beschreibung
partnerTenantId Zeichenfolge Die Mandanten-ID des Partners, für den Sie indirekte Händlerdaten abrufen möchten.
id Zeichenfolge Indirekte Händler-ID
name Zeichenfolge Der Name des Partners, für den Sie indirekte Händlerdaten abrufen möchten.
Markt Zeichenfolge Der Markt des Partners, für den Sie indirekte Händlerdaten abrufen möchten.
firstSubscriptionCreationDate Zeichenfolge im UTC-Zeitformat (Datum und Uhrzeit) Das Erstellungsdatum des ersten Abonnements, basierend auf dem Sie indirekte Händlerdaten abrufen möchten.
latestSubscriptionCreationDate Zeichenfolge im UTC-Zeitformat (Datum und Uhrzeit) Das Erstellungsdatum des neuesten Abonnements.
firstSubscriptionEndDate Zeichenfolge im UTC-Zeitformat (Datum und Uhrzeit) Das erste Mal, wenn ein Abonnement beendet wurde.
latestSubscriptionEndDate Zeichenfolge im UTC-Zeitformat (Datum und Uhrzeit) Das letzte Datum, an dem ein Abonnement beendet wurde.
firstSubscriptionSuspendedDate Zeichenfolge in UTC-Datumszeit Das erste Mal, wenn ein Abonnement ausgesetzt wurde.
latestSubscriptionSuspendedDate Zeichenfolge im UTC-Zeitformat (Datum und Uhrzeit) Das neueste Datum, an dem ein Abonnement ausgesetzt wurde.
firstSubscriptionDeprovisionedDate Zeichenfolge im UTC-Zeitformat (Datum und Uhrzeit) Jedes Abonnement wurde zum ersten Mal aufgehoben.
latestSubscriptionDeprovisionedDate Zeichenfolge im UTC-Zeitformat (Datum und Uhrzeit) Das neueste Datum, an dem ein Abonnement aufgehoben wurde.
subscriptionCount double Abonnementanzahl für alle Mehrwerthändler
licenseCount double Lizenzanzahl für alle Mehrwerthändler.
indirectResellerCount double Anzahl indirekter Wiederverkäufer
Oben Zeichenfolge Die Anzahl der Datenzeilen, die in der Anforderung zurückgegeben werden sollen. Der Maximalwert und der Standardwert, wenn nicht angegeben ist, ist 10.000. Wenn in der Abfrage weitere Zeilen vorhanden sind, enthält der Antworttext einen nächsten Link, den Sie verwenden können, um die nächste Seite mit Daten anzufordern.
skip int Die Anzahl der Zeilen, die in der Abfrage übersprungen werden sollen. Verwenden Sie diesen Parameter, um große Datasets zu durchlaufen. Ruft beispielsweise top=10000 and skip=0 die ersten 10.000 Datenzeilen ab, top=10000 and skip=10000 ruft die nächsten 10.000 Datenzeilen ab usw.
filter Zeichenfolge Der Filter-Parameter der Anforderung enthält eine oder mehrere Anweisungen, die die Zeilen in der Antwort filtern. Jede Anweisung enthält ein Feld und einen Wert, die den eq Operatoren ne zugeordnet sind, und Anweisungen können mithilfe and oder orkombiniert werden. Sie können die folgenden Felder angeben:

partnerTenantId
id
Name
market
firstSubscriptionCreationDate
latestSubscriptionCreationDate
firstSubscriptionEndDate
latestSubscriptionEndDate
firstSubscriptionSuspendedDate
latestSubscriptionSuspendedDate
firstSubscriptionDeprovisionedDate
latestSubscriptionDeprovisionedDate

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

Beispiel:
.../indirectresellers?filter=market eq 'US' or (firstSubscriptionCreationDate le cast('2018-01-01',Edm.DateTimeOffset) and firstSubscriptionCreationDate le cast('2018-04-01',Edm.DateTimeOffset))
aggregationLevel Zeichenfolge Gibt den Zeitraum an, für den aggregierte Daten abgerufen werden sollen. Dies kann eine der folgenden Zeichenfolgen sein: "Tag", "Woche" oder "Monat". Wenn nicht angegeben, lautet der Standardwert "Day".

aggregationLevel wird nicht ohne ein aggregationLevel. aggregationLevel gilt für alle Datumsfelder , die in der aggregationLevel
orderby Zeichenfolge Eine Anweisung, die die Ergebnisdatenwerte für jede Installation anordnet. Die Syntax lautet ...&orderby=field[order],field [order],.... Der Feldparameter kann eine der folgenden Zeichenfolgen sein:

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

Der Order-Parameter ist optional und kann oder ; sein asc desc, um die aufsteigende oder absteigende Reihenfolge für jedes Feld anzugeben. Der Standardwert ist asc.

Beispiel:
...&orderby=market,subscriptionCount
groupby Zeichenfolge Eine Anweisung, die Datenaggregation nur auf die angegebenen Felder anwendet. Sie können die folgenden Felder angeben:

partnerTenantId
ID
Name
market
firstSubscriptionCreationDate
latestSubscriptionCreationDate
firstSubscriptionEndDate
latestSubscriptionEndDate
firstSubscriptionSuspendedDate
latestSubscriptionSuspendedDate
firstSubscriptionDeprovisionedDate
latestSubscriptionDeprovisionedDate

Die zurückgegebenen Datenzeilen enthalten die in der groupby Klausel angegebenen Felder und die folgenden Felder:

indirectResellerCount
licenseCount
subscriptionCount

Der groupby Parameter kann mit dem aggregationLevel Parameter verwendet werden.

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

Anforderungsheader

Weitere Informationen finden Sie unter Partner Center-REST-Header.

Anforderungstext

Keine.

Anforderungsbeispiel

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

Bei erfolgreicher Ausführung enthält der Antworttext eine Sammlung indirekter Wiederverkäuferressourcen .

Erfolgs- und Fehlercodes der Antwort

Jede Antwort enthält einen HTTP-Statuscode, der Erfolg oder Fehler und andere Debuginformationen angibt. Verwenden Sie ein Netzwerkablaufverfolgungstool, um diesen Code, fehlertyp und andere Parameter zu lesen. Die vollständige Liste findest du unter Partner-API: REST-Fehlercodes.

Beispielantwort

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

Weitere Informationen