README

用于与 Pardot API 交互的 PHP 包

作者： Andrew Mc Cormack

Pardot API PHP 库

通过 PHP 对象与 Pardot API 集成的库

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

配置

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

use CyberDuck\PardotApi\PardotApi;

$pardot = new PardotApi(
    'EMAIL',
    'PASSWORD',
    'USER_KEY'
);

查询 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

潜在客户方法

$pardot->prospect()->readByEmail('name@example.com'); // queries an object by email

标签对象方法

$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');