Learning Objectives /Objectifs de formation
After completing this unit, you’ll be able to:/ Une fois cette unite terminée, vous pourrez :
- Describe each Marketing Cloud API. /Décrire chaque Api Marketing cloud
- Discover the endpoints used to access a Marketing Cloud API. /Découvrir les points de terminaisons utilisés pour accéder à une API Marketing Cloud.
APIs: The Building Blocks of Marketing Cloud /APIs: Les blocs de constructions de Marketing Cloud
As a developer, APIs are the building blocks you use to connect your system to Marketing Cloud. /En tant que developpeur, les APIs sont des blocs de constructions que vous utilisez pour connecter votre système à Marketing Cloud.
We want you to have everything you need to design and implement your code, so Marketing Cloud offers two robust APIs: REST and SOAP. / Nous souhaitons que vous ayez tous ce dont vous avez besoin pour concevoir et implementer votre code, alors Marketing cloud offre deux APIs robustres: REST and SOAP.
Each API has its own benefits, so sometimes you may even use both, depending on your needs. /Chaque APIs a ses propres avantages, parfois vous pouvez meme utiliser les deux, cela déprendra de vos besoins.
In this unit, we take a look at these APIs and explore how they can help you reach your goals. / Dans cette unité, nous explorons ces API et verrons comment elles peuvent vous aider à atteindre vos objectifs.
Let’s Get Some REST API /Utilisation d’une API REST
Ready to make your job easier? Good news: You can create content, build your contact records, and monitor your customer journeys with the Marketing Cloud REST API. / Pret à rendre votre travail simple ? Bonne nouvelle: vous pouvez créer du contenu, créer vos enregistrements de contact et monitorer vos parcours client avec l’API REST de Marketing Cloud.
And the REST API is your key to the latest and greatest functionality across Marketing Cloud apps, like : /Et l’API REST est votre clé pour les récentes et super fonctionnalités des applications Marketing cloud telles que :
- Contact Builder
- Content Builder
- GroupConnect
- Journey Builder
- MobileConnect
- MobilePush
- Personalization Builder
Using the REST API, you can also send transactional (or triggered) messages, manage campaigns, and handle event notifications. Avec l’aide de l’API REST, vous pouvez également envoyer des messages transactionnels et gérer vos campagnes, et traiter vos événements de notifications.
Plus, our REST API requests and responses contain JSON bodies, and the resources accept synchronous requests. /De plus, nos requetes et réponses d’API REST contiennent du code JSON et les ressources acceptent les requetes synchrones.
Dive In with SOAP API / l’API SOAP
If you’re working with an existing Marketing Cloud integration or building new functionality with Email Studio, the SOAP API provides the tools you need. / Si vous travaillez sur des integrations marketing existantes ou créer une nouvelle fonctionalité avec email studio, l’API SOAP fournit les outils dont vous avez besoin.
With the SOAP API, you can manage : /Avec l’API SOAP, vous pouvez gérer :
- Automations /les automatisations
- Content creation /Création de contenu
- Subscribers and lists /Abonnés et listes
- Tracking /Suivi
- Triggered sends /Envois déclenchés
- Other email activities /Autres activités de messagerie
The SOAP API accepts SOAP envelopes to exchange information with Marketing Cloud. /L’API SOAP accepte les enveloppes SOAP pour échanger des informations avec Marketing Cloud.
You can review your WSDL to see all of the available operations, or check out Salesforce Developers for a complete list. /Vous pouvez consulter votre WSDL pour voir toutes les opérations disponibles ou allez rechercher dans Salesforce Developers pour une liste complète.
Choose the Best API for the Job/ Choisissez la meilleur API pour votre travail
So how do you choose between the two APIs? /Entre les deux APIs comment faire son choix?
Well, the REST API works with the latest apps in Marketing Cloud and is up to almost any task, so it’s the best place to start. / L’API REST fonctionne avec les dernières applications de Marketing Cloud et est à la hauteur de presque toutes les tâches. C’est donc le meilleur choix pour commencer.
If you want to use Content Builder, the REST API is the way to go. /Si vous souhaitez utiliser Content builder, l’API REST est le choix à faire.
However, the SOAP API can be helpful for managing Email Studio content and triggered sends /Cependant, l’API SOAP peut etre utile pour gérer du contenus et des envois déclenchés
especially if you’re working with older accounts or integrations that require a specific functionality. /Spécialement si vous travaillez avec des vieux comptes ou d’intégrations qui nécessite de fonctionnalité spécifique
Keep in mind, the SOAP API can only be used with classic content in Marketing Cloud (not Content Builder). Garder à l’esprit, l’API SOAP ne peut être utilisée qu’avec du contenu classique dans Marketing Cloud (pas avec Content Builder).
If you noticed some overlap between the two APIs (namely, content and triggered sends), you’ve got a keen eye! As we mentioned earlier, you may need both APIs to accomplish some of your Marketing Cloud tasks /Si vous avez remarqué quelques chauvement entre les deux APIs (à savoir, le contenu et les envois déclenchés) vous avez des bons yeux! Comme nous l’avons mentionné précédemment, vous aurez peut-être besoin des deux API pour effectuer certaines de vos tâches Marketing Cloud.
—and these shared uses are a good example. However, when possible, opt for the REST API to make sure you’re using the most current API offerings. /Ces utilisations partagées en sont un bon exemple. Toutefois, lorsque cela est possible, optez pour l’API REST pour vous assurer que vous utilisez les offres d’API les plus récentes.
No matter which API you choose, you need an OAuth (Open Authorization) token to access Marketing Cloud. / Quelle que soit l’API choisie, vous avez besoin d’un jeton OAuth (Open Authorization) pour accéder à Marketing Cloud.
In the next unit, we walk through the steps to get your credentials and get started! /Dans l’unité suivante, nous réaliserons les étapes pour obtenir vos informations d’identification afin de commencer!
Resources /Ressources
