適用対象: パートナー センター |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
}