Partager via

Obtenir toutes les informations analytiques sur les revendeurs indirects

  • Article

S’applique à : Espace partenaires | Espace partenaires géré par 21Vianet | Espace partenaires de Microsoft Cloud for US Government

Comment obtenir toutes les informations d’analyse des revendeurs indirects pour vos clients.

Prérequis

Demande REST

Syntaxe de la requête

Méthode URI de demande
GET {baseURL}/partner/v1/analytics/indirectresellers HTTP/1.1

Paramètres d’URI

Paramètre Type Description
partnerTenantId string ID de locataire du partenaire pour lequel vous souhaitez récupérer les données des revendeurs indirects.
id string ID de revendeur indirect
name chaîne Nom du partenaire pour lequel vous souhaitez récupérer les données des revendeurs indirects.
market string Marché du partenaire pour lequel vous souhaitez récupérer les données des revendeurs indirects.
firstSubscriptionCreationDate Chaîne au format date/heure UTC Date de création du premier abonnement en fonction de laquelle vous souhaitez récupérer les données des revendeurs indirects.
latestSubscriptionCreationDate Chaîne au format date/heure UTC Date de création de l’abonnement le plus récent.
firstSubscriptionEndDate Chaîne au format date/heure UTC Première fois qu’un abonnement a été terminé.
latestSubscriptionEndDate Chaîne au format date/heure UTC Date la plus récente de la fin de l’abonnement.
firstSubscriptionSuspendedDate chaîne dans l’heure de date UTC Première fois qu’un abonnement a été suspendu.
latestSubscriptionSuspendedDate Chaîne au format date/heure UTC Date la plus récente à laquelle un abonnement a été suspendu.
firstSubscriptionDeprovisionedDate Chaîne au format date/heure UTC Première fois qu’un abonnement a été déprovisionné.
latestSubscriptionDeprovisionedDate Chaîne au format date/heure UTC Date la plus récente à laquelle un abonnement a été déprovisionné.
subscriptionCount double Nombre d’abonnements pour tous les revendeurs à valeur ajoutée
licenseCount double Nombre de licences pour tous les revendeurs à valeur ajoutée.
indirectResellerCount double Nombre de revendeurs indirects
haut string Nombre de lignes de données à retourner dans la requête. La valeur maximale et la valeur par défaut si elle n’est pas spécifiée est de 10 000. S’il existe plus de lignes dans la requête, le corps de la réponse inclut un lien suivant que vous pouvez utiliser pour demander la page suivante de données.
skip int Nombre de lignes à ignorer dans la requête. Utilisez ce paramètre pour parcourir des jeux de données volumineux. Par exemple, top=10000 and skip=0 récupère les 10 000 premières lignes de données, top=10000 and skip=10000 récupère les 10 000 lignes de données suivantes, et ainsi de suite.
filter string Le paramètre de filtre de la requête contient une ou plusieurs instructions qui filtrent les lignes dans la réponse. Chaque instruction contient un champ et une valeur associés aux opérateurs ou opérateurs, et les instructions peuvent être combinées à l’aide eq and ou or.ne Spécifiez les champs suivants :

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

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

Exemple :
.../indirectresellers?filter=market eq 'US' or (firstSubscriptionCreationDate le cast('2018-01-01',Edm.DateTimeOffset) and firstSubscriptionCreationDate le cast('2018-04-01',Edm.DateTimeOffset))
aggregationLevel string Spécifie l’intervalle de temps pour lequel récupérer des données agrégées. Il peut s’agir de l’une des chaînes suivantes : « jour », « semaine » ou « mois ». S’il n’est pas spécifié, la valeur par défaut est « day ».

aggregationLevel n’est pas pris en charge sans aggregationLevel. aggregationLevel s’applique à tous les champs de date présents dans le aggregationLevel
orderby string Instruction qui commande les valeurs de données de résultat pour chaque installation. La syntaxe est ...&orderby=field[order],field [order],.... Le paramètre de champ peut être l’une des chaînes suivantes :

« partnerTenantId »
« ID »
"name"
« market »
« firstSubscriptionCreationDate »
« latestSubscriptionCreationDate »
« firstSubscriptionEndDate »
« latestSubscriptionEndDate »
« firstSubscriptionSuspendedDate »
« latestSubscriptionSuspendedDate »
« firstSubscriptionDeprovisionedDate »
« latestSubscriptionDeprovisionedDate »
« subscriptionCount »
« licenseCount »

Le paramètre d’ordre est facultatif et peut être asc ou desc; pour spécifier l’ordre croissant ou décroissant pour chaque champ. Par défaut, il s’agit de asc.

Exemple :
...&orderby=market,subscriptionCount
groupby string Instruction qui applique l’agrégation de données uniquement aux champs spécifiés. Spécifiez les champs suivants :

partnerTenantId
Identifiant
Nom
market
firstSubscriptionCreationDate
latestSubscriptionCreationDate
firstSubscriptionEndDate
latestSubscriptionEndDate
firstSubscriptionSuspendedDate
latestSubscriptionSuspendedDate
firstSubscriptionDeprovisionedDate
latestSubscriptionDeprovisionedDate

Les lignes de données retournées contiennent les champs spécifiés dans la groupby clause et les champs suivants :

indirectResellerCount
licenseCount
subscriptionCount

Le groupby paramètre peut être utilisé avec le aggregationLevel paramètre.

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

En-têtes de requête

Pour plus d’informations, consultez En-têtes REST de l’Espace Partenaires.

Corps de la demande

Aucune.

Exemple de requête

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

Réponse REST

Si elle réussit, le corps de la réponse contient une collection de ressources de revendeurs indirects .

Codes d’erreur et de réussite de la réponse

Chaque réponse est fournie avec un code d’état HTTP qui indique la réussite ou l’échec et d’autres informations de débogage. Utilisez un outil de suivi réseau pour lire ce code, le type d’erreur et d’autres paramètres. Pour obtenir la liste complète, consultez Codes d’erreur.

Exemple de réponse

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

Voir aussi