Getresponse API 2（使用 PHP 添加自定义字段和联系人）

我对编码和 Web 开发还很陌生，而深入研究 API 是我希望自己从未做过的事情！然而话虽这么说，我的进步比预期的要远。我现在在尝试将自定义字段添加到添加联系人功能时遇到问题。我试图获取代码以在用户点击我的感谢页面时添加隐藏的表单输入字段。我不想在我的主页上使用 Getresponses 自己的表单构建器，因此最好使用 API。当我添加联系人时，代码运行得很好，但是当我添加 set_contact_customs 时，代码不会执行，并且失败并出现以下错误：（请求有返回错误：数组）所以我理解它与 set_contact_customs 数组有关但是我不知道我做错了什么。非常感谢任何建议和帮助，因为我仍在学习基础知识，所以学习专家所说的内容是一个很好的学习曲线。谢谢。

--- 下面是没有 set_contact_customs 的工作版本 ----

<?php
// Add contact to selected campaign id
try{
$result_contact = $client->add_contact(
$api_key,
array (
'campaign' => 'My-Camp-ID',
'name' => $fullname,
'email' => $emailaddress
)
);

echo "<p style='color: blue; font-size:24px;'>No Errors, Contact and Custom Fields have been added...</p>";
}

catch (Exception $e) {

echo $e->getMessage();
}

?>

--- 这是导致问题的代码（使用 set_contact_customs）----

    <?php
// Add contact to selected campaign id
try{
$result_contact = $client->add_contact(
$api_key,
array (
'campaign' => 'My-Camp-ID',
'name' => $fullname,
'email' => $emailaddress
)
);
$result_contact = $client->set_contact_customs(
        $api_key,
            array(
                'Survey Type' => $surveytype,
                'Survey Cost' => $surveycost
                )
);
echo "<p style='color: blue; font-size:24px;'> Contact Added </p>";
}

catch (Exception $e) {

echo $e->getMessage();
}

?>

1. API 2 并不真正存在：在 GetResponse 中they say版本“1.5.0 - 这是我们 API 的最后一个 JSON/RPC 版本”，特别是如果您是在 10 个月前说话的话。现在他们正准备对 v3 进行 beta 测试。所以我假设你正在谈论 1.5 并回答它（我不熟悉 v3，也许有不同）。

2. 你必须使用 set_contact_customs 发送联系人 ID，而你没有。

3. 当它说“请求错误：数组”时，它与您的数组无关（即使问题出在您的数组中，因为您没有发送联系人 ID），他们正在发送一个数组作为响应错误消息。

4. 我很想告诉你，在哪里可以获取联系 ID 以便发送，但我现在正在自己寻找。 :)

UPDATE:

好的，我从互联网上的各个片段中将其组合起来，现在这是工作格式。

5. 您不需要 add_contact 然后更新它，您可以一次性完成，将“customs”参数添加到 add_contact 调用中（GR 说，我们不应该期望立即添加联系人，因此您如果您立即调用该函数，甚至可能无法找到要更新的对象）。

   add_contact 的字段有描述here.

6. “customs”参数看起来应该有所不同。代替：

   array(
       'Survey Type' => $surveytype,
       'Survey Cost' => $surveycost
       )
   

   它应该是：

   array(
       array( 'name' => 'Survey Type', 'content' => $surveytype ),
       array( 'name' => 'Survey Cost', 'content' => $surveycost )
       )
   

   顺便说一句，根据我的测试，幸运的是，您不需要首先在 GR UI 中定义这些自定义字段，无论您发送什么，都将被添加或更新（在自定义字段名称和值的限制内）。

   当尝试发送一个包含空内容的自定义字段时，调用 add_contact 时出现错误。当我用set_contact_customs发送它时，我没有收到任何错误；我想看看它是否会删除字段或字段值 - 它什么也没做。

7. 如果您仍希望更新现有联系人，请按以下步骤通过更新呼叫发送联系人 ID：

   $result = $client->set_contact_customs(
      $api_key, array(
         'contact' => $contact_id,
         'customs' => $custom_fields_array
       )
   );
   

8. 要首先查找联系人 ID，您应该致电获取联系人。而且既然有人说过（我没有测试过），在不同的营销活动中，具有相同电子邮件地址的联系人具有不同的联系人 ID，因此您应该传递营销活动及其电子邮件。

   As you can see，营销活动可以在“campaigns”参数中发送（然后应使用您为 add_contact 获得的营销活动 ID），或在“get_campaigns”中发送（然后可以使用营销活动名称甚至前缀）。

   这是带有广告活动 ID 的调用，用于您的代码：

   $result = $client->get_contacts(
       $api_key, array(
          'campaigns' => array( 'My-Camp-ID' ),
          'email' => array( 'EQUALS' => $emailaddress )
       )
   );
   

9. 要从 get_contacts 检索联系人 ID，请按照检索营销活动 ID 的建议执行相同操作：

   $contact_id = array_pop( array_keys( $result ) );
   if ( empty( $contact_id ) ) {
       //still not ok
   }
   else {
       //you can call set_contact_customs
   }
   

10. 为了使该错误消息更具描述性，而不只是“请求有返回错误：数组”，请打开 jsonRPCClient.php（您肯定会在这些 GR 函数调用中将其包含在文件中），然后查找以下行：

    !is_null($response['error']) => 'Request have return error: ' . $response['error'],
    

    并将其替换为至少以下内容：

    !is_null($response['error']) => 'Request have returned error: ' . var_export($response['error'], true),
    

    现在你的代码将使用心爱的var_export函数，如果您犯了错误，您将在错误日志中看到类似以下内容：

    Request have returned error: array (
      'message' => 'Invalid params',
      'code' => -32602,
    )
    

我将这个彻底的答案献给所有那些在 StackOverflow 上不断帮助我的人，他们只是在几年前就回答了别人的问题。谢谢你！希望我的回答也能节省别人的时间、精力和心情。 :)