Tüm abonelik analizi bilgilerini alma

Makale
09/22/2023

Şunlar için geçerlidir: İş Ortağı Merkezi | 21Vianet tarafından işletilen İş Ortağı Merkezi | ABD Kamu için Microsoft Bulut İş Ortağı Merkezi

Bu makalede, müşterileriniz için tüm abonelik analizi bilgilerinin nasıl alındığı açıklanır.

Ön koşullar

İş Ortağı Merkezi kimlik doğrulamasında açıklandığı gibi kimlik bilgileri. Bu senaryo yalnızca Kullanıcı kimlik bilgileriyle kimlik doğrulamayı destekler.

REST isteği

İstek söz dizimi

Metot	İstek URI'si
GET	{baseURL}/partner/v1/analytics/subscriptions HTTP/1.1

URI parametreleri

Aşağıdaki tabloda isteğe bağlı parametreler ve açıklamaları listelemektedir:

Parametre	Türü	Tanım
yukarı	int	İstekte döndürülecek veri satırlarının sayısı. Değer belirtilmezse, en büyük değer ve varsayılan değer olur `10000`. Sorguda daha fazla satır varsa, yanıt gövdesi bir sonraki veri sayfasını istemek için kullanabileceğiniz bir sonraki bağlantı içerir.
skip	int	Sorguda atlana satır sayısı. Büyük veri kümelerini sayfalandırmak için bu parametreyi kullanın. Örneğin, `top=10000` `skip=0` ilk 10.000 veri `top=10000` satırını alır ve `skip=10000` sonraki 10.000 veri satırını alır.
filtrele	Dize	Yanıttaki satırları filtreleyen bir veya daha fazla deyim. Her filtre deyimi, yanıt gövdesinden bir alan adı ve , `ne`veya belirli alanlar `contains` için işleciyle `eq`ilişkilendirilmiş bir değer içerir. deyimleri veya `or`kullanılarak `and` birleştirilebilir. Dize değerleri, filtre parametresinde tek tırnak içine alınmalıdır. Filtrelenebilen alanların listesi ve bu alanlarla desteklenen işleçler için aşağıdaki bölüme bakın.
aggregationLevel	Dize	Toplama verilerinin alındığı zaman aralığını belirtir. Şu dizelerden biri olabilir: gün, hafta veya ay. Değer belirtilmezse, varsayılan değer dateRange'dir. Bu parametre yalnızca groupBy parametresinin bir parçası olarak bir tarih alanı geçirildiğinde geçerlidir.
Groupby	Dize	Yalnızca belirtilen alanlara veri toplama uygulayan bir deyim.

İstek üst bilgileri

Daha fazla bilgi için bkz . İş Ortağı Merkezi REST üst bilgileri.

Request body

Yok.

İstek örneği

GET https://api.partnercenter.microsoft.com/partner/v1/analytics/subscriptions
Authorization: Bearer <token>
Accept: application/json
Content-Type: application/json
Content-Length: 0

REST yanıtı

Başarılı olursa, yanıt gövdesi abonelik kaynaklarının bir koleksiyonunu içerir.

Yanıt başarısı ve hata kodları

Her yanıt, başarılı veya başarısız olduğunu ve ek hata ayıklama bilgilerini gösteren bir HTTP durum koduyla birlikte gelir. Bu kodu, hata türünü ve diğer parametreleri okumak için bir ağ izleme aracı kullanın. Tam liste için bkz . Hata Kodları.

Yanıt örneği

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

}

Ayrıca bkz.

İş Ortağı Merkezi Analizi - Kaynaklar

Aracılığıyla paylaş