README

概览

Salesforce Marketing Cloud PHP SDK 允许开发者轻松访问 Salesforce Marketing Cloud。

• 这是现有社区支持Fuel-PHP SDK 的升级版本
• 与Fuel-PHP 不同，此 SDK 使用 Swagger Codegen 自动生成

支持的特性

• 事务性消息

环境要求

• PHP 7.3 及以上版本

下载

要使用此 SDK，请使用以下命令将 Salesforce Marketing Cloud SDK 添加到您的项目中

composer require salesforce-mc/marketing-cloud-sdk

入门指南

使用场景

1.基本用法

请注意，此场景中的配置是从环境变量中获取的。

$client = new SalesForce\MarketingCloud\Api\Client();
$assetApi = $client->getAssetApi();

$asset = new SalesForce\MarketingCloud\Model\Asset();

try {
    $result = $assetApi->createAsset($asset);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling AssetApi->createAsset: ', $e->getMessage(), PHP_EOL;
}

环境变量

• SFMC_ACCOUNT_ID
• SFMC_AUTH_BASE_URL (认证 TSE)
• SFMC_CLIENT_ID
• SFMC_CLIENT_SECRET
• SFMC_COUNTRY_CODE (例如：US)
• SFMC_KEYWORD (短信关键词)
• SFMC_SHORT_CODE (短信短码)

2.使用配置构建器从代码中设置配置

use Symfony\Component\DependencyInjection\ContainerBuilder;

$client = new SalesForce\MarketingCloud\Api\Client(null, null, false);

$config = $client->getConfig();
$config->setAccountId('YOUR_ACCOUNT_ID')
    ->setClientId('YOUR_CLIENT_ID')
    ->setClientSecret('YOUR_CLIENT_SECRET')
    ->setAuthBaseUrl('YOUR_AUTH_TSE')
    ->setAccessTokenUrl('YOUR_AUTH_TSE')
    ->setResourceOwnerDetailsUrl('');

$assetApi = $client->getAssetApi();
$asset = new SalesForce\MarketingCloud\Model\Asset();

try {
    $result = $assetApi->createAsset($asset);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling AssetApi->createAsset: ', $e->getMessage(), PHP_EOL;
}

有关如何使用 SDK 的更多信息，请参阅回归测试或代码示例

注意

• 此存储库中的大部分代码都是从 mcsdk-automation-framework-core 和 mcsdk-automation-framework-php 存储库自动生成的。其他功能，如认证流程、缓存，直接在此存储库中实现。
• 如果需要更改自动生成的代码，则必须从 mcsdk-automation-framework-core 或 mcsdk-automation-framework-php 存储库中更改。
• 如果需要在身份验证流程或缓存中进行更改，应在此存储库中完成。

联系我们

• 在GitHub上请求新功能，提出问题或报告错误。
• 通过发表相关评论和添加你的反应来为热门功能请求投票。用反应代替“+1”评论
• 👍 - 赞同
• 👎 - 反对

许可证

通过贡献您的代码，您同意根据BSD 3-Clause License的条款许可您的贡献。