Přehled rozhraní API pro odesílání privátních nabídek

2025-03-08

Soukromé nabídky umožňují vydavatelům a zákazníkům provádět transakce s jedním nebo více produkty na Azure Marketplace vytvořením časově vázané ceny s přizpůsobenými podmínkami. Rozhraní API pro odesílání privátních nabídek umožňují vydavatelům programově vytvářet a spravovat privátní nabídky pro zákazníky nebo partnery CSP. Toto rozhraní API používá k ověření volání z vaší aplikace nebo služby ID Microsoft Entra.

V Partnerském centru jsou k dispozici tři hlavní typy privátních nabídek a podporované rozhraním API pro odesílání privátních nabídek:

Soukromá nabídka zákazníkovi od ISV – v Partnerském centru se také označuje jako soukromá nabídka pro zákazníka. Jedná se o vlastní dohodu mezi isV a konkrétním zákazníkem s přizpůsobenými podmínkami a cenami konkrétního produktu na Azure Marketplace. Přečtěte si více o soukromé nabídce nezávislého dodavatele softwaru zákazníkům.
ISV to CSP partner private offer – V Partnerském Centru se také označuje jako soukromá nabídka partnerů CSP. Tento typ privátní nabídky umožňuje nezávislému dodavateli softwaru určit časově omezenou marži, která vytvoří velkoobchodní cenu pro svého partnera CSP. Zjistěte více o soukromé nabídce partnera ISV na CSP .
Multiparty private offer(MPO) – vlastní obchod konfigurovaný nezávislým dodavatelem softwaru (ISV) a upřednostňovaným distribučním partnerem konkrétního zákazníka s přizpůsobenými podmínkami a cenami pro konkrétní produkty na Azure Marketplace. Nezávislý dodavatel softwaru definuje zlevněnou velkoobchodní cenu dostupnou partnerovi, distribuční partner pak může přidat marži k velkoobchodní ceně, aby stanovil konečnou cenu pro zákazníka a předloží nabídku zákazníkovi k přijetí a koupi. Přijetí a nákup MPO probíhá stejným způsobem jako při nabídkách ISV soukromým zákazníkům. Přečtěte si další informace o vícestranné privátní nabídce.

Terminologie

původce MPO – MPO je spolupráce mezi ISV a prodejním partnerem na téže vlastní dohodě pro konkrétního zákazníka. Strana, která jako první vytvoří MPO, je označena jako "původce" nabídky, obvykle ISV produktů zahrnutých v MPO. Existuje pouze jeden původce pro libovolnou mpo.
prodejce MPO – distribuční partner, který připravuje nabídku s konečnou cenou zákazníka a prezentuje nabídku zákazníkovi, je prodejcem MPO. V každém mpo může být pouze jeden prodejce.
product – jedna jednotka představující nabídku na Azure Marketplace. Na stránce výpisu je jeden produkt.
Plan – jedna verze konkrétního produktu. Pro daný produkt může existovat více plánů, které představují různé úrovně cen nebo podmínek.
úloha – úloha vytvořená při zadání požadavku v tomto rozhraní API. Při použití tohoto rozhraní API ke správě soukromých nabídek a vícestranných soukromých nabídek se vytvoří úloha k dokončení požadavku. Po dokončení úlohy můžete získat další informace o relevantní (vícedílné) privátní nabídce.

Podporované scénáře

Příprava na použití tohoto rozhraní API

Než napíšete kód pro volání rozhraní API privátních nabídek, ujistěte se, že jste dokončili následující požadavky. Stejné požadavky platí pro všechny partnery publikování.

Krok 1: Dokončení požadavků pro používání rozhraní API pro příjem produktů Microsoftu (jednorázově)

Vy nebo vaše organizace musíte mít adresář Microsoft Entra. Pokud už používáte Microsoft 365 nebo jiné obchodní služby od Microsoftu, už máte adresář Microsoft Entra. Pokud ne, můžete zdarma vytvořit nové ID Microsoft Entra v Partnerském centru.

Musíte přidružit aplikaci Microsoft Entra ID k účtu Partnerského centra a získat ID tenanta, ID klienta a klíč. Tyto hodnoty potřebujete k získání přístupového tokenu Microsoft Entra, který použijete při volání rozhraní API privátních nabídek.

Krok 2: Získání přístupového tokenu Microsoft Entra (pokaždé)

Před voláním jakékoli metody v rozhraní API pro odesílání Microsoft Store potřebujete přístupový token Microsoft Entra, abyste jej mohli předat autorizační hlavičce každé metody v rozhraní API. Token můžete použít 60 minut, než vyprší jeho platnost. Po vypršení platnosti můžete token aktualizovat, abyste ho mohli dál používat v dalších voláních rozhraní API.

