令牌

Last update: Tue Sep 30 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：

创建对象：

管理员

令牌终结点引用

Marketo中的令牌是类似于快捷键的特殊字符串，在运行时会被替换为单独的数据段。 Marketo中有多种类型的令牌可用，但只能通过API编辑“我的令牌”。我的令牌是特定文件夹或程序的本地子令牌。可以通过API读取、创建和删除令牌。

数据类型

可以使用以下数据类型创建令牌：

类型

描述

日期

格式为“yyyy-MM-dd”的日期值

数字

整数或浮点数

富文本

HTML字符串

分数

带符号的32位整数

sfdc营销活动

用于Salesforce campaign管理集成

文本

文本字符串

通过API创建令牌时，只能使用这些数据类型。

查询

按文件夹ID获取令牌将id作为程序或文件夹类型的路径参数。此类型由folderType参数指定。

GET /rest/asset/v1/folder/{id}/tokens.json?folderType=Folder

{
    "success": true,
    "warnings": [],
    "errors": [],
    "requestId": "4fbe#14e27fc9bbf",
    "result": [
        {
            "folder": {
                "type": "Folder",
                "value": 416
            },
            "tokens": [
                {
                    "name": "AprilFool - deverly",
                    "type": "date",
                    "value": "2015-04-01",
                    "computedUrl": "https://app-abm.marketo.com/#MF1047C3"
                }
            ]
        }
    ]
}

创建和更新

创建令牌端点创建令牌，或者如果存在令牌，则使用提交的值更新令牌。令牌是在文件夹或项目群的上下文中创建的。所需的id路径参数是将与令牌关联的文件夹的ID。 name、type、value和folderType都是令牌的必需参数。数据以POST x-www-form-urlencoded形式传递，而不是以JSON形式传递。令牌的name字段不能超过50个字符。

POST /rest/asset/v1/folder/{id}/tokens.json

Content-Type: application/x-www-form-urlencoded

name=April Fools&type=date&value=2015-04-01&folderType=Folder

{
    "success": true,
    "warnings": [],
    "errors": [],
    "requestId": "e3c2#14e280db5dc",
    "result": [
        {
            "folder": {
                "type": "Folder",
                "value": 416
            },
            "tokens": [
                {
                    "name": "April Fools",
                    "type": "date",
                    "value": "2015-04-01",
                    "computedUrl": "https://app-abm.marketo.com/#MF1047C3"
                }
            ]
        }
    ]
}

删除

按名称删除令牌将ID作为程序或文件夹类型的路径参数。此类型由folderType参数指定。根据令牌的父文件夹、name和令牌的type删除令牌，每个令牌都是必需的。数据以POST x-www-form-urlencoded形式传递，而不是以JSON形式传递。

POST /rest/asset/v1/folder/{id}/tokens/delete.json

Content-Type: application/x-www-form-urlencoded

name=AprilFool - deverly&type=date&folderType=Program

{
    "success": true,
    "warnings": [],
    "errors": [],
    "requestId": "12ed2#14e2800f89c",
    "result": [
        {
            "id": 416
        }
    ]
}

recommendation-more-help

bb269a6d-047a-4bf7-9acd-23ad9a63dc59