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

[アーティクル]
03/08/2023

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

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

前提条件

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

REST 要求

要求の構文

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

URI パラメーター

パラメーター	Type	説明
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	double	すべての付加価値リセラーのサブスクリプション数
licenseCount	double	すべての付加価値リセラーのライセンス数。
indirectResellerCount	double	間接リセラー数
top	string	要求で返すデータの行数です。最大値および指定しない場合の既定値は 10000 です。クエリにこれを上回る行がある場合は、応答本文に次リンクが含まれ、そのリンクを使ってデータの次のページを要求できます。
skip	int	クエリでスキップする行数です。大きなデータセットを操作するには、このパラメーターを使用します。たとえば、 `top=10000 and skip=0` は最初の 1,0000 行のデータを取得し、 `top=10000 and skip=10000` 次の 1,0000 行のデータを取得します。
filter	string	要求の filter パラメーターには、応答内の行をフィルター処理する 1 つまたは複数のステートメントが含まれます。各ステートメントには、または `ne` 演算子に関連付`eq`けられているフィールドと値が含まれており、ステートメントはまたは `or`を使用して`and`組み合わせることができます。次のフィールドを指定できます。 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],...`です。 field パラメーターには、次のいずれかの文字列を指定できます。 "partnerTenantId" "ID" "name" "マーケット" "firstSubscriptionCreationDate" "latestSubscriptionCreationDate" "firstSubscriptionEndDate" "latestSubscriptionEndDate" "firstSubscriptionSuspendedDate" "latestSubscriptionSuspendedDate" "firstSubscriptionDeprovisionedDate" "latestSubscriptionDeprovisionedDate" "subscriptionCount" "licenseCount" order パラメーターは省略可能で、または `desc`を指定`asc`して、各フィールドの昇順または降順を指定できます。既定値は、`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": "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
}

Share via