Рубрики
Без рубрики

Войдите в Salesforce Marketing Cloud API (с / Python или Postman)

Иногда просто получить подтверждение входа в систему от API – это половина битвы с использованием его. Здесь, … Помечено с Python, Salesforce, Учебник, API.

  • Автор записи Автор: Katie
  • Дата записи 25.03.2022

Иногда просто получить подтверждение входа в систему от API – это половина битвы с использованием его.

Здесь, с Скриншоты как я Наконец Зарегистрировано в API Salesforce Marketing Cloud’s API.

Я использовал Python, но большинство шагов не имеют ничего общего с кодом. Любой язык, который может делать запросы на HTTPS.

Задний план

Мой эксперт по электронной почте, и я собираюсь объединиться и исследовать, какие из его «кликов» мы можем подражать с «кода».

Надеюсь, это поможет нам делать отличные вещи, соединяющиеся со вторичными продажными силами «Орги» (базы данных) Отказ

Пароль меры предосторожности

Чтобы сделать этот код на работу, вы должны ввести секретную информацию в ваш код Это может позволить Любой, кто это перехватывает подражать вам в маркетинговом облаке.

Это не хорошо.

  1. Запустите этот код на компьютере, которому вы доверяете.
  2. Запустите этот код через сетевое соединение, которое вы доверяете.
  3. Если вы сохраните этот скрипт Python в файле, введите «Содержит пароль» в начале имени файла, так что вы будете вспомнить, что это файл, в котором вы должны очистить свой « ID клиента », – клиент Секрет , “и” База аутентификации URI “Прежде чем закрывать. Если вы работаете в IDE, который лечит последующую кнопку «RUN», щелкнув как один большой сеанс
  4. (и кэширует значения переменных от «бега» на «Run») Используйте, что, чтобы помочь вам помнить, чтобы очистить свой « ID клиента », « Client Secret », «И» База аутентификации URI “из вашего файла. Запустите несколько строк кода, с прокомментированными остальными, чтобы получить «токен доступа» и сохранить его в переменной под названием « токен ». Затем прокомментируйте код «Feailing», Backspace по секретной информации и введите слово « Secret_info_goes_here », и сохраните свой скрипт. ТА ДА! Теперь вы можете перестать беспокоиться о том, оставили ли вы секреты в виде простого текста в содержимом вашего сценария. Вам придется получить экспертные советы, если вам нужно хранить этот скрипт и запустить его в каком-либо автоматическом моде. Набрав секреты в организм сама сценария и оставляя его просто не вариант.

1: admin -> Установленные пакеты.

Войдите в веб-консоль маркетинга облака в качестве администратора.

Нажмите на раскрывающуюся стороннее имя, вверху справа.

В разделе «Настройки» нажмите « Администрация ».

В Top Nav, наведите курсор на « аккаунт » и нажмите « Установленные пакеты ».

2: Создайте новый пакет.

Нажмите кнопку « NEW ».

Дайте свой новый пакет A Имя и Описание Отказ Нажмите Сохранить Отказ

У вас есть новый пакет!

В нижней половине его «Детали» вкладка «Детали» указывают на то, что ваш новый пакет еще не имеет компонентов.

Через на мгновение, после этого краткого переадресации, нажмите « Добавить компонент ».

Развлечения: Настройки доступа

Если вы нажмете на вкладку « …….».

У нас будет шанс исправить это позже.

3: Создайте новый компонент.

Нажав на кнопку «Add Add Add » в вкладке «Детали деталей» нового пакета, вы выберете « Inpi Integration » из меню радиопередачи параметров и нажмите « ». Следующий “

Выберите « Server-Server » из меню радиопередачи параметров и нажмите « » Следующий “

Нажмите на « Читать » Флажки на все, что вы хотите иметь возможность читать с кодом и нажмите « Сохранить ».

Я проверил «читать» во всех коробках.

Важно: Пожалуйста, не нажимайте ничего, кроме « Читать » еще.

Вы Действительно не хочу быть человеком, который ударил все данные В маркетинговом облаке, потому что вы дали себе « Написать » Разрешения с API, вы даже не пробовали, не так ли?

Развлечения: Настройки доступа

Теперь, если вы нажмете на вкладку « Access » вашего пакета, вы увидите листья левого навигателя всех ваших «бизнес-единиц».

Нажмите на один, и вы можете включить или выключить доступ или выключать доступ или выключить доступ к API.

