Een Salesforce Marketing Cloud basisverbinding met de Flow Service API
Een basisverbinding vertegenwoordigt de geverifieerde verbinding tussen een bron en Adobe Experience Platform.
Dit leerprogramma begeleidt u door de stappen om een basisverbinding tot stand te brengen voor Salesforce Marketing Cloud met de [Flow Service API] (https://www.adobe.io/experience-platform-apis/references/flow-service/).
Aan de slag
Deze handleiding vereist een goed begrip van de volgende onderdelen van Adobe Experience Platform:
- Bronnen: Met Experience Platform kunnen gegevens uit verschillende bronnen worden ingepakt en kunt u inkomende gegevens structureren, labelen en verbeteren met behulp van de platformservices.
- Sandboxen: Experience Platform biedt virtuele sandboxen die één platforminstantie in afzonderlijke virtuele omgevingen verdelen om toepassingen voor digitale ervaringen te ontwikkelen en te ontwikkelen.
Platform-API's gebruiken
Voor informatie over hoe te om vraag aan Platform APIs met succes te maken, zie de gids op aan de slag met platform-API's.
De volgende sectie bevat aanvullende informatie die u nodig hebt om verbinding te kunnen maken met Salesforce Marketing Cloud met de Flow Service API.
Vereiste referenties verzamelen
Om Flow Service om te verbinden met Salesforce Marketing Cloudmoet u de volgende eigenschappen voor de verbinding opgeven:
host
host
waarde, moet u de {subdomain}.rest.marketingcloudapis.com
. Als de host-URL bijvoorbeeld https://acme-ab12c3d4e5fg6hijk7lmnop8qrst.auth.marketingcloudapis.com/
, dan moet u acme-ab12c3d4e5fg6hijk7lmnop8qrst.rest.marketingcloudapis.com/
als uw hostwaarde.clientId
clientSecret
connectionSpec.id
ea1c2a08-b722-11eb-8529-0242ac130003
.Raadpleeg voor meer informatie over aan de slag gaan [Salesforce Marketing Cloud document] (https://developer.salesforce.com/docs/atlas.en-us.mc-apis.meta/mc-apis/authentication.htm).
Een basisverbinding maken
Een basisverbinding behoudt informatie tussen uw bron en Platform, met inbegrip van de de authentificatiegeloofsbrieven van uw bron, de huidige staat van de verbinding, en uw unieke identiteitskaart van de basisverbinding. Met de ID van de basisverbinding kunt u bestanden verkennen en door bestanden navigeren vanuit uw bron en kunt u de specifieke items identificeren die u wilt opnemen, inclusief informatie over hun gegevenstypen en indelingen.
Om een identiteitskaart van de basisverbinding te creëren, doe een verzoek van de POST aan /connections
als u uw Salesforce Marketing Cloud verificatiegegevens als onderdeel van de aanvraaginstantie.
API-indeling
POST /connections
Verzoek
Met de volgende aanvraag wordt een basisverbinding gemaakt voor Salesforce Marketing Cloud:
curl -X POST \
'https://platform.adobe.io/data/foundation/flowservice/connections' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-H 'Content-Type: application/json' \
-d '{
"name": "Salesforce Marketing Cloud base connection",
"description": "Salesforce Marketing Cloud base connection",
"auth": {
"specName": "Client-Id-Secret Based Authentication",
"params": {
"host": "acme-ab12c3d4e5fg6hijk7lmnop8qrst"
"clientId": "acme-salesforce-marketing-cloud",
"clientSecret": "xxxx"
}
},
"connectionSpec": {
"id": "ea1c2a08-b722-11eb-8529-0242ac130003",
"version": "1.0"
}
}'
auth.params.clientId
auth.params.clientSecret
connectionSpec.id
ea1c2a08-b722-11eb-8529-0242ac130003
.Antwoord
Met een geslaagde reactie wordt de nieuwe verbinding geretourneerd, inclusief de unieke verbindings-id (id
). Deze id is vereist om uw gegevens te kunnen bekijken in de volgende zelfstudie.
{
"id": "2fce94c1-9a93-4971-8e94-c19a93097129",
"etag": "\"d403848a-0000-0200-0000-5e978f7b0000\""
}
Volgende stappen
Aan de hand van deze zelfstudie hebt u een Salesforce Marketing Cloud basisverbinding met de Flow Service API. U kunt deze basis verbindings-id in de volgende zelfstudies gebruiken: