Microsoft パートナー センター (プレビュー)
このコネクタを使用すると、MPC API に接続し、顧客の詳細、注文、サブスクリプションなどの情報を収集できます。
このコネクタは、次の製品および地域で利用可能です:
| サービス | クラス | 地域 |
|---|---|---|
| Logic Apps | 標準 | 以下を除くすべての Logic Apps 地域 : - Azure 政府の地域 - Azure China の地域 - 米国国防総省 (DoD) |
| Power Automate | Standard | 以下を除くすべての Power Automate 地域 : - US Government (GCC) - US Government (GCC High) - 21 Vianet が運用する中国のクラウド - 米国国防総省 (DoD) |
| Power Apps | 標準 | 以下を除くすべての Power Apps 地域 : - US Government (GCC) - US Government (GCC High) - 21 Vianet が運用する中国のクラウド - 米国国防総省 (DoD) |
| 連絡先 | |
|---|---|
| 件名 | Microsoft |
| URL | https://support.microsoft.com |
| Connector Metadata | |
|---|---|
| 発行者 | マイクロソフト |
| Web サイト | https://docs.microsoft.com/en-us/partner-center/develop/ |
| プライバシー ポリシー | https://privacy.microsoft.com/en-us/privacystatement |
| カテゴリー | 事業部管理、ビジネス管理 |
接続を作成する
このコネクタは、次の認証タイプをサポートしています:
| 既定 | 接続を作成するためのパラメーター。 | すべての地域 | 共有不可 |
既定
適用できるもの: すべての領域
接続を作成するためのパラメーター。
これは共有可能な接続ではありません。 Power App が別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。
調整制限
| 名前 | 呼び出し | 更新期間 |
|---|---|---|
| 接続ごとの API 呼び出し | 100 | 60 秒 |
アクション
| すべての顧客を取得 |
顧客一覧を取得します。 |
| 請求書を取得する |
請求書のコレクションを取得します。 |
| 顧客の注文を取得する |
指定された顧客のすべての注文のコレクションを取得します。 |
| 顧客の詳細を取得する |
顧客 ID に対応する顧客リソースを取得します。 |
| 顧客サブスクリプションを取得する |
指定された顧客のすべてのサブスクリプションのコレクションを取得します。 |
すべての顧客を取得
顧客一覧を取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
規模
|
Size | string |
一度に表示される結果の数。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
合計数
|
totalCount | integer |
コレクション内の要素の総数 |
|
アイテム
|
items | array of object |
アイテム |
|
ID
|
items.id | string |
顧客 ID です。 |
|
Tenant ID
|
items.companyProfile.tenantId | string |
Microsoft Entra ID の顧客のテナント識別子。 MicrosoftID とも呼ばれます。 |
|
Domain
|
items.companyProfile.domain | string |
顧客の名前 (contoso.onmicrosoft.com など)。 |
|
Company Name
|
items.companyProfile.companyName | string |
会社や組織の名前。 |
|
パートナーとの関係
|
items.relationshipToPartner | string |
パートナーがこの顧客に対して使用する、"none"、"reseller"、"advisor"、"syndication"、または "microsoft_support" などのライセンス プログラムを定義します。 |
請求書を取得する
請求書のコレクションを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
規模
|
Size | integer |
応答で返される請求リソースの数。 このパラメータは任意です。 |
|
|
ページ
|
Offset | string |
返される最初の請求書の 0 ベースのインデックス。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
合計数
|
totalCount | integer |
コレクション内の要素の総数。 |
|
アイテム
|
items | array of object |
アイテム |
|
ID
|
items.id | string |
請求書の識別子。 |
|
請求書の日付
|
items.invoiceDate | string |
請求書が生成された日付。 |
|
請求期間開始日
|
items.billingPeriodStartDate | string |
請求期間開始日 (UTC)。 |
|
請求期間終了日
|
items.billingPeriodEndDate | string |
請求期間終了日 (UTC)。 |
|
請求合計
|
items.totalCharges | float |
請求合計。 トランザクションや調整にかかる手数料が含まれます。 |
|
支払金額
|
items.paidAmount | float |
パートナーが支払った金額。 支払いを受け取った場合はマイナスになります。 |
|
通貨コード
|
items.currencyCode | string |
すべての請求書項目の金額と合計に使用される通貨を示すコード。 |
|
通貨記号
|
items.currencySymbol | string |
すべての請求書項目の金額と合計に使用される通貨記号。 |
|
PDF ダウンロード リンク
|
items.pdfDownloadLink | string |
PDF 形式の請求書をダウンロードするためのリンク。 このリンクは検索結果の一部として返されず、請求書に ID でアクセスした場合にのみ入力されます。 このリンクは 30 分で自動的に期限切れになります。 |
|
invoiceDetails
|
items.invoiceDetails | array of object |
請求書の詳細。 |
|
請求書の行品目タイプ
|
items.invoiceDetails.invoiceLineItemType | string |
請求書の詳細のタイプ: "none"、"usage_line_items"、"billing_line_items"。 |
|
請求書プロバイダー
|
items.invoiceDetails.billingProvider | string |
請求書プロバイダー: "none"、"office"、"azure"、"azure_data_market"。 |
|
ドキュメントのタイプ
|
items.documentType | string |
請求書のドキュメント タイプ: "訂正表"、"請求書"。 |
|
請求書の種類
|
items.invoiceType | string |
請求書のタイプ: "recurring"、"one_time"。 |
顧客の注文を取得する
指定された顧客のすべての注文のコレクションを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
顧客テナント ID
|
CustomerTenantID | True | string |
顧客テナント ID。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
合計数
|
totalCount | integer |
顧客の注文合計数。 |
|
アイテム
|
items | array of object |
アイテム |
|
ID
|
items.id | string |
注文の識別子。 |
|
代替 ID
|
items.alternateId | string |
便利な注文の識別子。 |
|
Customer ID
|
items.referenceCustomerId | string |
顧客 ID。 |
|
請求サイクル
|
items.billingCycle | string |
この注文に対してパートナーに請求される頻度を示します。 |
|
通貨コード
|
items.currencyCode | string |
注文時に使用される通貨。 |
|
通貨記号
|
items.currencySymbol | string |
通貨コードに関連する通貨記号。 |
|
lineItems
|
items.lineItems | array of object |
lineItems |
|
lineItemNumber
|
items.lineItems.lineItemNumber | integer |
行品目番号。 |
|
オファーの ID
|
items.lineItems.offerId | string |
オファーの ID。 |
|
Subscription ID
|
items.lineItems.subscriptionId | string |
サブスクリプションの ID。 |
|
期間
|
items.lineItems.termDuration | string |
期間の ISO 8601 表現。 |
|
販促 ID
|
items.lineItems.promotionId | string |
販売促進 ID。 |
|
カスタム チームの終了日
|
items.lineItems.customTermEndDate | string |
新しいサブスクリプションの最初の請求期間の終了日。 |
|
トランザクションの種類
|
items.lineItems.transactionType | string |
明細行項目のトランザクションの種類です。 |
|
フレンドリ名
|
items.lineItems.friendlyName | string |
曖昧さをなくすためにパートナーが定義したサブスクリプションのフレンドリ名。 |
|
quantity
|
items.lineItems.quantity | integer |
品質 |
|
作成日
|
items.creationDate | string |
注文が作成された日付 (日時形式)。 |
|
Status
|
items.status | string |
指示の状態。 |
|
トランザクションの種類
|
items.transactionType | string |
注文のトランザクションの種類です。 サポートされている値は、"UserPurchase"、"SystemPurchase"、または "SystemBilling" です |
顧客の詳細を取得する
顧客 ID に対応する顧客リソースを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
顧客テナント ID
|
CustomerTenantID | True | string |
顧客テナント ID |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
ID
|
id | string |
顧客 ID です。 |
|
コマース ID。
|
commerceId | string |
コマース ID。 |
|
Tenant ID
|
companyProfile.tenantId | string |
Microsoft Entra ID の顧客のテナント識別子。 MicrosoftID とも呼ばれます。 |
|
会社名 (会社概要)。
|
companyProfile.companyName | string |
会社や組織の名前。 |
|
Domain
|
companyProfile.domain | string |
顧客の名前 (contoso.onmicrosoft.com など)。 |
|
国 (会社プロファイル)
|
companyProfile.address.country | string |
国。 |
|
地域 (会社プロファイル)。
|
companyProfile.address.region | string |
リージョン。 |
|
市区町村 (会社プロファイル)
|
companyProfile.address.city | string |
市区町村。 |
|
都道府県 (会社プロファイル)
|
companyProfile.address.state | string |
都道府県。 |
|
住所 Line1 (会社プロファイル)
|
companyProfile.address.addressLine1 | string |
住所の 1 行目。 |
|
郵便番号 (会社プロファイル)
|
companyProfile.address.postalCode | string |
郵便番号。 |
|
電話番号 (会社プロファイル)
|
companyProfile.address.phoneNumber | string |
顧客の会社/組織の連絡先の電話番号。 |
|
メール (会社プロファイル)
|
companyProfile.email | string |
メール。 |
|
プロファイル ID
|
billingProfile.id | string |
プロファイル識別子。 |
|
名 (課金プロファイル)
|
billingProfile.firstName | string |
顧客の会社での請求先取引先責任者の名前。 |
|
姓 (課金プロファイル)
|
billingProfile.lastName | string |
請求先取引先担当者の姓。 |
|
メール (課金プロファイル)
|
billingProfile.email | string |
請求先の取引先担当者のメール アドレス |
|
文化 (請求プロファイル)
|
billingProfile.culture | string |
優先するコミュニケーションと通貨の文化 ("en-us" など)。 |
|
言語 (課金プロファイル)
|
billingProfile.language | string |
コミュニケーションに優先する言語。 |
|
会社名 (課金プロファイル)
|
billingProfile.companyName | string |
会社や組織の名前。 |
|
国 (課金プロファイル)
|
billingProfile.defaultAddress.country | string |
ISO 国番号形式の国や地域。 |
|
リージョン (課金プロファイル)
|
billingProfile.defaultAddress.region | string |
リージョン。 |
|
市区町村 (課金プロファイル)
|
billingProfile.defaultAddress.city | string |
市区町村。 |
|
都道府県 (課金プロファイル)
|
billingProfile.defaultAddress.state | string |
都道府県。 |
|
AddressLine1 (課金プロファイル)
|
billingProfile.defaultAddress.addressLine1 | string |
住所の 1 行目。 |
|
郵便番号 (課金プロファイル)
|
billingProfile.defaultAddress.postalCode | string |
郵便番号。 |
|
名 (課金プロファイル)
|
billingProfile.defaultAddress.firstName | string |
顧客の会社や組織での請求先取引先責任者の名前。 |
|
姓 (課金プロファイル)
|
billingProfile.defaultAddress.lastName | string |
顧客の会社や組織での請求先取引先責任者の姓。 |
|
電話番号 (課金プロファイル)
|
billingProfile.defaultAddress.phoneNumber | string |
顧客の会社/組織の連絡先の電話番号。 |
|
パートナーとの関係
|
relationshipToPartner | string |
パートナーがこの顧客に対して使用する、"none"、"reseller"、"advisor"、"syndication"、または "microsoft_support" などのライセンス プログラムを定義します。 |
|
代理人アクセスを許可する
|
allowDelegatedAccess | boolean |
パートナーがこの顧客に代理管理者権限を付与されているかどうかを示します。 |
|
カスタム ドメイン
|
customDomains | array of string |
顧客のカスタム ドメインの一覧。 |
顧客サブスクリプションを取得する
指定された顧客のすべてのサブスクリプションのコレクションを取得します。
パラメーター
| 名前 | キー | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
顧客テナント ID
|
CustomerTenantID | True | string |
顧客のテナント ID。 |
戻り値
| 名前 | パス | 型 | 説明 |
|---|---|---|---|
|
合計数
|
totalCount | integer |
顧客のサブスクリプションの合計数。 |
|
アイテム
|
items | array of object |
アイテム |
|
ID
|
items.id | string |
サブスクリプション識別子です。 |
|
オファーの ID
|
items.offerId | string |
オファーの識別子。 |
|
オファー名
|
items.offerName | string |
オファー名。 |
|
フレンドリ名
|
items.friendlyName | string |
曖昧さをなくすためにパートナーが定義したサブスクリプションのフレンドリ名。 |
|
ID
|
items.productType.id | string |
サブスクリプション識別子です。 |
|
Display Name
|
items.productType.displayName | string |
b. 名前を表示します。 |
|
品質
|
items.quantity | integer |
プロビジョニング後のサブスクリプション数量を提供します。 |
|
単位の種類
|
items.unitType | string |
サブスクリプションの数量を定義する単位。 |
|
購入可能なアドオンあり
|
items.hasPurchasableAddons | boolean |
サブスクリプションに購入可能なアドオンがあるかどうかを示す値。 |
|
作成日
|
items.creationDate | string |
作成日 (日時形式)。 |
|
有効開始日
|
items.effectiveStartDate | string |
このサブスクリプションの有効開始日 (日時形式)。 |
|
コミットメント終了日
|
items.commitmentEndDate | string |
このサブスクリプションのコミットメント終了日 (日時形式)。 |
|
日付までキャンセル可能
|
items.cancellationAllowedUntilDate | string |
キャンセルの最終日。 |
|
請求サイクル終了日
|
items.billingCycleEndDate | string |
このサブスクリプションの請求サイクル終了日 (日時形式)。 |
|
Status
|
items.status | string |
プロビジョニングの状態を示します: "成功"、"保留中"、または "失敗"。 |
|
自動更新が有効
|
items.autoRenewEnabled | boolean |
autoRenewEnabled |
|
試用版
|
items.isTrial | boolean |
サブスクリプションが試用版であるかどうかを示す値。 |
|
請求の種類
|
items.billingType | string |
サブスクリプションの請求方法を "なし"、"使用量"、"ライセンス" のいずれかで指定します。 |
|
請求サイクル
|
items.billingCycle | string |
この注文に対してパートナーに請求される頻度を示します。 |
|
期間
|
items.termDuration | string |
期間の ISO 8601 表現。 |
|
更新期間
|
items.renewalTermDuration | string |
期間の ISO 8601 表現。 |
|
Microsoft 製品である
|
items.isMicrosoftProduct | boolean |
サブスクリプションが Microsoft 製品であるかどうかを示す値。 |
|
パートナー ID
|
items.partnerId | string |
間接的パートナー モデルで使用される、登録リセラーの MPN ID。 |
|
要注意
|
items.attentionNeeded | boolean |
要注意。 |
|
契約の種類
|
items.contractType | string |
契約タイプ: "subscription"、"productKey"、または "redemptionCode"。 |
|
発行元名
|
items.publisherName | string |
発行元の名前。 |
|
販促 ID
|
items.promotionId | string |
サブスクリプションに適用される場合の販売促進識別子。 |
|
Order ID
|
items.orderId | string |
サブスクリプションを開始するために発行された注文の ID。 |