共用方式為

透過 API 管理現有的私人供應專案

  • 發行項

您可以使用 API 來刪除或撤銷現有的私人供應專案。

刪除現有的私人供應專案

使用此方法可刪除現有的私人供應項目，同時仍處於草稿狀態。 您必須使用私人供應項目識別碼來指定要刪除的私人供應專案。 針對多部分私人供應專案，只有 MPO 發起者可以刪除私人供應專案。

Request

POST https://graph.microsoft.com/rp/product-ingestion/configure?$version=2022-07-01

要求標頭

標題 類型 描述
授權 String 必要。 表單中的 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可以接著撤銷私人供應專案，並將私人供應專案還原回草稿狀態以進行編輯。

您必須使用私人供應項目識別碼來指定您要撤銷的私人供應專案。

Request

POST https://graph.microsoft.com/rp/product-ingestion/configure?$version=2022-07-01

要求標頭

標題 類型 描述
授權 String 必要。 表單中的 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 架構驗證。 請確定您的要求本文遵循正確的架構，並包含所有必要的欄位。

相關內容