通过

通过 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"
        }
    ]
}

响应

响应包含稍后可用于轮询状态的 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"
        }
    ]
}

响应

响应包含稍后可用于轮询状态的 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 架构验证。 确保请求正文遵循正确的架构并包含所有必填字段。

相关内容