PartnerCentrum-indienings-API voor onboarding van Azure-apps in Partnercentrum

  • Artikel

Gebruik de Partner Center-indienings-API om programmatisch query's uit te voeren, inzendingen te maken voor en Azure-aanbiedingen te publiceren. Deze API is handig als uw account veel aanbiedingen beheert en u het indieningsproces voor deze aanbiedingen wilt automatiseren en optimaliseren.

API-vereisten

Er zijn enkele programmatische assets die u nodig hebt om de Partner Center-API voor Azure-producten te kunnen gebruiken:

  • een Azure Active Directory-toepassing.
  • een Toegangstoken van Azure Active Directory (Azure AD).

Stap 1: voltooi de vereisten voor het gebruik van de Api voor verzending van partnercentrum

Voordat u begint met het schrijven van code voor het aanroepen van de Indienings-API van het Partnercentrum, moet u ervoor zorgen dat u aan de volgende vereisten hebt voldaan.

Een Azure AD-toepassing koppelen aan uw Partnercentrum-account

Als u de Verzendings-API van de Microsoft Store wilt gebruiken, moet u een Azure AD toepassing koppelen aan uw Partnercentrum-account, de tenant-id en client-id voor de toepassing ophalen en een sleutel genereren. De Azure AD-toepassing vertegenwoordigt de app of service van waaruit u de indienings-API van het Partnercentrum wilt aanroepen. U hebt de tenant-id, client-id en sleutel nodig om een Azure AD toegangstoken te verkrijgen dat u doorgeeft aan de API.

Notitie

U hoeft deze taak slechts één keer uit te voeren. Nadat u de tenant-id, client-id en sleutel hebt, kunt u deze op elk gewenst moment opnieuw gebruiken om een nieuw Azure AD toegangstoken te maken.

  1. Koppel in partnercentrum het Partnercentrum-account van uw organisatie aan de Azure AD directory van uw organisatie.
  2. Voeg vervolgens op de pagina Gebruikers in de sectie Accountinstellingen van partnercentrum de Azure AD toepassing toe die de app of service vertegenwoordigt die u gaat gebruiken voor toegang tot inzendingen voor uw Partner Center-account. Zorg ervoor dat u deze toepassing de rol Manager toewijst. Als de toepassing nog niet bestaat in uw Azure AD directory, kunt u een nieuwe Azure AD toepassing maken in partnercentrum.
  3. Ga terug naar de pagina Gebruikers, klik op de naam van uw Azure AD toepassing om naar de toepassingsinstellingen te gaan en kopieer de waarden voor tenant-id en client-id.
  4. Klik op Nieuwe sleutel toevoegen. Kopieer in het volgende scherm de sleutelwaarde omlaag. U hebt geen toegang meer tot deze gegevens nadat u deze pagina hebt verlaten. Zie Sleutels voor een Azure AD-toepassing beheren voor meer informatie.

Stap 2: een Azure AD-toegangstoken verkrijgen

Voordat u een van de methoden in de Api voor verzending van partnercentrum aanroept, moet u eerst een Azure AD toegangstoken verkrijgen dat u doorgeeft aan de autorisatieheader van elke methode in de API. Nadat u een toegangstoken hebt verkregen, hebt u 60 minuten om het te gebruiken voordat het verloopt. Nadat het token is verlopen, kunt u het token vernieuwen, zodat u het kunt blijven gebruiken in toekomstige aanroepen naar de API.

Als u het toegangstoken wilt verkrijgen, volgt u de instructies in Service-naar-serviceaanroepen met behulp van clientreferenties om een HTTP POST naar het https://login.microsoftonline.com/<tenant_id>/oauth2/token eindpunt te verzenden. Hier volgt een voorbeeldaanvraag:

JSONCopy

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

Geef voor de tenant_id waarde in de POST URI parameters en de client_id en client_secret de tenant-id, client-id en de sleutel voor uw toepassing op die u in de vorige sectie hebt opgehaald uit partnercentrum. Voor de resourceparameter moet u opgeven https://api.partner.microsoft.com.

Stap 3: de Verzendings-API van de Microsoft Store gebruiken

Nadat u een Azure AD toegangstoken hebt, kunt u methoden aanroepen in de Api voor verzending van partnercentrum. Als u inzendingen wilt maken of bijwerken, roept u doorgaans meerdere methoden aan in de Api voor verzending van partnercentrum in een specifieke volgorde. Zie de Swagger van de Opname-API voor informatie over elk scenario en de syntaxis van elke methode.

https://ingestionapi-swagger.azureedge.net/#/

Volgende stappen