次の方法で共有

間接顧客の分析情報をすべて取得する

  • [アーティクル]

適用対象: パートナー センター | 21Vianet が運営するパートナー センター | Microsoft Cloud for US Government のパートナー センター

顧客のすべての間接リセラー分析情報を取得する方法。

前提条件

  • パートナー センターの認証に関するページで説明している資格情報。 このシナリオでは、ユーザー資格情報のみを使用した認証がサポートされます。

REST 要求

要求の構文

認証方法 要求 URI
GET {baseURL}/partner/v1/analytics/indirectresellers HTTP/1.1

URI パラメーター

パラメーター 型 説明
partnerTenantId string 間接リセラー データを取得するパートナーのテナント ID。
ID string 間接リセラー ID
name string 間接リセラー データを取得するパートナーの名前。
market string 間接リセラー データを取得するパートナーの市場。
firstSubscriptionCreationDate UTC 日時形式の文字列 間接リセラー データの取得に基づく最初のサブスクリプションの作成日。
latestSubscriptionCreationDate UTC 日時形式の文字列 最新のサブスクリプションの作成日。
firstSubscriptionEndDate UTC 日時形式の文字列 サブスクリプションが初めて終了した場合。
latestSubscriptionEndDate UTC 日時形式の文字列 サブスクリプションが終了した最新の日付。
firstSubscriptionSuspendedDate UTC 日時の文字列 サブスクリプションが初めて中断されたとき。
latestSubscriptionSuspendedDate UTC 日時形式の文字列 サブスクリプションが中断された最新の日付。
firstSubscriptionDeprovisionedDate UTC 日時形式の文字列 サブスクリプションが初めてプロビジョニング解除されたとき。
latestSubscriptionDeprovisionedDate UTC 日時形式の文字列 サブスクリプションがプロビジョニング解除された最新の日付。
subscriptionCount 倍精度浮動小数点 すべての付加価値リセラーのサブスクリプション数
licenseCount 倍精度浮動小数点 すべての付加価値リセラーのライセンス数。
indirectResellerCount 倍精度浮動小数点 間接リセラー数
上位 string 要求で返すデータの行数です。 最大値と既定値 (指定しない場合) は 10,000 です。 クエリにこれを上回る行がある場合は、応答本文に次リンクが含まれ、そのリンクを使ってデータの次のページを要求できます。
skip int クエリでスキップする行数です。 大きなデータ セットを操作するには、このパラメーターを使用します。 たとえば、最初の 10,000 行のデータを取得 top=10000 and skip=0 、次の 10,000 行のデータを取得 top=10000 and skip=10000 などです。
フィルター string 要求の filter パラメーターには、応答内の行をフィルター処理する 1 つまたは複数のステートメントが含まれます。 各ステートメントには、 eq 演算子または ne 演算子に関連付けられているフィールドと値が含まれており、ステートメントは and または orを使用して結合できます。 次のフィールドを指定できます。

partnerTenantId
id
名前
market
firstSubscriptionCreationDate
latestSubscriptionCreationDate
firstSubscriptionEndDate
latestSubscriptionEndDate
firstSubscriptionSuspendedDate
latestSubscriptionSuspendedDate
firstSubscriptionDeprovisionedDate
latestSubscriptionDeprovisionedDate

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

例:
.../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 集計データを取得する時間範囲を指定します。 "day"、"week"、または "month" のいずれかの文字列を指定できます。 指定しない場合、既定値は "day" です。

aggregationLevel は、 aggregationLevelなしではサポートされていません。 aggregationLevelすべての日付フィールドに適用されますaggregationLevel
orderby string 各インストールの結果データ値の順序を指定するステートメント。 構文は ...&orderby=field[order],field [order],... です。 フィールド パラメーターには、次のいずれかの文字列を指定できます。

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

order パラメーターは省略可能で、ascまたはdesc; を指定して、各フィールドの昇順または降順を指定できます。 既定値は、asc です。

例:
...&orderby=market,subscriptionCount
groupby string 指定したフィールドのみにデータ集計を適用するステートメントです。 次のフィールドを指定できます。

partnerTenantId
ID
名前
market
firstSubscriptionCreationDate
latestSubscriptionCreationDate
firstSubscriptionEndDate
latestSubscriptionEndDate
firstSubscriptionSuspendedDate
latestSubscriptionSuspendedDate
firstSubscriptionDeprovisionedDate
latestSubscriptionDeprovisionedDate

返されるデータ行には、 groupby 句で指定されたフィールドと、次のフィールドが含まれます。

indirectResellerCount
licenseCount
subscriptionCount

groupby パラメーターは、aggregationLevel パラメーターと共に使用できます。

例：
...&groupby=ageGroup,market&aggregationLevel=week

要求ヘッダー

詳細については、「パートナー センター REST ヘッダー」を参照してください。

要求本文

なし。

要求の例

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 応答

成功した場合、応答本文には、 直接リセラー リソースのコレクションが含まれます。

応答の成功とエラーのコード

各応答には、成功または失敗とその他のデバッグ情報を示す HTTP 状態コードが付属しています。 ネットワーク トレース ツールを使用して、このコード、エラーの種類、およびその他のパラメーターを読み取ります。 完全な一覧については、エラー コードに関するページを参照してください。

応答の例

{
    "partnerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
    "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
}

関連項目