FuelSDK-Python 开源项目最佳实践

2025-05-14 12:22:08作者：房伟宁

1、项目介绍

FuelSDK-Python 是由 Salesforce Marketing Cloud 提供的一个开源 Python SDK，它允许开发者通过 Python 代码与 Salesforce Marketing Cloud API 进行交互。这个 SDK 提供了一套丰富的方法，用于发送电子邮件、管理营销列表、跟踪活动以及其他 Marketing Cloud 功能。

2、项目快速启动

要开始使用 FuelSDK-Python，首先确保您已经安装了 Python。以下是快速启动的步骤：

# 安装 FuelSDK-Python
pip install FuelSDK

# 导入所需的模块
from fuelrats import Client

# 创建一个 Marketing Cloud 客户实例
client = Client(
    client_id='您的应用ID',
    client_secret='您的应用密钥',
    username='您的登录名',
    password='您的登录凭证',
    auth_url='https://login marketingcloud.com/'
)

# 获取 Marketing Cloud 的账户数据
accounts = client.get('/accounts')
print(accounts)

确保替换 '您的应用ID'、'您的应用密钥'、'您的登录名' 和 '您的登录凭证' 为您从 Marketing Cloud 获取的实际凭证。

3、应用案例和最佳实践

发送电子邮件

以下是一个使用 FuelSDK-Python 发送电子邮件的基本示例：

from fuelrats import Client, Email

# 创建邮件实例
email = Email()
email.name = "Test Email"
email.subject = "Test Subject"
email.from_addr = "from@example.com"
email回复_addr = "replyto@example.com"
email.html_body = "<html><body><h1>This is a test email</h1><p>With HTML content.</p></body></html>"
email.text_body = "This is a test email with plain text content"

# 发送邮件
client.send_email(email)

管理营销列表

以下示例展示如何使用 FuelSDK-Python 创建和更新营销列表：

from fuelrats import Client, List

# 创建列表实例
list_obj = List()
list_obj.name = "Test List"
list_obj.description = "This is a test list"
list_obj.folder_id = "您的文件夹ID"

# 创建列表
client.create(list_obj)

# 更新列表
list_obj.description = "Updated description"
client.update(list_obj)