如何在Marketo集成中使用API​​名称？

Question

我在Marketo中创建了一个名为Permalink的字段的自定义活动，其API名称为permalink。

使用POST /rest/v1/activities/external.json端点，我发送以下JSON来添加自定义活动。

{
    "input": [
        {
            "activityDate": "2016-10-17T10:32:41+00:00",
            "activityTypeId": 100005,
            "attributes": [
                {
                    "apiName": "permalink",
                    "name": "Permalink",
                    "value": "https://facebook.com"
                }
            ],
            "leadId": "492",
            "primaryAttributeValue": "Test FB post"
        }
    ]
}

此调用成功并返回以下消息：

{
    "requestId": "81d8#157d25cb121",
    "result": [
        {
            "id": 2287,
            "status": "added"
        }
    ],
    "success": true
}

但是，当我不在JSON中发送apiName时（根据documentation它确实是可选的），它也按预期工作。

我很想知道apiName的使用位置和使用方法。有什么用途，为什么它是可选的？如果有任何文件，请指出我，因为我找不到太多信息。