次の方法で共有

API を使用して既存のプライベート オファーを管理する

  • [アーティクル]

API を使用して、既存のプライベート オファーを削除または取り消すことができます。

既存のプライベート オファーを削除する

既存のプライベート オファーがまだドラフト状態である間に削除するには、このメソッドを使用します。 どのプライベート オファーを削除するかを、プライベート オファー ID を使用して指定する必要があります。 マルチパート プライベート オファーの場合、プライベート オファーを削除できるのは MPO 発信者だけです。

要求

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

要求ヘッダー

Header 型 説明
承認 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 スキーマの検証。 要求本文が正しいスキーマに従っていることを確認し、すべての必須フィールドを含めます。

既存のプライベート オファーを取り消す

既存のプライベート オファーを取り消すには、このメソッドを使用します。 オファーを取り消すと、顧客はアクセスできなくなります。

Note

マルチパーティ プライベート オファーの場合、販売パートナーがまだ公開しておらず、エンド カスタマーが利用できるようにしていない場合、ISV は送信されたプライベート オファーを取り消すことができます。 販売パートナーは、公開されたプライベート オファーを顧客が承諾していない場合にのみ取り消すことができます。 プライベート オファーが既に顧客が受け入れ可能であり、ISV がそれに変更を加える必要がある場合、販売パートナーは、最初にプライベート オファーを取り消し、その後、ISV がプライベート オファーを取り消して下書き状態に戻して編集できるようにする必要があります。

どのプライベート オファーを取り消すかを、プライベート オファー ID を使用して指定する必要があります。

要求

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

要求ヘッダー

Header 型 説明
承認 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 スキーマの検証。 要求本文が正しいスキーマに従っていることを確認し、すべての必須フィールドを含めます。

次のステップ