Reference k rozhraní API portál partnerů cloudu

  • Článek

Poznámka:

Rozhraní API portálu partnerů cloudu jsou integrovaná a budou pokračovat v práci v Partnerském centru. Přechod zavádí malé změny. Zkontrolujte změny rozhraní API CPP uvedené v tomto dokumentu a ujistěte se, že váš kód po přechodu na Partnerské centrum bude fungovat i nadále. Rozhraní API CPP by se měla používat pouze pro stávající produkty, které už byly integrované před přechodem do Partnerského centra; nové produkty by měly používat rozhraní API pro odesílání v Partnerském centru.

Rozhraní REST API portálu partnerů cloudu umožňují programové načítání a manipulaci s úlohami, nabídkami a profily vydavatelů. Rozhraní API používají řízení přístupu na základě role v Azure (Azure RBAC) k vynucení správných oprávnění v době zpracování.

Tento odkaz obsahuje technické podrobnosti o rozhraníCH REST API portálu partnerů cloudu. Ukázky datových částí v tomto dokumentu jsou určené pouze pro referenci a při přidání nových funkcí se můžou změnit.

Požadavky a důležité informace

Před použitím rozhraní API byste měli zkontrolovat:

  • V článku Požadavky se dozvíte, jak přidat instanční objekt do vašeho účtu a získat přístupový token Microsoft Entra pro ověřování.
  • Dvě strategie řízení souběžnosti, které jsou k dispozici pro volání těchto rozhraní API.
  • Další aspekty rozhraní API, jako je správa verzí a zpracování chyb.

Změny rozhraní API CPP po migraci do Partnerského centra

Rozhraní API Změnit popis Dopad
POST Publish, GoLive, Cancel V případě migrovaných nabídek má hlavička odpovědi jiný formát, ale stále funguje stejným způsobem a označuje relativní cestu k načtení stavu operace. Při odesílání některého z odpovídajících požadavků POST na nabídku má hlavička Location jeden ze dvou formátů v závislosti na stavu migrace nabídky:
  • Nemigrované nabídky
    /api/operations/{PublisherId}${offerId}$2$preview?api-version=2017-10-31
  • Migrované nabídky
    /api/publishers/{PublisherId}/offers/{offereId}/operations/408a4835-0000-1000-0000-000000000000?api-version=2017-10-31
Operace GET U typů nabídek, které dříve v odpovědi podporovalo pole notification-email, bude toto pole zastaralé a už se nevrátí pro migrované nabídky. U migrovaných nabídek už nebudeme posílat oznámení do seznamu e-mailů zadaných v požadavcích. Místo toho služba ROZHRANÍ API odpovídá procesu e-mailu s oznámením v Partnerském centru pro odesílání e-mailů. Konkrétně se oznámení posílají na e-mailovou adresu nastavenou v části Kontaktní údaje prodejce v nastavení vašeho účtu v Partnerském centru, aby vás informovala o průběhu provozu.

Zkontrolujte e-mailovou adresu nastavenou v části Kontaktní informace prodejce v nastavení vašeho účtu v Partnerském centru a ujistěte se, že jsou pro oznámení poskytována správná e-mailová adresa.

Běžné úkoly

Tato referenční informace podrobně popisuje rozhraní API pro provádění následujících běžných úloh.

Nabídky

Operace

Publikování aplikace

Další úkoly

Řešení problému

Verze a aktualizace rozhraní API

Aktualizace Co se změnilo?
12-2022 Veřejné rozhraní API CPP (verze 2017–10-31) se teď aktualizuje, aby zachytilo id klienta a clientSecret pro konektor Marketo při konfiguraci potenciálních zákazníků. Během konfigurace potenciálního zákazníka nemusíte zadávat pole serverId. Tato aktualizace rozhraní API nezahrnuje žádné aktualizace verzí ani zásadní změny.