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

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

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

[前提条件]

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

REST 要求

リクエスト構文

メソッド	URI リクエスト
取得	{baseURL}/partner/v1/analytics/indirectresellers HTTP/1.1

URI パラメーター

パラメーター	タイプ	説明
パートナーテナントID	ひも	間接リセラーのデータを取得するパートナーのテナント ID。
身分証明書	ひも	間接リセラー ID
名前	ひも	間接リセラーのデータを取得するパートナーの名前。
市場	ひも	間接リセラー データを取得するパートナーの市場。
firstSubscriptionCreationDate (最初のサブスクリプション作成日)	UTC 日付、時刻形式の文字列	間接リセラー データを取得する基になる最初のサブスクリプションの作成日。
最新のサブスクリプション作成日	UTC 日付、時刻形式の文字列	最新のサブスクリプションの作成日。
firstSubscriptionEndDate	UTC 日付、時刻形式の文字列	サブスクリプションが初めて終了したとき。
latestサブスクリプション終了日	UTC 日付、時刻形式の文字列	サブスクリプションが終了した最新の日付。
firstSubscriptionSuspendedDate	UTC 日付時刻の文字列	サブスクリプションが初めて停止されたとき。
latestサブスクリプションサスペンデッド日付	UTC 日付、時刻形式の文字列	サブスクリプションが中断された最新の日付。
firstSubscriptionDeprovisionedDate	UTC 日付、時刻形式の文字列	サブスクリプションのプロビジョニングが初めて解除されたとき。
latestSubscriptionDeprovisionedDate	UTC 日付、時刻形式の文字列	サブスクリプションのプロビジョニングが解除された最新の日付。
サブスクリプションカウント	ダブル	すべての付加価値再販業者のサブスクリプション数
ライセンス数	ダブル	すべての付加価値リセラーのライセンス数。
間接リセラーカウント	ダブル	間接リセラーの数
ページのトップへ	ひも	要求で返されるデータの行数。 最大値と、指定しない場合のデフォルト値は 10,000 です。 クエリにさらに行がある場合、応答本文には次のリンクが含まれています。このリンクを使用して、データの次のページを要求できます。
スキップ	整数 (int)	クエリでスキップする行数。 大きなデータ セットをページングするには、このパラメーターを使用します。 たとえば、 top=10000 and skip=0 は最初の 10,000 行のデータを取得し、 top=10000 and skip=10000 は次の 10,000 行のデータを取得します。
フィルター	ひも	要求の フィルター パラメーターには、応答内の行をフィルター処理する 1 つ以上のステートメントが含まれています。 各ステートメントには、 eq 演算子または ne 演算子に関連付けられたフィールドと値が含まれており、ステートメントは and または or を使用して組み合わせることができます。 次のフィールドを指定できます。 パートナーテナントID ID 名前 市場 firstSubscriptionCreationDate (最初のサブスクリプション作成日) 最新のサブスクリプション作成日 firstSubscriptionEndDate latestサブスクリプション終了日 firstSubscriptionSuspendedDate latestサブスクリプションサスペンデッド日付 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))
集約レベル	ひも	集計データを取得する時間範囲を指定します。 "day"、"week"、または "month" のいずれかの文字列を指定できます。 指定しない場合、デフォルトは "day" です。 aggregationLevel は、 aggregationLevelなしではサポートされていません。 aggregationLevelは、aggregationLevel
オーダーバイ (orderby)	ひも	各インストールの結果データ値を並べ替えるステートメント。 構文は ...&orderby=field[order],field [order],... です。 field パラメーターには、次のいずれかの文字列を指定できます。 "パートナーテナントID" 「id」 "name" 「市場」 "firstSubscriptionCreationDate" (最初のサブスクリプション作成日) "latestSubscriptionCreationDate" (最新のサブスクリプション作成日) "firstSubscriptionEndDate" (最初のサブスクリプション終了日) "latestSubscriptionEndDate" (最新のサブスクリプション終了日) "firstSubscriptionSuspendedDate" (最初のサブスクリプション停止日) "latestSubscriptionSuspendedDate" (最新のサブスクリプションサスペンデッド日付) "firstSubscriptionDeprovisionedDate" "latestSubscriptionDeprovisionedDate" "subscriptionCount" (サブスクリプションカウント) "ライセンス数" order パラメーターは省略可能で、asc または desc に指定して、各フィールドの昇順または降順を指定できます。 既定値は ascです。 例: ...&orderby=market,subscriptionCount
グループバイ	ひも	指定したフィールドにのみデータ集計を適用するステートメント。 次のフィールドを指定できます。 パートナーテナントID 身分証明書 名前 市場 firstSubscriptionCreationDate (最初のサブスクリプション作成日) 最新のサブスクリプション作成日 firstSubscriptionEndDate latestサブスクリプション終了日 firstSubscriptionSuspendedDate latestサブスクリプションサスペンデッド日付 firstSubscriptionDeprovisionedDate latestSubscriptionDeprovisionedDate 返されるデータ行には、 groupby 句で指定されたフィールドと、次のフィールドが含まれます。 間接リセラーカウント ライセンス数 サブスクリプションカウント 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
}

こちらも参照ください

• パートナー センターの分析 - リソース