Obtenir toutes les informations analytiques sur l’abonnementGet all subscription analytics information

S’applique à :Applies to:

  • Espace partenairesPartner Center
  • Espace partenaires géré par 21VianetPartner Center operated by 21Vianet
  • Espace partenaires de Microsoft Cloud GermanyPartner Center for Microsoft Cloud Germany
  • Espace partenaires de Microsoft Cloud for US GovernmentPartner Center for Microsoft Cloud for US Government

Cet article explique comment obtenir toutes les informations d’analyse d’abonnement pour vos clients.This article describes how to get all the subscription analytics information for your customers.

PrérequisPrerequisites

Demande RESTREST request

Syntaxe de la requêteRequest syntax

MéthodeMethod URI de requêteRequest URI
GETGET * { BASEURL } */Partner/v1/Analytics/subscriptions http/1.1{baseURL}/partner/v1/analytics/subscriptions HTTP/1.1

Paramètres d’URIURI parameters

Le tableau suivant répertorie les paramètres facultatifs et leurs descriptions :The following table lists optional parameters and their descriptions:

ParamètreParameter TypeType DescriptionDescription
toptop intint Le nombre de lignes de données à renvoyer dans la requête.The number of rows of data to return in the request. Si la valeur n’est pas spécifiée, la valeur maximale et la valeur par défaut sont 10000 .If the value isn't specified, the maximum value and the default value are 10000. Si la requête comporte davantage de lignes, le corps de la réponse inclut un lien sur lequel vous cliquez pour solliciter la page suivante de données.If there are more rows in the query, the response body includes a next link that you can use to request the next page of data.
skipskip intint Le nombre de lignes à ignorer dans la requête.The number of rows to skip in the query. Utilisez ce paramètre pour parcourir de grands ensembles de données.Use this parameter to page through large data sets. Par exemple, top=10000 et skip=0 récupère les 10000 premières lignes de données top=10000 et skip=10000 récupère les 10000 lignes de données suivantes.For example, top=10000 and skip=0 retrieves the first 10000 rows of data, top=10000 and skip=10000 retrieves the next 10000 rows of data.
Filterfilter stringstring Une ou plusieurs instructions qui filtrent les lignes de la réponse.One or more statements that filter the rows in the response. Chaque instruction de filtre contient un nom de champ du corps de la réponse et une valeur associée à eq , ne ou pour certains champs, l' contains opérateur.Each filter statement contains a field name from the response body and a value that are associated with the eq, ne, or for certain fields, the contains operator. Les instructions peuvent être combinées à l’aide and de ou de or .Statements can be combined using and or or. Les valeurs de chaîne doivent être entourées par des guillemets dans le paramètre filter.String values must be surrounded by single quotes in the filter parameter. 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.See the following section for a list of fields that can be filtered and the operators that are supported with those fields.
aggregationLevelaggregationLevel stringstring Indique la plage de temps pendant laquelle récupérer les données agrégées.Specifies the time range for which to retrieve aggregate data. Il peut s’agit des chaînes suivantes : day, week ou month.Can be one of the following strings: day, week, or month. Si la valeur n’est pas spécifiée, la valeur par défaut est dateRange.If the value isn't specified, the default is dateRange. Ce paramètre s’applique uniquement quand un champ de date est passé dans le cadre du paramètre GroupBy .This parameter applies only when a date field is passed as part of the groupBy parameter.
ComportantgroupBy stringstring Une instruction qui applique l’agrégation des données uniquement sur les champs spécifiés.A statement that applies data aggregation only to the specified fields.

En-têtes de requêteRequest headers

Pour plus d’informations, consultez En-têtes REST de l’Espace Partenaires.For more information, see Partner Center REST headers.

Corps de demandeRequest body

Aucun.None.

Exemple de requêteRequest example

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 RESTREST response

En cas de réussite, le corps de la réponse contient une collection de ressources d' abonnement .If successful, the response body contains a collection of Subscription resources.

Codes d’erreur et de réussite de la réponseResponse success and error codes

Chaque réponse est accompagnée d’un code d’état HTTP qui indique la réussite ou l’échec ainsi que des informations de débogage supplémentaires.Each response comes with an HTTP status code that indicates success or failure and additional debugging information. Utilisez un outil de trace réseau pour lire ce code, le type d’erreur et des paramètres supplémentaires.Use a network trace tool to read this code, error type, and additional parameters. Pour obtenir la liste complète, consultez Codes d’erreur.For the full list, see Error Codes.

Exemple de réponseResponse example

{
    "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 aussiSee also