Partager via

Obtenir toutes les informations analytiques sur l’abonnement

  • Article

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

Cet article explique comment obtenir toutes les informations d’analyse d’abonnement pour vos clients.

Prérequis

Demande REST

Syntaxe de la requête

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

Paramètres d’URI

Le tableau suivant répertorie les paramètres facultatifs et leurs descriptions :

Paramètre Type Description
haut int Nombre de lignes de données à retourner dans la requête. Si la valeur n’est pas spécifiée, la valeur maximale et la valeur par défaut sont 10000. 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 et skip=0 récupère les 10 000 premières lignes de données et top=10000skip=10000 récupère les 10 000 lignes de données suivantes.
filter string Une ou plusieurs instructions qui filtrent les lignes dans la réponse. Chaque instruction de filtre contient un nom de champ du corps de la réponse et une valeur associée au eq, neou pour certains champs, l’opérateur contains . Les instructions peuvent être combinées à l’aide and ou or. Les valeurs de chaîne doivent être entourées de guillemets simples dans le paramètre de filtre . Consultez la section suivante pour obtenir la liste des champs qui peuvent être filtrés et les opérateurs pris en charge avec ces champs.
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. Si la valeur n’est pas spécifiée, la valeur par défaut est dateRange. Ce paramètre s’applique uniquement lorsqu’un champ de date est passé dans le cadre du paramètre groupBy .
Groupby string Instruction qui applique l’agrégation de données uniquement aux champs spécifiés.

En-têtes de requête

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

Corps de la demande

Aucun.

Exemple de requête

GET https://api.partnercenter.microsoft.com/partner/v1/analytics/subscriptions
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 d’abonnement.

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 des informations de débogage supplémentaires. 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

{
    "customerTenantId": "76906668-27FC-4F5B-A35C-75A9823E13AF",
    "customerName": "TESTORG65656565",
    "customerMarket": "US",
    "id": "4BF546B2-8998-4838-BEE2-5F1BBE65A04F",
    "status": "ACTIVE",
    "productName": "OFFICE 365 BUSINESS PREMIUM",
    "subscriptionType": "Office",
    "autoRenewEnabled": true,
    "partnerId": "3B33E682-00C3-41EE-9DD2-A548ADF56438",
    "friendlyName": "FULL OFFICE SUITE",
    "partnerName": "Partner Name",
    "providerName": "Provider Name",
    "creationDate": "2016-02-04T19:29:38.037",
   "effectiveStartDate": "2016-02-04T00:00:00",
    "commitmentEndDate": "2019-02-10T00:00:00",
    "currentStateEndDate": "2019-02-10T00:00:00",
    "trialToPaidConversionDate": null,
    "trialStartDate": null,
    "trialEndDate": null,
    "lastUsageDate": null,
    "deprovisionedDate": null,
    "lastRenewalDate": "2018-02-10T02:39:57.729",
    "licenseCount": 2,
    "churnRisk": "High",
    "billingCycleName": "MONTHLY"

}

Voir aussi