Sdílet prostřednictvím

Správa existujících privátních nabídek prostřednictvím rozhraní API

  • Článek

Pomocí rozhraní API můžete odstranit nebo odvolat stávající privátní nabídky.

Odstranění existující privátní nabídky

Pomocí této metody můžete odstranit existující privátní nabídku, i když je stále ve stavu konceptu. K určení, kterou privátní nabídku chcete odstranit, musíte použít ID privátní nabídky. U privátních nabídek s více částmi může soukromou nabídku odstranit pouze původce MPO.

Žádost

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

Hlavička požadavku

Hlavička Typ Popis
Autorizace String Povinný: Přístupový token Microsoft Entra ve formuláři Bearer <token>.

Parametry požadavku

$version – povinné. Toto je verze schématu, které se používá v požadavku.

Request body

{
    "$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"
        }
    ]
}

Reakce

Odpověď obsahuje ID úlohy, kterou můžete použít později k dotazování stavu.

{
    "$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": []
}

Kódy chyb

Stavový kód HTTP Popis
401 Chyba ověřování: Ujistěte se, že používáte platný přístupový token Microsoft Entra.
400 Ověřování schématu Ujistěte se, že text požadavku sleduje správné schéma a obsahuje všechna povinná pole.

Odvolání stávající soukromé nabídky

Tuto metodu použijte ke stažení stávající soukromé nabídky. Stažení nabídky znamená, že k ní už nebude mít zákazník přístup.

Poznámka:

U vícedílných privátních nabídek může výrobce softwaru odvolat odeslanou soukromou nabídku, pokud partner kanálu ještě nepublikoval a zpřístupnil ho koncovému zákazníkovi. Distribuční partner může stáhnout publikovanou soukromou nabídku pouze v případě, že ji zákazník nepřijal. Pokud už byla soukromá nabídka k dispozici pro zákazníka, aby ji mohl přijmout a isV v ní musí provést změny, musí distribuční partner nejprve stáhnout soukromou nabídku, aby pak mohl výrobce softwaru stáhnout a vrátit soukromou nabídku zpět do stavu konceptu, aby mohl provádět úpravy.

K určení, kterou soukromou nabídku chcete odvolat, musíte použít ID privátní nabídky.

Žádost

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

Hlavička požadavku

Hlavička Typ Popis
Autorizace String Povinný: Přístupový token Microsoft Entra ve formuláři Bearer <token>.

Parametry požadavku

$version – povinné. Toto je verze schématu, které se používá v požadavku.

Text žádosti (pro 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"
        }
    ]
}

Text žádosti (pro distribučního partnera)

{
    "$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

Odpověď obsahuje ID úlohy, kterou můžete později použít k dotazování stavu.

{
    "$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": []
}

Kódy chyb

Stavový kód HTTP Popis
401 Chyba ověřování: Ujistěte se, že používáte platný přístupový token Microsoft Entra.
400 Ověřování schématu Ujistěte se, že text požadavku sleduje správné schéma a obsahuje všechna povinná pole.

Související obsah