Microsoft 파트너 센터 [사용되지 않음]
이 커넥터를 사용하면 MPC API에 연결하고 고객 세부 정보, 주문 및 구독을 포함한 일부 정보를 수집할 수 있습니다.
이 커넥터는 다음 제품 및 지역에서 사용할 수 있습니다.
| 서비스 | 클래스 | Regions |
|---|---|---|
| Copilot Studio | 스탠다드 | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 논리 앱 | 스탠다드 | 다음을 제외한 모든 Logic Apps 지역 : - Azure Government 지역 - Azure 중국 지역 - 미국 국방부(DoD) |
| Power Apps | 스탠다드 | 다음을 제외한 모든 Power Apps 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| Power Automate | 스탠다드 | 다음을 제외한 모든 Power Automate 지역 : - 미국 정부(GCC) - 미국 정부(GCC High) - 21Vianet에서 운영하는 중국 클라우드 - 미국 국방부(DoD) |
| 연락처 | |
|---|---|
| 이름 | Microsoft |
| URL | https://support.microsoft.com |
| 커넥터 메타데이터 | |
|---|---|
| 게시자 | Microsoft |
| 웹 사이트 | https://docs.microsoft.com/en-us/partner-center/develop/ |
| 개인 정보 보호 정책 | https://privacy.microsoft.com/en-us/privacystatement |
| 카테고리 | IT 작업; 비즈니스 관리 |
연결을 만드는 중
커넥터는 다음 인증 유형을 지원합니다.
| 기본값 | 연결을 만들기 위한 매개 변수입니다. | 모든 지역 | 공유할 수 없음 |
기본값
적용 가능: 모든 지역
연결을 만들기 위한 매개 변수입니다.
공유 가능한 연결이 아닙니다. 전원 앱이 다른 사용자와 공유되면 다른 사용자에게 새 연결을 명시적으로 만들라는 메시지가 표시됩니다.
제한 한도
| Name | 호출 | 갱신 기간 |
|---|---|---|
| 연결당 API 호출 | 100 | 60초 |
동작
| 고객 구독 가져오기(사용되지 않음) [사용되지 않음] |
지정된 고객에 대한 모든 구독의 컬렉션을 가져옵니다(사용되지 않음). |
| 고객 세부 정보 가져오기(사용되지 않음) [사용되지 않음] |
고객 ID(사용되지 않음)에 해당하는 고객 리소스를 가져옵니다. |
| 고객 주문 가져오기(사용되지 않음) [사용되지 않음] |
지정된 고객에 대한 모든 주문의 컬렉션을 가져옵니다(사용되지 않음). |
| 모든 고객 가져오기(사용되지 않음) [사용되지 않음] |
고객 목록을 가져옵니다(사용되지 않음). |
| 청구서 가져오기(사용되지 않음) [사용되지 않음] |
청구서 컬렉션을 가져옵니다(사용되지 않음). |
고객 구독 가져오기(사용되지 않음) [사용되지 않음]
지정된 고객에 대한 모든 구독의 컬렉션을 가져옵니다(사용되지 않음).
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
고객 테넌트 ID
|
CustomerTenantID | True | string |
고객의 테넌트 ID입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
총 개수
|
totalCount | integer |
고객에 대한 총 구독 수입니다. |
|
items
|
items | array of object |
items |
|
아이디
|
items.id | string |
구독 식별자입니다. |
|
제안 ID
|
items.offerId | string |
제품 식별자입니다. |
|
제안 이름
|
items.offerName | string |
제품 이름입니다. |
|
친숙한 이름
|
items.friendlyName | string |
명확하게 구분하기 위해 파트너가 정의한 구독의 이름입니다. |
|
아이디
|
items.productType.id | string |
구독 식별자입니다. |
|
표시 이름
|
items.productType.displayName | string |
표시 이름입니다. |
|
수량
|
items.quantity | integer |
프로비전 후 구독 수량을 제공합니다. |
|
단위 유형
|
items.unitType | string |
구독의 수량을 정의하는 단위입니다. |
|
Purchasable Addons가 있습니다.
|
items.hasPurchasableAddons | boolean |
구독에 구매할 수 있는 추가 기능이 있는지 여부를 나타내는 값입니다. |
|
만든 날짜
|
items.creationDate | string |
만든 날짜(날짜-시간 형식)입니다. |
|
유효 시작 날짜
|
items.effectiveStartDate | string |
이 구독의 유효 시작 날짜(날짜-시간 형식)입니다. |
|
약정 종료 날짜
|
items.commitmentEndDate | string |
이 구독의 약정 종료 날짜(날짜-시간 형식)입니다. |
|
날짜까지 취소 허용
|
items.cancellationAllowedUntilDate | string |
취소의 마지막 날짜입니다. |
|
청구 주기 종료 날짜
|
items.billingCycleEndDate | string |
이 구독의 청구 주기 종료 날짜(날짜-시간 형식)입니다. |
|
상태
|
items.status | string |
프로비전 상태를 나타냅니다. "success", "pending" 또는 "failed". |
|
자동 갱신 사용
|
items.autoRenewEnabled | boolean |
autoRenewEnabled |
|
평가판인가요?
|
items.isTrial | boolean |
구독이 평가판인지 여부를 나타내는 값입니다. |
|
청구 유형
|
items.billingType | string |
구독 요금이 청구되는 방법을 지정합니다. "none", "usage" 또는 "license". |
|
청구 주기
|
items.billingCycle | string |
파트너가 이 주문에 대해 청구되는 빈도를 나타냅니다. |
|
기간
|
items.termDuration | string |
용어 기간의 ISO 8601 표현입니다. |
|
갱신 기간
|
items.renewalTermDuration | string |
용어 기간의 ISO 8601 표현입니다. |
|
Microsoft 제품인가요?
|
items.isMicrosoftProduct | boolean |
구독이 Microsoft 제품인지 여부를 나타내는 값입니다. |
|
Partner ID
|
items.partnerId | string |
간접 파트너 모델에 사용되는 레코드 재판매인의 MPN ID입니다. |
|
주의 필요
|
items.attentionNeeded | boolean |
주의가 필요합니다. |
|
계약 유형
|
items.contractType | string |
계약 유형: "subscription", "productKey" 또는 "redemptionCode"입니다. |
|
게시자 이름
|
items.publisherName | string |
게시자 이름입니다. |
|
승격 ID
|
items.promotionId | string |
구독에 적용되는 경우 승격 식별자입니다. |
|
주문 ID
|
items.orderId | string |
구독을 시작하기 위해 배치된 주문의 ID입니다. |
고객 세부 정보 가져오기(사용되지 않음) [사용되지 않음]
고객 ID(사용되지 않음)에 해당하는 고객 리소스를 가져옵니다.
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
고객 테넌트 ID
|
CustomerTenantID | True | string |
고객 테넌트 ID |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
아이디
|
id | string |
고객 ID입니다. |
|
상거래 ID입니다.
|
commerceId | string |
상거래 ID입니다. |
|
임차인 ID
|
companyProfile.tenantId | string |
Microsoft Entra ID에 대한 고객의 테넌트 식별자입니다. 이를 MicrosoftID라고도합니다. |
|
회사 이름(회사 프로필).
|
companyProfile.companyName | string |
회사 또는 조직의 이름입니다. |
|
도메인
|
companyProfile.domain | string |
고객의 이름(예: contoso.onmicrosoft.com)입니다. |
|
국가(회사 프로필)
|
companyProfile.address.country | string |
국가입니다. |
|
지역(회사 프로필).
|
companyProfile.address.region | string |
지역. |
|
City(회사 프로필)
|
companyProfile.address.city | string |
도시입니다. |
|
상태(회사 프로필)
|
companyProfile.address.state | string |
주. |
|
주소 줄1(회사 프로필)
|
companyProfile.address.addressLine1 | string |
주소의 첫 번째 줄입니다. |
|
우편 번호(회사 프로필)
|
companyProfile.address.postalCode | string |
우편 번호입니다. |
|
전화 번호(회사 프로필)
|
companyProfile.address.phoneNumber | string |
고객 회사/조직의 연락처 전화 번호입니다. |
|
전자 메일(회사 프로필)
|
companyProfile.email | string |
메일 주소. |
|
프로필 ID
|
billingProfile.id | string |
프로필 식별자입니다. |
|
이름(청구 프로필)
|
billingProfile.firstName | string |
고객 회사의 청구 연락처 이름입니다. |
|
성(청구 프로필)
|
billingProfile.lastName | string |
청구 연락처의 성입니다. |
|
전자 메일(청구 프로필)
|
billingProfile.email | string |
청구 연락처의 전자 메일 주소 |
|
Culture(청구 프로필)
|
billingProfile.culture | string |
통신 및 통화에 대 한 그들의 선호 문화, 같은 "en-us". |
|
언어(청구 프로필)
|
billingProfile.language | string |
통신을 위해 선호하는 언어입니다. |
|
회사 이름(청구 프로필)
|
billingProfile.companyName | string |
회사 또는 조직의 이름입니다. |
|
국가(청구 프로필)
|
billingProfile.defaultAddress.country | string |
ISO 국가 코드 형식의 국가/지역입니다. |
|
지역(청구 프로필)
|
billingProfile.defaultAddress.region | string |
지역. |
|
City(청구 프로필)
|
billingProfile.defaultAddress.city | string |
도시입니다. |
|
상태(청구 프로필)
|
billingProfile.defaultAddress.state | string |
주. |
|
AddressLine1(청구 프로필)
|
billingProfile.defaultAddress.addressLine1 | string |
주소의 첫 번째 줄입니다. |
|
우편 번호(청구 프로필)
|
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 |
고객의 사용자 지정 도메인 목록입니다. |
고객 주문 가져오기(사용되지 않음) [사용되지 않음]
지정된 고객에 대한 모든 주문의 컬렉션을 가져옵니다(사용되지 않음).
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
고객 테넌트 ID
|
CustomerTenantID | True | string |
고객 테넌트 ID입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
총 개수
|
totalCount | integer |
총 고객 주문 수입니다. |
|
items
|
items | array of object |
items |
|
아이디
|
items.id | string |
주문 식별자입니다. |
|
대체 ID
|
items.alternateId | string |
주문에 대한 식별자입니다. |
|
고객 ID
|
items.referenceCustomerId | string |
고객 식별자입니다. |
|
청구 주기
|
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입니다. |
|
구독 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 |
명확하게 구분하기 위해 파트너가 정의한 구독의 이름입니다. |
|
수량
|
items.lineItems.quantity | integer |
수량 |
|
만든 날짜
|
items.creationDate | string |
주문이 만들어진 날짜(날짜-시간 형식)입니다. |
|
상태
|
items.status | string |
주문의 상태입니다. |
|
트랜잭션 유형
|
items.transactionType | string |
주문의 트랜잭션 유형입니다. 지원되는 값은 'UserPurchase', 'SystemPurchase' 또는 'SystemBilling'입니다. |
모든 고객 가져오기(사용되지 않음) [사용되지 않음]
고객 목록을 가져옵니다(사용되지 않음).
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
Size
|
Size | string |
한 번에 표시할 결과 수입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
총 개수
|
totalCount | integer |
컬렉션의 총 요소 수 |
|
items
|
items | array of object |
items |
|
아이디
|
items.id | string |
고객 ID입니다. |
|
임차인 ID
|
items.companyProfile.tenantId | string |
Microsoft Entra ID에 대한 고객의 테넌트 식별자입니다. 이를 MicrosoftID라고도합니다. |
|
도메인
|
items.companyProfile.domain | string |
고객의 이름(예: contoso.onmicrosoft.com)입니다. |
|
회사 이름
|
items.companyProfile.companyName | string |
회사 또는 조직의 이름입니다. |
|
파트너와의 관계
|
items.relationshipToPartner | string |
파트너가 이 고객에게 사용하는 라이선스 프로그램을 정의합니다. "none", "reseller", "advisor", "syndication" 또는 "microsoft_support". |
청구서 가져오기(사용되지 않음) [사용되지 않음]
청구서 컬렉션을 가져옵니다(사용되지 않음).
매개 변수
| Name | 키 | 필수 | 형식 | Description |
|---|---|---|---|---|
|
Size
|
Size | integer |
응답에서 반환할 청구서 리소스의 수입니다. 이 매개 변수는 선택 사항입니다. |
|
|
상쇄
|
Offset | string |
반환할 첫 번째 청구서의 인덱스(0부터 시작)입니다. |
반환
| Name | 경로 | 형식 | Description |
|---|---|---|---|
|
총 개수
|
totalCount | integer |
컬렉션의 총 요소 수입니다. |
|
items
|
items | array of object |
items |
|
아이디
|
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 |
청구서의 문서 유형: "Credit Note", "Invoice". |
|
청구서 유형
|
items.invoiceType | string |
청구서 유형: "되풀이", "one_time" |