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 erhalten.
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 zum Einschränken der Anzahl von Buckets. Beispiel: .../referrals?groupby=termField1,dateField1,termField2 |
| aggregationLevel | Zeichenfolge | Der AggregationLevel-Parameter erfordert eine Groupby. Der AggregationLevel-Parameter gilt für alle Datumsfelder, die in der Groupby vorhanden sind. Beispiel: .../referrals?groupby=termField1,dateField1,termField2&aggregationLevel=day |
| Oben | Zeichenfolge | Der Seitengrenzwert beträgt 10000. Verwendet einen beliebigen Wert kleiner als 10000. 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 Verweisen-Ressourcen .
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.
Beispielantwort
{
"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"
}