README

PHP 包，用于与 Pardot API 交互

作者: Andrew Mc Cormack

Pardot API PHP 库

一个库，通过 PHP 对象与 Pardot API 集成

此库简化了 Pardot API 的身份验证和查询过程，并提供了对所有 v4 API 功能的访问。

最新版本 2.0.0 支持 Salesforce SSO 身份验证。

设置

要初始化 Pardot API 对象，请传递您的用户电子邮件、密码、客户端 ID、客户端密钥和业务单元 ID 凭据。任何后续请求 API 以获取数据都将自动执行身份验证操作，然后再尝试获取数据。

use CyberDuck\PardotApi\PardotApi;

$pardot = new PardotApi(
    'EMAIL',
    'PASSWORD',
    'CLIENT_ID',
    'CLIENT_SECRET',
    'BUSINESS_UNIT_ID',
);

查询 API

您可以在任何 Pardot 对象上调用查询方法，传递对象、操作符和数据数组（可选）

$result = $pardot->request('campaign', 'read/id/1');

$result = $pardot->request('campaign', 'query', ['created_after' => 'today']);

对象方法

PardotApi 实例具有与 Pardot 中的对象类型相对应的函数，以简化对 API 的调用。当调用这些函数之一时，将返回一个查询对象（->campaigns() 返回一个 CampaignsQuery 对象）。这些返回的对象进一步具有对应于不同对象操作（如查询、创建、更新、插入、删除等）的函数。以下是可以用的对象列表：

账户方法

$pardot->account()->read(); // retrieves current account information

活动方法

$pardot->campaign()->query([...]); // queries and returns a filtered list
$pardot->campaign()->create([...]); // creates an object using passed array data
$pardot->campaign()->read(1); // queries an object by ID
$pardot->campaign()->update(1, [...]); // updates an object by ID using passed array data 

自定义字段方法

$pardot->customField()->query([...]); // queries and returns a filtered list
$pardot->customField()->create([...]); // creates an object using passed array data
$pardot->customField()->read(1); // queries an object by ID
$pardot->customField()->update(1, [...]); // updates an object by ID using passed array data 
$pardot->customField()->delete(1); // deletes an object by ID

自定义重定向方法

$pardot->customRedirect()->query([...]); // queries and returns a filtered list
$pardot->customRedirect()->read(1); // queries an object by ID

动态内容方法

$pardot->dynamicContent()->query([...]); // queries and returns a filtered list
$pardot->dynamicContent()->read(1); // queries an object by ID

电子邮件点击方法

$pardot->emailClick()->query([...]); // queries and returns a filtered list

电子邮件方法

$pardot->email()->read(1); // queries an object by ID
$pardot->email()->stats(1); // Returns the statistical data for the list email 
$pardot->email()->sendToID(1, [...]); // Sends a 1 to 1 email to an ID using an array of email config / data
$pardot->email()->sendToEmail('name@example.com', [...]); // Sends a 1 to 1 email to a email address an array of email config / data
$pardot->email()->send([...]); // send an email to a list of IDs

电子邮件模板方法

$pardot->emailTemplate()->listOneToOne(); // Returns a list of email templates used in 1 to 1 emails

表单方法

$pardot->form()->query([...]); // queries and returns a filtered list
$pardot->form()->read(1); // queries an object by ID

生命周期历史方法

$pardot->lifecycleHistory()->query([...]); // queries and returns a filtered list
$pardot->lifecycleHistory()->read(1); // queries an object by ID

生命周期阶段方法

$pardot->lifecycleStage()->query([...]); // queries and returns a filtered list

列表成员方法

// @todo

列表方法

// @todo

机会方法

// @todo

潜在客户账户方法

// @todo

潜在客户方法

// @todo

标签对象方法

$pardot->tagObject()->query([...]); // queries and returns a filtered list
$pardot->tagObject()->read(1); // queries an object by ID

标签方法

$pardot->tag()->query([...]); // queries and returns a filtered list
$pardot->tag()->read(1); // queries an object by ID

用户方法

$pardot->user()->query([...]); // queries and returns a filtered list
$pardot->user()->read(1); // queries an object by ID
$pardot->user()->readByEmail('name@example.com'); // queries an object by email

访客活动方法

// @todo

访客方法

$pardot->visitor()->query([...]); // queries and returns a filtered list
$pardot->visitor()->read(1); // queries an object by ID
$pardot->visitor()->assign(1,2); // Assigns or reassigns the visitor by ID to a prospect ID.

访问方法

$pardot->visit()->query([...]); // queries and returns a filtered list
$pardot->visit()->read(1); // queries an object by ID

调试

可以通过开启调试来启用错误消息。默认情况下，请求 Pardot API 将静默失败，以防止致命的应用程序错误。在实现此库时应进行额外的响应检查，因为大多数方法在 API 查询有问题时将返回 null。

$pardot->setDebug(true);

输出类型

您可以更改输出类型为全、简单、移动或批量。默认为全。

$pardot->setOuput('full');