Delen via

Naslaginformatie voor Cloud Partner Portal API

Opmerking

De Cloud Partner Portal-API's zijn geïntegreerd met en blijven werken in partnercentrum. De overgang introduceert kleine wijzigingen. Bekijk de wijzigingen in CPP-API's die in dit document worden vermeld om er zeker van te zijn dat uw code blijft werken na de overgang naar Partner Center. CPP-API's dienen alleen te worden gebruikt voor bestaande producten die al vóór de overgang naar het Partnercentrum zijn geïntegreerd; nieuwe producten moeten gebruikmaken van Partnercentrum-indienings-API's.

Met de REST API's van de Cloud Partner Portal kunnen workloads, aanbiedingen en uitgeversprofielen programmatisch worden opgehaald en gemanipuleerd. De API's maken gebruik van op rollen gebaseerd toegangsbeheer van Azure (Azure RBAC) om de juiste machtigingen af te dwingen tijdens de verwerking.

Deze referentie bevat de technische details voor de Cloud Partner Portal REST API's. De voorbeelden van de nettolading in dit document zijn alleen ter referentie en kunnen worden gewijzigd wanneer er nieuwe functionaliteit wordt toegevoegd.

Vereisten en overwegingen

Voordat u de API's gebruikt, moet u het volgende controleren:

  • In het artikel Vereisten vindt u meer informatie over het toevoegen van een service-principal aan uw account en het verkrijgen van een Microsoft Entra-toegangstoken voor verificatie.
  • De twee strategieën voor gelijktijdigheidscontrole die beschikbaar zijn voor het aanroepen van deze API's.
  • Andere API-overwegingen, zoals versiebeheer en foutafhandeling.

Wijzigingen in CPP-API's na de migratie naar Partner Center

API Beschrijving wijzigen Impact
POST Publiceren, GoLive, Annuleren Voor gemigreerde aanbiedingen heeft de antwoordheader een andere indeling, maar blijft deze op dezelfde manier werken, wat een relatief pad aangeeft om de bewerkingsstatus op te halen. Bij het verzenden van een van de bijbehorende POST-aanvragen voor een aanbieding, heeft de locatieheader een van de twee indelingen, afhankelijk van de migratiestatus van de aanbieding:
  • Niet-gemigreerde aanbiedingen
    /api/operations/{PublisherId}${offerId}$2$preview?api-version=2017-10-31
  • Gemigreerde aanbiedingen
    /api/publishers/{PublisherId}/offers/{offereId}/operations/408a4835-0000-1000-0000-000000000000?api-version=2017-10-31
GET-operatie Voor aanbiedingstypen die eerder het veld 'melding-e-mail' in de reactie ondersteunden, wordt dit veld afgeschaft en niet meer geretourneerd voor gemigreerde aanbiedingen. Voor gemigreerde aanbiedingen sturen we geen meldingen meer naar de lijst met e-mails die in de verzoeken zijn opgegeven. In plaats daarvan wordt de API-service uitgelijnd met het e-mailproces voor meldingen in Partner Center om e-mailberichten te verzenden. Meldingen worden met name verzonden naar het e-mailadres dat is ingesteld in het gedeelte Contactgegevens verkoper van uw accountinstellingen in Partner Center, om u op de hoogte te houden van de voortgang van de bewerking.

Controleer het e-mailadres dat is ingesteld in het gedeelte Contactgegevens verkoper van uw accountinstellingen in Partner Center om er zeker van te zijn dat het juiste e-mailadres wordt verstrekt voor meldingen.

Algemene taken

Deze referentie beschrijft API's om de volgende veelvoorkomende taken uit te voeren.

Aanbiedingen

Bedrijfsactiviteiten

Een app publiceren

Andere taken

Probleemoplossingsproces

API-versies en updates

bijwerken Wat is er veranderd?
12-2022 De openbare CPP-API (versie 2017-10-31) is nu bijgewerkt om clientId en clientSecret voor Marketo-connector vast te leggen tijdens het configureren van klantleads. Tijdens de configuratie van de lead hoeft u het serverId-veld in de toekomst niet op te geven. Deze update van de API omvat geen versie-updates of belangrijke wijzigingen.
  • Last updated on