Pokud chcete získat přístupový token, podívejte se na Volání mezi službami s použitím klientských přihlašovacích údajů, abyste mohli odeslat HTTP POST do koncového bodu https://login.microsoftonline.com/<tenant_id>/oauth2/token. Tady je ukázkový požadavek:

POST https://login.microsoftonline.com/<tenant_id>/oauth2/token HTTP/1.1
Host: login.microsoftonline.com
Content-Type: application/x-www-form-urlencoded; charset=utf-8
grant_type=client_credentials
&client_id=<your_client_id>
&client_secret=<your_client_secret>
&resource=https://graph.microsoft.com/

Pro hodnotu tenant_id v identifikátoru POST URI a parametrech client_id a client_secret zadejte ID tenanta, ID klienta a klíč pro vaši aplikaci, kterou jste získali z Partnerského centra v předchozí části. Pro parametr zdroje je nutné zadat https://graph.microsoft.com/.

Vyhledání ID produktů, plánů a privátních nabídek

ID	kde je najít
ID klienta	Viz Přidružení aplikace Microsoft Entra k vašemu účtu v Partnerském centru.
identifikátor nájemce	Viz Přidružení aplikace Microsoft Entra k vašemu účtu v Partnerském centru.
tajemství_klienta	Viz Přidružení aplikace Microsoft Entra k vašemu účtu v Partnerském centru.
produktId	Podívejte se na Získání produktů v tomto článku.
ID plánu	Viz Načtení plánů pro konkrétní produkt v tomto článku.
privateofferId	Viz Načtení privátních nabídek v tomto článku.

Získat produkty

Soukromá nabídka je založená na existujícím produktu ve vašem účtu Partnerského centra. Pokud chcete zobrazit seznam produktů přidružených k vašemu účtu Partnerského centra, použijte toto volání rozhraní API:

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

Odpověď se zobrazí v následujícím ukázkovém formátu:

{
  "value": [
    {
      "$schema": "https://schema.mp.microsoft.com/schema/product/2022-07-01",
      "id": "string",
      "identity": {
        "externalId": "string"
      },
      "type": "enum",
      "alias": "string"
    }
  ],
  "@nextLink": "opaque_uri"
}

Načtení plánů pro konkrétní produkt

U produktů, které obsahují více než jeden plán, můžete chtít vytvořit soukromou nabídku na základě jednoho konkrétního plánu. Pokud ano, potřebujete ID daného plánu. Pomocí následujícího volání rozhraní API získejte seznam plánů (například variant nebo skladových položek) produktu:

GET https://graph.microsoft.com/rp/product-ingestion/plan?product=<product-id>&$version=2022-07-01

Odpověď se zobrazí v následujícím ukázkovém formátu:

{
  "value": [
    {
      "$schema": "https://schema.mp.microsoft.com/schema/plan/2022-07-01",
      "product": "string",
      "id": "string",
      "identity": {
        "externalId": "string"
      },
      "alias": "string"
    }
  ]
}

Načti privátní nabídky

Pokud chcete zobrazit seznam všech privátních nabídek, včetně vícedílných privátních nabídek přidružených k vašemu účtu, použijte následující volání rozhraní API:

GET https://graph.microsoft.com/rp/product-ingestion/private-offer/query?$version=2023-07-15

Jak používat rozhraní API

Rozhraní API privátní nabídky umožňuje vytvářet a spravovat privátní nabídky přidružené k produktům a plánům v rámci vašeho účtu Partnerského centra. Tady je souhrn typického vzorce volání při použití tohoto rozhraní API.

Krok 1: Provedení požadavku

Když provedete volání rozhraní API pro vytvoření, odstranění, odvolání nebo upgrade privátní nabídky, vytvoří se nová úloha pro dokončení požadovaného úkolu. Odpověď rozhraní API obsahuje ID úlohy přidružené k úloze.

Krok 2: Dotazování na stav úlohy

Pomocí jobId z počáteční odpovědi rozhraní API zjistěte stav úlohy. Stav úlohy bude buď Probíhá nebo Dokončeno. Po dokončení úlohy může být výsledek Úspěšné nebo Neúspěch. Abyste se vyhnuli problémům s výkonem, neověřujte úlohu více než jednou za minutu.

