Freigeben über


Abrufen aller Informationen zur Empfehlungsanalyse

Gilt für: Partner Center | Partner Center für Microsoft Cloud for US Government

Hier erfahren Sie, wie Sie alle Informationen zur Empfehlungsanalyse für Ihre Kunden abrufen.

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/referrals HTTP/1.1

URI-Parameter

Parameter Typ Beschreibung
filter Zeichenfolge Gibt Daten zurück, die der Filterbedingung entsprechen.
Beispiel:
.../referrals?filter=field eq 'value'
groupby Zeichenfolge Unterstützt sowohl Begriffe als auch Datumsangaben. Kurzschlusslogik, um die Anzahl der Buckets zu begrenzen.
Beispiel:
.../referrals?groupby=termField1,dateField1,termField2
aggregationLevel Zeichenfolge Der aggregationLevel-Parameter erfordert eine groupby. Der aggregationLevel-Parameter gilt für alle Datumsfelder, die in groupby vorhanden sind.
Beispiel:
.../referrals?groupby=termField1,dateField1,termField2&aggregationLevel=day
top Zeichenfolge Das Seitenlimit ist 10.000. Nimmt jeden Wert kleiner als 10000 an.
Beispiel:
.../referrals?top=100
skip Zeichenfolge Anzahl der zu überspringenden Zeilen.
Beispiel:
.../referrals?top=100&skip=100

Anforderungsheader

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

Anforderungstext

Keine.

Anforderungsbeispiel

GET https://api.partnercenter.microsoft.com/partner/v1/analytics/referrals 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 von Empfehlungenressourcen .

Erfolgs- und Fehlercodes der Antwort

Jede Antwort enthält einen HTTP-Statuscode, der Aufschluss darüber gibt, ob der Vorgang erfolgreich war, sowie ggf. zusätzliche Debuginformationen. Verwende ein Tool für die Netzwerkablaufverfolgung, um diesen Code, den Fehlertyp und zusätzliche Parameter zu lesen. Die vollständige Liste findest du unter Partner-API: REST-Fehlercodes.

Antwortbeispiel

{
  "id": "112310",
  "status": "Accepted",
  "customerMarket": "US",
  "customerName": "Best Customer Ever",
  "customerOrgSize": "10to50employees",
  "acceptedDate": "2018-02-07T23:43:19",
  "acknowledgedDate": "2018-02-07T23:40:50",
  "archivedDate": null,
  "declinedDate": null,
  "expiredDate": null,
  "lostDate": null,
  "missedDate": null,
  "createdDate": "2018-02-04T23:08:59",
  "skippedDate": null,
  "wonDate": null,
  "partnerMarket": "US"
}

Weitere Informationen