Alle analysegegevens van verwijzingen ophalen

Artikel
06/19/2023

Van toepassing op: Partnercentrum | Partnercentrum voor Microsoft Cloud for US Government

Hoe u alle verwijzingsanalysegegevens voor uw klanten kunt ophalen.

Vereisten

Referenties zoals beschreven in Partnercentrum-verificatie. Dit scenario ondersteunt verificatie met alleen gebruikersreferenties.

REST-aanvraag

Aanvraagsyntaxis

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

URI-parameters

Parameter	Type	Beschrijving
filter	tekenreeks	Retourneert gegevens die overeenkomen met de filtervoorwaarde. Voorbeeld: `.../referrals?filter=field eq 'value'`
groupby	tekenreeks	Ondersteunt zowel termen als datums. Kortsluitingslogica om het aantal buckets te beperken. Voorbeeld: `.../referrals?groupby=termField1,dateField1,termField2`
aggregationLevel	tekenreeks	Voor de parameter aggregationLevel is een groupby vereist. De parameter aggregationLevel is van toepassing op alle datumvelden die aanwezig zijn in de groupby. Voorbeeld: `.../referrals?groupby=termField1,dateField1,termField2&aggregationLevel=day`
top	tekenreeks	De paginalimiet is 10000. Neemt een waarde kleiner dan 10000. Voorbeeld: `.../referrals?top=100`
skip	tekenreeks	Aantal rijen dat moet worden overgeslagen. Voorbeeld: `.../referrals?top=100&skip=100`

Aanvraagheaders

Zie Rest-headers van partnercentrum voor meer informatie.

Aanvraagbody

Geen.

Voorbeeld van aanvraag

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

Als dit lukt, bevat de hoofdtekst van het antwoord een verzameling verwijzingenresources .

Geslaagde en foutcodes voor antwoorden

Elk antwoord wordt geleverd met een HTTP-statuscode die aangeeft dat het is gelukt of mislukt en aanvullende informatie over foutopsporing. Gebruik een hulpprogramma voor netwerktracering om deze code, het fouttype en aanvullende parameters te lezen. Zie Foutcodes voor de volledige lijst.

Voorbeeld van antwoord

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

Zie ook

Partnercentrum Analytics - Bronnen

Delen via