stav úlohy	Popis
Není zahájeno	Práce ještě nezačala; to je součástí odpovědi na počáteční požadavek.
Běhání	Úloha stále probíhá.
Hotový	Úloha byla dokončena. Další podrobnosti najdete v jobResult.
výsledek práce	popis
Čekající	Úloha ještě nebyla dokončena.
Uspěl	Úloha byla úspěšně dokončena. Tato úloha také vrátí identifikátor resourceURI, který odkazuje na privátní nabídku související s úlohou. Pomocí tohoto identifikátoru RESOURCEURI získáte úplné podrobnosti privátní nabídky.
Neúspěšný	Úloha se nezdařila. Tím se vrátí také všechny relevantní chyby, které vám pomůžou určit příčinu selhání.

Další informace najdete v tématu Dotaz na stav existující úlohy.

Krok 3: Získání informací z dokončených úloh

Úspěšná úloha vrátí identifikátor resourceURI odkazující na příslušnou privátní nabídku. Pomocí tohoto URI prostředku budete v budoucnu moci získat další podrobnosti o privátní nabídce, například privateofferId.

Neúspěšná úloha obsahuje chyby, které obsahují podrobnosti o tom, proč úloha selhala a jak problém vyřešit.

Další informace naleznete v tématu Získání podrobností o existující privátní nabídce.

Jak by měl ISV a channel partner společně používat rozhraní API pro vícestrannou soukromou nabídku

K vytvoření a správě daného MPO mohou používat stejná rozhraní API jak ISV, tak partner kanálu. Avšak zdroje v MPO, které mohou ovlivnit rozhraní API, závisí na tom, zda volající rozhraní API je nezávislý dodavatel softwaru (původce) nebo distribuční partner (prodejce) MPO. Stejný tok publikování pro partnery ISV/kanálu a obchodní pravidla, která řídí Partnerské centrum, se zrcadlí v rozhraní API. Tady je přehled:

Operace rozhraní API	ISV (tvůrce)	Distribuční partner (prodejce)
Vytvářet	Zamýšlenou cílovou skupinou je prodejní partner (prodejce); při zveřejnění volání rozhraní API koncový zákazník neuvidí soukromou nabídku, dokud kanálový partner neodešle. Upravitelné zdroje: Platná data Zamýšlený příjemce (zákazník) Kanálový partner bude spolupracovat na nabídce, omezeno na 1 na soukromou nabídku. Další kontakty ISV, které mohou být upozorněny na stav privátní nabídky Podmínky ISV na míru Produkty/plány zahrnuté v privátní nabídce Doba trvání smlouvy pro každý produkt nebo plán Zahrnuté množství pro každý produkt (pokud je k dispozici) Atributy plánu bez cen (pokud jsou k dispozici) Zvýhodněná velkoobchodní cena dostupná distribučnímu partnerovi na zahrnutých produktech/plánu Poznámky k prodeji ISV	Zamýšlená cílová skupina je koncový zákazník, když je zveřejněno volání rozhraní API. Upravitelné zdroje: Vlastní podmínky a ujednání partnerského kanálu Připravil(a) Úprava (procento přirážky) zadaná zákazníkem nad velkoobchodní cenou ISV pro každý produkt nebo plán zahrnutý v soukromé nabídce určuje konečnou cenu pro koncového zákazníka. Další kontakty kanálových partnerů, které mají být upozorněny na stav privátní nabídky Poznámky k prodeji distribučního partnera
Vymazat	Podporováno pro soukromé nabídky ve fázi návrhu	Nepodporováno
Odstoupit	Podpora pro soukromé nabídky, které jsou publikované nezávislými výrobci softwaru, ale dosud nebyly publikovány distribučním partnerem, nebo pokud byly staženy distribučním partnerem.	Podpora pro soukromé nabídky, které byly zveřejněny a jsou dostupné koncovým zákazníkům, ale zatím nebyly přijaty.

Operace rozhraní API

ISV (tvůrce)

Distribuční partner (prodejce)

Vytvářet

Zamýšlenou cílovou skupinou je prodejní partner (prodejce); při zveřejnění volání rozhraní API koncový zákazník neuvidí soukromou nabídku, dokud kanálový partner neodešle.

Upravitelné zdroje:

Platná data
Zamýšlený příjemce (zákazník)
Kanálový partner bude spolupracovat na nabídce, omezeno na 1 na soukromou nabídku.
Další kontakty ISV, které mohou být upozorněny na stav privátní nabídky
Podmínky ISV na míru
Produkty/plány zahrnuté v privátní nabídce
Doba trvání smlouvy pro každý produkt nebo plán
Zahrnuté množství pro každý produkt (pokud je k dispozici)
Atributy plánu bez cen (pokud jsou k dispozici)
Zvýhodněná velkoobchodní cena dostupná distribučnímu partnerovi na zahrnutých produktech/plánu
Poznámky k prodeji ISV

Zamýšlená cílová skupina je koncový zákazník, když je zveřejněno volání rozhraní API.