Tüm dolaylı satıcı analiz bilgilerini alma

  • Makale
  • Okumak için 3 dakika

Uygulama:İş Ortağı Merkezi | İş Ortağı Merkezi 21Vianet | İş Ortağı Merkezi Microsoft Bulut Almanya için | İş Ortağı Merkezi için Microsoft Cloud for US Government

Müşterileriniz için tüm dolaylı kurumsal bayi analiz bilgilerini alma.

Önkoşullar

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

REST isteği

İstek söz dizimi

Yöntem İstek URI'si
AL {baseURL}/partner/v1/analytics/indirectresellers HTTP/1.1

URI parametreleri

Parametre Tür Description
partnerTenantId string Dolaylı kurumsal bayi verilerini almak istediğiniz iş ortağının Kiracı Kimliği.
kimlik string Dolaylı kurumsal bayi kimliği
name string Dolaylı kurumsal bayi verilerini almak istediğiniz iş ortağının adı.
Pazar string Dolaylı kurumsal bayi verilerini almak istediğiniz iş ortağının Marketi.
firstSubscriptionCreationDate UTC tarih saat biçiminde dize Dolaylı kurumsal bayi verilerini almak istediğiniz ilk aboneliğin oluşturma tarihi.
latestSubscriptionCreationDate UTC tarih saat biçiminde dize En son aboneliğin oluşturma tarihi.
firstSubscriptionEndDate UTC tarih saat biçiminde dize Herhangi bir abonelik ilk kez sona erer.
latestSubscriptionEndDate UTC tarih saat biçiminde dize Herhangi bir aboneliğin son bitiş tarihi.
firstSubscriptionSuspendedDate UTC tarih saat dizesi Herhangi bir abonelik ilk kez askıya alınmıştır.
latestSubscriptionSuspendedDate UTC tarih saat biçiminde dize Herhangi bir aboneliğin askıya alınarak son tarihi.
firstSubscriptionDeprovisionedDate UTC tarih saat biçiminde dize İlk kez bir aboneliğinvision'ları silindi.
latestSubscriptionDeprovisionedDate UTC tarih saat biçiminde dize Herhangi bir aboneliğin onaysız olduğu en son tarih.
subscriptionCount double Eklenen tüm değerli kurumsal bayiler için abonelik sayısı
licenseCount double Eklenen tüm değerli kurumsal bayiler için lisans sayısı.
indirectResellerCount double Dolaylı kurumsal bayi sayısı
top string İstekte geri dönecek veri satırlarının sayısı. Belirtilmezse en büyük değer ve varsayılan değer 10000'tir. Sorguda daha fazla satır varsa yanıt gövdesi, sonraki veri sayfasını talep etmek için kullanabileceğiniz bir sonraki bağlantı içerir.
Atla int Sorguda atlana satır sayısı. Büyük veri kümelerini sayfalara yapmak için bu parametreyi kullanın. Örneğin, top=10000 and skip=0 verilerin ilk 10000 satırı alınır, sonraki 10000 satır veri alınır ve top=10000 and skip=10000 bu şekilde devam ediyor.
filtre string İsteğin filtre parametresi, yanıtta satırları filtreleen bir veya daha fazla deyim içerir. Her deyim, veya işleçleriyle ilişkili bir alan ve değer içerir ve eqne deyimleri veya kullanılarak bir and araya or olabilir. Aşağıdaki alanları belirtebilirsiniz:

partnerTenantId
id
Ad
Pazar
firstSubscriptionCreationDate
latestSubscriptionCreationDate
firstSubscriptionEndDate
latestSubscriptionEndDate
firstSubscriptionSuspendedDate
latestSubscriptionSuspendedDate
firstSubscriptionDeprovisionedDate
latestSubscriptionDeprovisionedDate

Örnek:
.../indirectresellers?filter=market eq 'US'

Örnek:
.../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 Toplama verilerini almak için zaman aralığını belirtir. Şu dizelerden biri olabilir: "day", "week" veya "month". Belirtilmezse varsayılan değer "day" şeklindedir.

aggregationLevel olmadan aggregationLevel desteklenmiyor. aggregationLevel , içinde mevcut aggregationLevel alanlara uygulanır aggregationLevel
Orderby string Her yükleme için sonuç veri değerlerini sipariş alan bir deyim. Söz dizimi ...&orderby=field[order],field [order],... şeklindedir. alan parametresi aşağıdaki dizelerden biri olabilir:

"partnerTenantId"
"id"
"name"
"market"
"firstSubscriptionCreationDate"
"latestSubscriptionCreationDate"
"firstSubscriptionEndDate"
"latestSubscriptionEndDate"
"firstSubscriptionSuspendedDate"
"latestSubscriptionSuspendedDate"
"firstSubscriptionDeprovisionedDate"
"latestSubscriptionDeprovisionedDate"
"subscriptionCount"
"licenseCount"

Order parametresi isteğe bağlıdır ve her alan için artan veya azalan düzen belirtmek için veya desc olabilir. Varsayılan değer: asc.

Örnek:
...&orderby=market,subscriptionCount
Groupby string Yalnızca belirtilen alanlara veri toplaması uygulanan bir deyim. Aşağıdaki alanları belirtebilirsiniz:

partnerTenantId
id
Ad
Pazar
firstSubscriptionCreationDate
latestSubscriptionCreationDate
firstSubscriptionEndDate
latestSubscriptionEndDate
firstSubscriptionSuspendedDate
latestSubscriptionSuspendedDate
firstSubscriptionDeprovisionedDate
latestSubscriptionDeprovisionedDate

Döndürülen veri satırları yan tümcesinde belirtilen groupby alanları ve aşağıdaki alanları içerir:

indirectResellerCount
licenseCount
subscriptionCount

groupbyparametresiyle aggregationLevel birlikte kullanılabilir.

Örnek:...&groupby=ageGroup,market&aggregationLevel=week

İstek üst bilgileri

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

İstek gövdesi

Yok.

İstek örneği

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

REST yanıtı

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

Yanıt başarı ve hata kodları

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

Yanıt örneği

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

Ayrıca bkz.