4: Секреты -> Python -> Voilà!

В « Подробнее » вкладка вашего пакета ниже под «компонентами» в разделе «Интеграция API», вы найдете все виды секретной информации.

3 ключевых фрагмента информации – ваш « ID клиента », « Client Secret ,” и ” База аутентификации URI .”

Откройте IDE, из которой вы можете выполнить Python и запустить следующий скрипт, делая подходящие замены для « your_client_Id », ” your_client_secret ,” и ” https://Ваш аутентификация-uri. COM ” (До « /V2/токен часть URL) :

import json, requests

client_Id = 'YOUR_CLIENT_ID'
client_Secret = 'YOUR_CLIENT_SECRET'

payload = {
    'client_id': client_Id,
    'client_secret': client_Secret,
    'grant_type': 'client_credentials'
}

url = 'https://YOUR-AUTHENTICATION-URI.com/v2/token';

r = requests.post(url,
    data=payload)

body = json.loads(r.content)
token = body['access_token']
expiresIn = body['expires_in']
print(token)

Если все идет хорошо, Печать (токен) следует показать вам токен, который вы только что сгенерировали.

Если вещи не пойдут хорошо, попробуйте добавить Печать (R) и Печать (тело) к вашему сценарию и повторно работает. Вы получите более подробный статус и отзывы об ошибках о запросе HTTPS Post, который Python только что сделан от вашего имени.

В течение следующих 20 минут вы докажете свою личность, передавая это « токен » значение для одного из двух других маркетинговых облаков URL-адресов, дал вам (Отдых или мыло) .

Эти URL-адреса предназначены для фактических данных от маркетинговых облаков.

Вот официальная документация о HTTPS-сообщении, чтобы сделать при аутентификации против торговли SaleForce Marketing Cloud Отказ

(Примечание: На самом деле включает в себя «тип контента» «приложения/JSON», согласно официальным инструкциям, кажется насильственным. Это не сработало для меня. Попробуйте взять его из своего заголовка, если вы столкнулись с проблемами.)

Счастливые эксперименты!

Обновления

Тип администратора имеет значение

Благодаря комментарию Джозеф Воган Для указывания:

Есть одна вещь, которая на некоторое время подпела. Хотя у меня был Администратор Права в маркетинговом облаке, что не приходит с чем-то называемым Администратор маркетингового облака что дает вам разрешение необходимо: Установить пакет |. Администрирование Отказ Как ни странно, интерфейс позволяет устанавливать пакет, даже если у вас нет этого разрешения, но вы получите ошибку с просьбой проверить, является ли идентификатор клиента, Client Secret является точным, и что пакет «был установлен и включен».

Специалист по местному маркетингу клуба Кайл Гриффин разъясняет:

  • Роль «Администратор» – это просто «Amail Studio» администратора (Первый продукт MarketingCloud) Отказ
  • Роль «Marketing Cloud Administrator» позволяет управлять остальной частью набора.

UI изменился

Маркетинговое облако перемещает все вокруг, так как я написал это. Чтобы пройти через шаги под «1: admin -> Установленные пакеты» выше:

  1. Вы нажимаете « Настройка » вместо « Администрация » под вашим именем.
  2. Вместо нажатия на топ-Nav «аккаунт», чтобы найти «Установленные пакеты», «Навигация влево сейчас. Найти «Установленные пакеты» под инструментами платформы -> Приложения.

Мыло Здравствуйте, мир с почтальоном

Я привел пример подключения в Python, но если вы новичок, чтобы подключиться к API, попробуйте сначала почтальон.

Почтальон Это инструмент графического пользовательского интерфейса, который позволяет легко выяснить «Где поставить то, что» при создании HTTP-запросов против API. Когда я экспериментирую, я считаю гораздо проще, чем делать все с текстовым языком программирования.

Установите и откройте почтальон на вашем компьютере. Нажмите, в левом верхнем углу Импорт Отказ Затем нажмите на 3-й вкладку « Импорт из ссылки », «И вставьте https://katiekodes.com/files/marketingCloudPostMancollectionForlog.json и нажмите на Импорт кнопка.

