API를 통해 기존 프라이빗 제품 관리
API를 사용하여 기존 프라이빗 제품을 삭제하거나 철회할 수 있습니다.
기존 프라이빗 제품 삭제
아직 초안 상태에 있는 동안 기존 프라이빗 제품을 삭제하려면 이 방법을 사용합니다. 프라이빗 제품 ID를 사용하여 삭제할 프라이빗 제품을 지정해야 합니다. 다중 파트 프라이빗 제품의 경우 MPO 생성자만 프라이빗 제안을 삭제할 수 있습니다.
요청
POST https://graph.microsoft.com/rp/product-ingestion/configure?$version=2022-07-01
요청 헤더
| 헤더 | 형식 | 설명 |
|---|---|---|
| 권한 부여 | 문자열 | 필수입니다. 형식 Bearer <token>의 Microsoft Entra 액세스 토큰입니다. |
요청 매개 변수
$version - 필수입니다. 요청에 사용되는 스키마의 버전입니다.
요청 본문
{
"$schema": "https://schema.mp.microsoft.com/schema/configure/2022-07-01"
"resources": [
{
"$schema": "https://schema.mp.microsoft.com/schema/private-offer/2023-07-15",
"id": "private-offer/456e-a345-c457-1234",
"name": "privateOffercustomer1705",
"privateOfferType": "multipartyPromotionOriginator",
"state": "deleted"
}
]
}
Response
응답에는 나중에 상태를 폴링하는 데 사용할 수 있는 jobId가 포함됩니다.
{
"$schema": "https://schema.mp.microsoft.com/schema/configure-status/2022-07-01",
"jobId": "c32dd7e8-8619-462d-a96b-0ac1974bace5",
"jobStatus": "notStarted",
"jobResult": "pending",
"jobStart": "2021-12-21T21:29:54.9702903Z",
"jobEnd": "0001-01-01",
"errors": []
}
오류 코드
| HTTP 상태 코드 | 설명 |
|---|---|
| 401 | 인증 오류: 유효한 Microsoft Entra 액세스 토큰을 사용하고 있는지 확인합니다. |
| 400 | 스키마 유효성 검사. 요청 본문이 올바른 스키마를 따르고 모든 필수 필드를 포함하는지 확인합니다. |
기존 프라이빗 제품 철회
이 방법을 사용하여 기존 프라이빗 제품을 철회합니다. 제품을 철회하면 고객이 더 이상 제품에 액세스할 수 없게 됩니다.
참고 항목
다중 파티 프라이빗 제품의 경우 채널 파트너가 아직 게시하지 않고 최종 고객에게 제공된 경우 ISV는 제출된 비공개 제안을 철회할 수 있습니다. 채널 파트너는 고객이 수락하지 않은 경우에만 게시된 비공개 제안을 철회할 수 있습니다. 고객이 이미 비공개 제안을 수락할 수 있고 ISV가 이를 변경해야 하는 경우, 채널 파트너는 먼저 프라이빗 제안을 철회해야만 ISV가 비공개 제안을 철회하고 다시 초안 상태로 되돌려 편집할 수 있습니다.
프라이빗 제품 ID를 사용하여 철회하려는 프라이빗 제품을 지정해야 합니다.
요청
POST https://graph.microsoft.com/rp/product-ingestion/configure?$version=2022-07-01
요청 헤더
| 헤더 | 형식 | 설명 |
|---|---|---|
| 권한 부여 | 문자열 | 필수입니다. 형식 Bearer <token>의 Microsoft Entra 액세스 토큰입니다. |
요청 매개 변수
$version - 필수입니다. 요청에 사용되는 스키마의 버전입니다.
요청 본문(ISV용)
{
"$schema": "https://schema.mp.microsoft.com/schema/configure/2022-07-01"
"resources": [
{
"$schema": "https://schema.mp.microsoft.com/schema/private-offer/ 2023-07-15",
"id": "private-offer/456e-a345-c457-1234",
"name": "privateOffercustomer1705",
"privateOfferType": "multipartyPromotionOriginator",
"state": "withdrawn"
}
]
}
요청 본문(채널 파트너용)
{
"$schema": "https://schema.mp.microsoft.com/schema/configure/2022-07-01"
"resources": [
{
$schema": "https://schema.mp.microsoft.com/schema/private-offer/ 2023-07-15",
"id": "private-offer/456e-a345-c457-1234",
"name": "privateOffercustomer1705",
"privateOfferType": "multiPartyPromotionChannelPartner",
"state": "withdrawn"
}
]
}
Response
응답에는 나중에 상태를 폴링하는 데 사용할 수 있는 jobId가 포함됩니다.
{
"$schema": "https://schema.mp.microsoft.com/schema/configure-status/2022-07-01",
"jobId": "c32dd7e8-8619-462d-a96b-0ac1974bace5",
"jobStatus": "notStarted",
"jobResult": "pending",
"jobStart": "2021-12-21T21:29:54.9702903Z",
"jobEnd": "0001-01-01",
"errors": []
}
오류 코드
| HTTP 상태 코드 | 설명 |
|---|---|
| 401 | 인증 오류: 유효한 Microsoft Entra 액세스 토큰을 사용하고 있는지 확인합니다. |
| 400 | 스키마 유효성 검사. 요청 본문이 올바른 스키마를 따르고 모든 필수 필드를 포함하는지 확인합니다. |