Sdílet prostřednictvím

Nástupní proces API pro odesílání v Partnerském centru

Pomocí rozhraní API pro odesílání v Partnerském centru můžete programově dotazovat, vytvářet návrhy odeslání a publikovat nabídky v komerčním obchodě. Toto rozhraní API je užitečné, pokud váš účet spravuje mnoho nabídek a chcete automatizovat a optimalizovat proces odesílání těchto nabídek.

Požadavky rozhraní API

Rozhraní API pro odesílání v Partner Center vyžaduje několik programmatických prostředků:

  • aplikace Microsoft Entra
  • přístupový token Microsoft Entra

Krok 1: Dokončení požadavků pro použití rozhraní API pro odeslání v Partnerském centru

Než začnete psát kód pro volání rozhraní API pro podání v partnerském centru, ujistěte se, že jste dokončili následující požadavky.

  • 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. Jinak můžete vytvořit nové ID Microsoft Entra v Partnerském centru bez dalších poplatků.
  • Musíte přidružit aplikaci Microsoft Entra k účtu Partnerského centra a získat ID tenanta, ID klienta a klíč. Budete je potřebovat k získání přístupového tokenu Microsoft Entra, který použijete při volání Microsoft Store submission API.

Přidružení aplikace Microsoft Entra k účtu Partnerského centra

Pokud chcete použít rozhraní API pro odesílání v Partnerském centru, musíte přidružit aplikaci Microsoft Entra k účtu Partnerského centra, načíst ID tenanta a ID klienta aplikace a vygenerovat klíč. Aplikace Microsoft Entra představuje aplikaci nebo službu, ze které chcete volat rozhraní API pro odesílání do Partner Center. K získání přístupového tokenu Microsoft Entra do rozhraní API potřebujete ID tenanta, ID klienta a klíč.

Poznámka

Tuto úlohu musíte provést jenom jednou. Jakmile budete mít ID tenanta, ID klienta a klíč, můžete je kdykoli znovu použít k vytvoření nového přístupového tokenu Microsoft Entra.

  1. V Partnerském centru přidružit účet Partnerského centra vaší organizace s adresářem Microsoft Entra vaší organizace.

  2. Na stránce Uživatelé v části Partnerského centra přidejte aplikaci Microsoft Entra, která představuje aplikaci nebo službu, kterou použijete pro přístup k odeslání v rámci vašeho účtu v Partnerském centru. Ujistěte se, že této aplikaci přiřadíte roli správce. Pokud aplikace ještě v adresáři Microsoft Entra neexistuje, vytvořte novou aplikaci Microsoft Entra v partnerském centru.

  3. Vraťte se na stránku Uživatelé, vyberte název aplikace Microsoft Entra pro přechod do nastavení aplikace a zkopírujte hodnoty ID tenanta a ID klienta.

  4. Vyberte Přidat nový klíč. Na následující obrazovce zkopírujte hodnotu Klíč. Po opuštění této stránky nebudete mít přístup k informacím znovu. Další informace naleznete v tématu Správa klíčů pro aplikaci Microsoft Entra.

Krok 2: Získání přístupového tokenu Microsoft Entra

Než zavoláte některou z metod v rozhraní API pro odesílání v Partnerském centru, musíte nejprve získat přístupový token Microsoft Entra, který se předává do hlavičky Authorization každé metody v rozhraní API. Platnost přístupového tokenu vyprší 60 minut po vystavení. Potom ho můžete aktualizovat, abyste ho mohli použít v budoucích voláních rozhraní API.

Pokud chcete získat přístupový token, postupujte podle pokynů v části Volání ze služby do služby pomocí klientských přihlašovacích údajů k odeslání 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://api.partner.microsoft.com

Jako hodnotu tenant_id v identifikátoru POST URI a parametrech client_id a client_secret zadejte ID tenanta, ID klienta a klíč aplikace, které jste získali z Partnerského centra v předchozí části. Pro parametr prostředku je nutné zadat https://api.partner.microsoft.com.

Krok 3: Použití rozhraní API pro odesílání v Partnerském centru

Jakmile budete mít přístupový token Microsoft Entra, volejte metody v rozhraní API pro odeslání v Partnerském centru. Pokud chcete vytvořit nebo aktualizovat odeslání, obvykle v rozhraní API pro odesílání v Partnerském centru v určitém pořadí voláte více metod. Informace o jednotlivých scénářích a syntaxi jednotlivých metod najdete v rozhraní API pro příjem dat Swagger.

Související obsah

  • Začněte používat rozhraní API pro odesílání v Partnerském centru, jak je popsáno výše.