Регистрация в API Pardot намного проще, чем вход в API MarketCloud.
Я использовал Python, но большинство шагов не имеют ничего общего с кодом. Любой язык, который может делать запросы на HTTPS.
Задний план
Я люблю «автоматизировать скучные вещи», программированием против API Pardot.
Две общие вещи, которые я делаю:
- Добавьте много пользовательских полей на таблицу перспективы одновременно
- Очистите много плохих данных одновременно
Пароль меры предосторожности
Чтобы сделать этот код для работы, вы должны ввести свой пароль Pardot и «User Key» в свой код. Это не хорошо. Любой, кто перехватывает эту информацию, может подражать вам в Pardot.
- Запустите этот код на компьютере, которому вы доверяете.
- Запустите этот код через сетевое соединение, которое вы доверяете.
- Если вы сохраните этот сценарий Python в файле, введите «Содержит пароль» в начале имени файла, чтобы вы вспомните, что это файл, в котором вы должны очистить пароли, прежде чем закрыть его.
- Если вы работаете в IDE, который лечит последующую кнопку «RUN», щелкнув как один большой сеанс (и кэширует значения переменных от «бега» на «Run») Используйте, чтобы помочь вам помнить, чтобы очистить свой пароль из вашего файла. Запустите несколько строк кода, а остальные прокомментировали, чтобы получить «ключ API» и сохранить ее в переменной под названием
API_KEY.. Затем прокомментируйте код «Прибытие», Backspace над паролем, введите слово «PasswordGoeshere», и сохраните свой скрипт. Сделайте то же самое с вашим адресом электронной почты и пользовательским ключом. ТА ДА! Теперь вы можете перестать беспокоиться о том, оставили ли вы пароль в простом тексте в содержимом вашего сценария. - Вам придется получить экспертные советы, если вам нужно хранить этот скрипт и запустить его в каком-либо автоматическом моде. Набирая свой пароль в тело сама сценария и оставляя его просто не вариант.
1: admin -> Управление пользователями -> пользователи
Войти в Веб-консоль Pardot как системный администратор.
Если левое меню навигации еще не расширено, нажмите на навигацию «Гамбургер» (значок с тремя горизонтальными линиями) в верхней части этого.
Наведите курсор на «admin», затем нажмите «Управление пользователями», затем нажмите «Пользователи».
Вы также можете получить напрямую на этот экран, просто посетив https://pi.pardot.com/user Отказ
2: создать новый пользователь
Мне нравится создавать новый пользователь, предназначенный для внешних интеграций, а не использовать мои собственные учетные данные.
Кроме того, если вы настроили Pardot, чтобы использовать односторонние учетные данные с помощью учетных данных Salesforce, вы даже не можете попасть в API, не имея выделенного пользователя Pardot, чей «адрес электронной почты» не является именем пользователя пользователя в Salesforce Org Вы подключили к Pardot.
Новый Летом ’20: Популярные пользователи, подключенные к учетным записям SalesForce SSO Также есть ключи API!
Вы можете пропустить в «5: получить пользовательскую клавишу», если вы хотите, хотя лично мне по-прежнему рекомендую иметь целый пользователь Salesforce, предназначенный для интеграции данных, а не использовать учетные данные реального человека.
Если ваша компания проходит через электронную почту с « + что-то » на имена пользователя в имя пользователя перед « + », это особенно просто – просто добавьте что-то вроде « + REST » ” @ “.
Так, например, your_name+rest@your_company.com.
В противном случае начните с адреса электронной почты, который вы управляете, но это не пользователь в SaleForce ORG, к которому вы подключены Pardot.
(Примечание. Как только вы получите настройку пароля нового пользователя, вы можете изменить свой адрес электронной почты на поддельный адрес электронной почты, но вам придется начать с реального адреса электронной почты, чтобы вы могли получить активацию E -Почта.)
В правом верхнем углу страницы «пользователей» нажмите кнопку «Добавить пользователя».
Дайте пользователю описательное имя и фамилию. Мне нравится «отдыхать» как имя и «пользователь API» как фамилия.
Дайте пользователю адрес электронной почты, где вы можете получить электронную почту. Если у вас есть Pardot, чтобы позволить вам войти в него с помощью учетных данных SalesForce, убедитесь, что адрес электронной почты IS не Использование в качестве имени пользователя Salesforce для того, чтобы все, что вы подключены к Pardot.
Дайте пользователю роль «администратора» (Предупреждение: теперь может сделать некоторые довольно мощные вещи – будьте осторожны с его паролем!) .
Облокируйте все окна в «Настройки электронной почты».
Нажмите кнопку «Создать пользователя».
Если у вас включен Salesforce входа в систему, игнорировать Все подсказки от Pardot выбрать «имя пользователя CRM» для того, чтобы пользователь, который вы только что создали.
3: Установите пароль
Проверьте свою электронную почту. Откройте ссылку «активацию» в новом окне Incognito или другом браузере.
Установите пароль и вопрос безопасности + ответ для нового пользователя.
Храните их в безопасном менеджере паролей.
Войти в Pardot В том же «Incognito» вкладке или браузере с новыми учетными данными, чтобы убедиться, что они работают.
Выйдите из Pardot и закройте окно браузера. Вам никогда не потребуется войти в веб-консоль Pardot с этими специальными учетными данными.
4: Необязательно: изменить адрес электронной почты
Если вы думаете, что вы можете использовать один день, хотите использовать адрес электронной почты, который вы выбрали ранее как имя пользователя Salesforce User, измените адрес электронной почты Pardot Nower Neword.
Новый адрес электронной почты не должен быть подтвержден для него, чтобы стать новым именем пользователя Pardot User, поэтому вы можете использовать адрес электронной почты, который не реальный.
Однако , убедитесь, что вы измените его на то, что вы знаете, никогда не будут случайно доставляться в Кто-нибудь еще , потому что это где «сброс пароля» по электронной почте.
Не использовать ” @ example.com «Как я сделал на моем скриншотах. Это огромная уязвимость безопасности. (Я удалил пользователь из Pardot, как только я закончил, принимая скриншоты.)
Так, например, вы можете изменить его на your_name+rest@your_company.com Отказ
Чтобы сделать это, обратно в сеанс Pardot, в котором вы вошли в систему как сами, щелкните кнопку «Редактировать пользователя» в верхнем правом углу страницы пользовательской детали для созданного вами пользователя.
Отредактируйте адрес электронной почты на что-то умного и, внизу страницы, нажмите «Сохранить пользователь».
Та-да! Адрес электронной почты был изменен. Хотя вы не сможете получить электронные письма сброса пароля на адресе электронной почты, который вы выбрали, вы всегда можете временно изменять адрес электронной почты обратно в то, что вы может получить электронную почту на.
(Просто убедитесь, что он не используется в качестве имени пользователя в Saleforce ORG, у вас есть Pardot, подключенный к односторонню, если у вас есть это включено.)
5: получить ключ пользователя
К лучшему или к худшему, когда вы вошли в Pardot, как любой Системный администратор, вы можете увидеть каждый пользователь пользователя “api user”.
(Вот почему вам никогда не нужно войти в веб-консоль Pardot в качестве нового пользователя.)
Глядя на страницу подробности пользователей для пользователей, который вы только что создали, прокрутите вниз по деталям и найдите текст рядом с «UPI User Key».
Вам понадобится этот «пользовательский ключ», чтобы войти в Pardot через API.
Вы можете добавить пользовательскую клавишу в свой пароль для пароля вместе с именем пользователя и паролем для учетной записи, если вы действительно доверяете своему менеджеру паролей.
В противном случае вы можете войти в Pardot, как сами и посмотрите на эту информацию каждый раз, когда вы хотите использовать API.
6: Секреты -> Python -> Voilà!
3 ключевых куска информации, которые вам нужно войти в Pardot API с кодом в качестве данного пользователя, являются адрес электронной почты (который функционирует как имя пользователя) , пароль и Api user ключ Отказ
Откройте IDE, из которой вы можете выполнить Python и запустить следующий скрипт, при этом подходящие замены для « Путусеркера », « PutemaLAddresshere », «и« Putpasswordwere ».
import requests, urllib
ukey = 'PUTUSERKEYHERE'
api_key = requests.post(
'https://pi.pardot.com/api/login/version/3'
, params='email='+urllib.parse.quote('PUTEMAILADDRESSHERE')
+'&password='+'PUTPASSWORDHERE'
+'&user_key='+ukey
+'&format=json'
).json().get('api_key')
print(api_key)
Если все идет хорошо, Печать (API_KEY) следует показать вам токен, который вы только что сгенерировали.
В течение следующих 60 минут вы докажете свою личность, передав это « Значение сеанса » значение, сохраненное в « API_KEY , «Наряду с ключом пользователя хранится в« » kekey «И различные другие команды, к одному из Pardot API « конечные точки », которые делают полезные вещи.
Вот официальная документация о посте HTTPS, чтобы сделать при аутентификации против Salesforce Pardot «API версия 3», которая является кодом выше в журналах.
Примечание: Если вы используете IDE, которая сохраняет содержимое переменных из одного скрипта к следующему, теперь вы можете Прокомментируйте всю «аутентификацию» блок кода (Окружите его « » «До блока кода и снова после этого) И переверните содержимое обратно к « Путуберзнайльер », « PutemaLaddreshere », и « Putpasswordwere ».
- Q: Почему вы сделаете это?
- A: По той же причине это хорошая идея, чтобы почистить кухню, как вы готовите. Мысль «пароль» в вашем уме свежо. Теперь так же хорошее время, как и любой, чтобы убедиться, что вы случайно сохраняете код с паролями в своем жестком диске.
Совет: не случайно выполняйте свой код во второй раз, пока вы не прокомментировали kekey … вам понадобится реальный ключ пользователя, хранящийся в kekey Для последующих вызовов API.
Вот и все – наслаждайтесь программированием против Pardot.
использованная литература
Оригинал: “https://dev.to/katiekodes/logging-into-salesforce-s-pardot-api-w-python-4b23”