Слева в почтоване (Перейдите в полноэкранное, чтобы разоблачить его, если вы этого не увидите) , вы увидите папку на вкладке «Коллекции» под названием « Katie Kodes Marketing Cloud ».

  1. Предмет ” 1. Войти – API V2 «Является ли почтальон, эквивалентен сценарию Python, который I предоставил выше.

    • Дважды щелкните по нему, чтобы открыть его на новой вкладке справа.
    • В URL между Пост и Отправить Кнопка, изменить https://your_subdomain.auth.cmarketingcloudapis.com/v2/token К тому же https://your-authentication-uri.com/v2/token Я объяснил ранее. (Это та же самая идея, я только что включил немного больше на заказ URL-rug, который вы бы увидели перед примером «.com» в моем Postman.)
    • На вкладке «Тело» редактора запросов заменить Your_client_id . с вашим фактическим идентификатором клиента и Your_client_secret с вашим настоящим секретом клиента.
    • Нажмите Отправить и посмотрите, что вы получаете внизу под Ответ .
    • Не доволен вашими результатами? Нажмите Примеры (1) В правом верхнем углу и нажмите « 1». Войти – API V2 – Пример ответа “От выбора.
    • Посмотрите на пример ответа на нижнюю часть экрана. Это то, что мой выглядел, как только с реальными ценностями, где Your_auth_key , https://your_subdomain.soap.marketingcloudapis.com/ и https://your_subdomain.rest.cmarketingCloudapis.com/ являются.
    • Слева от окна редактора HTTP-запроса нажмите кнопку «Чтение стрелки влево» 1. Войти – API V2. “

  2. Предмет ” ” 2. Первый вызов SOAP – Запрос всех расширений данных с ключом аутентификации V2 «Для вас, чтобы попробовать, как только у вас будет скопировано значение в ваш буфер обмена где Your_auth_key должен был появиться в реакции входа в систему.

    • Дважды щелкните по нему, чтобы открыть его на новой вкладке справа.
    • В URL между Пост и Отправить Кнопка, изменить Your_subdomain в https://your_subdomain.soap.cormetingCloudapis.com/v2/token Чтобы сопоставить значение, которое вернулось в ответ на вход в систему в MarketingCloud под « SOAP_INSTANCE_URL ».
    • На вкладке «Тело» редактора запросов сделайте то же самое между и Теги XML, содержащихся в нем.
    • Также на вкладке «Тело» редактора запросов заменить Your_auth_key между и Теги
    • Содержание … Где вы говорите MarketingCloud, какие данные вы хотите. Здесь я решил скачивать все мои Расширения данных И получить следующую информацию о каждом в загрузке: Объект , Клинингриай , Имя , Выдавляемым и SendablyUbsCriberfield. Имя Отказ Надеюсь, у вас тоже есть расширения данных, или результаты этого «Hello World» могут быть немного зашлой!
    • Нажмите Отправить и посмотрите, что вы получаете внизу под Ответ .
    • Не доволен вашими результатами? Нажмите Примеры (1) В правом верхнем углу и нажмите « 2». Первый вызов SOAP – Запрос Все расширения данных с ключом аутентификации V2 – пример ответа “От выбора.
    • Посмотрите на пример ответа на нижнюю часть экрана. Это то, что у меня было похоже, что только у меня были десятки реальных расширений данных вместо 3 поддельных.
    • Слева от окна редактора HTTP-запроса нажмите кнопку свечения стрелки влево-указывая «2». Первый вызов SOAP – Запрос всех расширений данных с ключом аутентификации V2.

Как только вы работаете и бегаете и готовы к большему, проверьте Энтони Дотсон и команды Github Repository « SFMC-Postman ».

Этот репозиторий имеет коллекцию Postman «, как у меня, что вы можете импортировать в почтальон и попробовать много примеров, сразу же, как вы получили первое« извлечь все ваши данные о расширениях данных »Hello-World.

Разрешите телы различных примеров запроса и посмотрите, как они говорят о том же против, как они варьируются.

Обратите внимание, что XML-отформатированный текст организма многих из этих запросов известен как «сообщение SOAP» или «SOAP CONVELOPE». По большей части каждый HTTP-запрос на «мыло« SOAP »MarketingCloud будет выглядеть так же … Это просто маленькие кусочки этого блока текста, которые собираются варьироваться. Но вы должны получить их в самый раз или вещи терпят неудачу. Честно говоря, я до сих пор не получил более 6 примеров с работы GitHub Reppo, пока (Хотя я не должен был) Отказ

Удачи, и поделитесь тем, что Вы строить!

Оригинал: “https://dev.to/katiekodes/logging-into-salesforces-marketing-cloud-api-w-python-52mo”

Читайте ещё по теме: