@adobe/aio-lib-target

中文文档
4.0.3发布于 2026/03/31CommonJS近 30 天下载 2.4万

Adobe 目标 SDK

中文使用文档
文档目录47 节
  1. 安装
  2. API目标技术要求
  3. 基于用户的 OAuth 键和角色要求
  4. 使用量
  5. 类
  6. 职能
  7. 目标CoreAPI
  8. 目标CoreAPI.init(租户, apiKey, 代号) QQ TargetCoreAPI
  9. 目标CoreAPI.get activities([可选 ) Promise.<Response>
  10. 目标CoreAPI.createAB 活性(机构,[可选 ) * Promise.<Response>
  11. 目标CoreAPI.createXTActivity(机构,[可选 ) * Promise.<Response>
  12. 目标CoreAPI.getAB ActivityById(id,[options]) QQ Promise.<Resp…
  13. 目标CoreAPI.getXT activityById(id,[options]) QQ Promise.<Resp…
  14. 目标CoreAPI.updateAB 活性(id, body, [选项]) QQ Promise.<Response>
  15. 目标CoreAPI.updateXT 活性(id, body, [选项]) QQ Promise.<Response>
  16. 目标CoreAPI. set activityName (id, name, [options]) Promise.<…
  17. 目标CoreAPI.set activity State(id, state,[options]) * Promise…
  18. coreAPI.set activity Priority(id,优先级,[可选 ) * Promise.<Respo…
  19. 目标CoreAPI.set activitySchedule(id, 调度, [选项]) QQ Promise.<Re…
  20. 目标 CoreAPI.deleteAB 活动(id,[可选 ) QQ Promise.<Response>
  21. 目标CoreAPI.deleteXTActivity(id,[可选 ) QQ Promise.<Response>
  22. 目标 CoreAPI.get Activity ChangeLog(id,[可选 ) QQ Promise.<Resp…
  23. 目标CoreAPI.getOffers([选项]) QQ Promise.<Response>
  24. 目标CoreAPI.get OfferById(id,[可选]) QQ Promise.<Response>
  25. 目标CoreAPI.create Offer( body,[可选 ) QQ Promise.<Response>
  26. 目标CoreAPI.update Offer(id, body, [options]) QQ Promise.<Res…
  27. 目标CoreAPI.deleteOffer(id,[选项]) QQ Promise.<Response>
  28. 目标 CoreAPI.get Auditences([可选 ) QQ Promise.<Response>
  29. 目标CoreAPI.createAuditence(机构,[可选 ) QQ Promise.<Response>
  30. 目标 CoreAPI.get AudenceById(id,[选项]) QQ Promise.<Response>
  31. 目标CoreAPI.update 观众(id, body, [options]) QQ Promise.<Respon…
  32. 目标CoreAPI.deleteAudentence(id,[选项]) QQ Promise.<Response>
  33. 目标CoreAPI.get Properties([选项]) QQ Promise.<Response>
  34. 目标CoreAPI.get PropertyById(id,[可选]) QQ Promise.<Response>
  35. 目标CoreAPI.getMBoxes([可选 ) QQ Promise.<Response>
  36. 目标 CoreAPI.getMBoxBy Name (名称, [选项]) Promise.<Response>
  37. 目标CoreAPI.getMBoxProfile 属性([可选 ) QQ Promise.<Response>
  38. coreAPI.get environments([可选 ) Promise.<Response>
  39. 目标CoreAPI.getAB 实际操作(id,[可选 ) Promise.<Response>
  40. 目标CoreAPI.getXT activity 性能(id,[可选 ) QQ Promise.<Response>
  41. 目标CoreAPI.get activityPerformance(id,[选项]) * Promise.<Respo…
  42. 目标CoreAPI.get Orders Report(id,[options]) QQ Promise.<Respo…
  43. 目标 CoreAPI. executeBatch(正体) QQ Promise.<Response>
  44. init( 租户, apiKey, 代号) QQ Promise.<TargetCoreAPI>
  45. 除错日志
  46. 捐款
  47. 许可证发放

Version Downloads/week Node.js CI License Codecov Coverage

Adobe 目标 SDK

节点 Javascription 核心 SDK 包装 Adobe 目标 API。 。 。 .

安装

$ npm install

API目标技术要求

Adobe 目标 1.0 API 需要设置 Accepts 给他们打个头,让他们正常工作 带有版本 2.x 或更多这个SDK, 我们设置适当的 Accepts 呼叫头为 文档。以往版本的 SDK 可能有效,也可能无效,因为对于某些目标 API 来说 Accepts 标题没有一贯执行.

基于用户的 OAuth 键和角色要求

对于使用基于用户的OAuth令牌而不是JWT技术账户的假想,用户可能要求在Adobe目标中指定特定角色/许可,以成功执行API呼叫. 否则,由API客户端执行的Adobe目标API呼叫将导致500个出错.

详情请参见 Adobe 目标企业用户权限文档。 。 。 .

使用量

  1. 初始化 SDK
var sdk = require('@adobe/aio-lib-target')

async function sdkTest() {
  //initialize sdk
  const targetClient = await sdk.init('<tenant>', 'x-api-key', '<valid auth token>')
}

Init 方法返回类实例 TargetCoreAPI

  1. 使用初始化 sdk 的调用方法
var sdk = require('@adobe/aio-lib-target')

async function sdkTest() {
    //initialize sdk
    const targetClient = await sdk.init('<tenant>', 'x-api-key', '<valid auth token>')

    //get activities
    const activities = await targetClient.getActivities({limit:5, offset:0})
    console.log(util.inspect(activities));

    //get offers
    const offers = await targetClient.getOffers({limit:5, offset:0})
    console.log(util.inspect(offers));

     //get offer by id activity
     const offer = await targetClient.getOfferById(123)
     console.log(util.inspect(offer));
}

Sdk 下的所有可用方法都有记录 here

类

目标CoreAPI

这个类提供了调用Adobe目标API的方法. 在调用任何方法之前, 通过调用它的方法初始化实例 带有有效房客、 apiKey 和 认证符

职能

init( 租户、 apiKey、 代号) ⇒ Promise.<TargetCoreAPI>

返回以新的目标CoreAPI对象解决的保证 .

目标CoreAPI

这个类提供了调用Adobe目标API的方法. 在调用任何方法之前, 通过调用它的方法初始化实例 带有有效房客、 apiKey 和 认证符

仁爱: 全球类

目标CoreAPI.init(租户, apiKey, 代号) QQ TargetCoreAPI

初始化 sdk.

仁爱: 实例方法 TargetCoreAPI
回返数字 : TargetCoreAPI - 一个目标CoreAPI实例

参数类型说明
租户stringAdobe 目标租户名
键string您的 Api 密钥
符号string有效验证符

目标CoreAPI.get activities([可选 ) Promise.<Response>

列出活动. 获取您的目标账户中创建的活动列表, 并具备按属性过滤和排序的能力 .

仁爱: 实例方法 TargetCoreAPI
回返数字 : Promise.<Response> - 承诺做出回应

参数类型默认说明
[可选object以控制活动搜索
[选项.限number2147483647定义要返回的项目数量
[选项.offset]number0定义从全部活动列表中返回的第一个活动。 与限制结合使用,可以在应用程序中提供页码,供用户浏览一大批活动.
[选项.sort] 由]string定义返回项目的排序标准
[选项.头object传递给 API 呼叫的页眉

目标CoreAPI.createAB 活性(机构,[可选 ) * Promise.<Response>

创建 AB 活动 . 创建一个包含指定内容的新AB活动,并返回创建的活动.

仁爱: 实例方法 TargetCoreAPI
回返数字 : Promise.<Response> - 承诺做出回应

参数类型说明
机构object活动JSON.
[可选objectsdk 选项
[选项.头object传递给 API 呼叫的页眉

目标CoreAPI.createXTActivity(机构,[可选 ) * Promise.<Response>

创建 XT 活动 . 创建一个带有指定内容的新 XT 活动,并返回创建的活动.

仁爱: 实例方法 TargetCoreAPI
回返数字 : Promise.<Response> - 承诺做出回应

参数类型说明
机构object活动JSON.
[可选objectsdk 选项
[选项.头object传递给 API 呼叫的页眉

目标CoreAPI.getAB ActivityById(id,[options]) QQ Promise.<Response>

获得AB活动. 如果发现AB活动为 id 引用, 获取当前定义 .

仁爱: 实例方法 TargetCoreAPI
回返数字 : Promise.<Response> - 承诺做出回应

参数类型说明
编号number活动编号.
[可选objectsdk 选项
[选项.头object传递给 API 呼叫的页眉

目标CoreAPI.getXT activityById(id,[options]) QQ Promise.<Response>

获得XT活动. 如果发现 XT 活动为 id 引用, 请获取当前定义 .

仁爱: 实例方法 TargetCoreAPI
回返数字 : Promise.<Response> - 承诺做出回应

参数类型说明
编号number活动编号.
[可选objectsdk 选项
[选项.头object传递给 API 呼叫的页眉

目标CoreAPI.updateAB 活性(id, body, [选项]) QQ Promise.<Response>

更新 AB 活动 . 用请求中提供的内容更新AB活动定义。 这可以改变现有活动的状况和行为.

仁爱: 实例方法 TargetCoreAPI
回返数字 : Promise.<Response> - 承诺做出回应

参数类型说明
编号number活动编号.
机构objectjSON活动
[可选objectsdk 选项
[选项.头object传递给 API 呼叫的页眉

目标CoreAPI.updateXT 活性(id, body, [选项]) QQ Promise.<Response>

更新 XT 活动 . 更新当前 XT 活动的定义,如果它被找到为 id 引用的话.

仁爱: 实例方法 TargetCoreAPI
回返数字 : Promise.<Response> - 承诺做出回应

参数类型说明
编号number活动编号.
机构objectjSON活动
[可选objectsdk 选项
[选项.头object传递给 API 呼叫的页眉

目标CoreAPI. set activityName (id, name, [options]) Promise.<Response>

更新活动名称 . 更新所提供 ID 引用的 AB 活动名称.

仁爱: 实例方法 TargetCoreAPI
回返数字 : Promise.<Response> - 承诺做出回应

参数类型说明
编号number活动编号.
名称string新活动名.
[可选objectsdk 选项
[选项.头object传递给 API 呼叫的页眉

目标CoreAPI.set activity State(id, state,[options]) * Promise.<Response>

更新活动状态 . 如果发现某项活动为id所引用,则更新活动状态.

仁爱: 实例方法 TargetCoreAPI
回返数字 : Promise.<Response> - 承诺做出回应

参数类型说明
编号number活动编号.
状态string新活动状态.
[可选objectsdk 选项
[选项.头object传递给 API 呼叫的页眉

coreAPI.set activity Priority(id,优先级,[可选 ) * Promise.<Response>

更新活动优先级 . 更新某项活动的优先级,如果它被找到为 id 参考.

仁爱: 实例方法 TargetCoreAPI
回返数字 : Promise.<Response> - 承诺做出回应

参数类型说明
编号number活动编号.
优先级string新活动优先.
[可选objectsdk 选项
[选项.头object传递给 API 呼叫的页眉

目标CoreAPI.set activitySchedule(id, 调度, [选项]) QQ Promise.<Response>

更新活动时间表 . 更新活动时间表,如果发现活动日期为编号.

仁爱: 实例方法 TargetCoreAPI
回返数字 : Promise.<Response> - 承诺做出回应

参数类型说明
编号number活动编号.
时间表string新活动时间表.
[可选objectsdk 选项
[选项.头object传递给 API 呼叫的页眉

目标 CoreAPI.deleteAB 活动(id,[可选 ) QQ Promise.<Response>

删除AB活动. 删除如果找到 ID 引用的 AB 活动.

仁爱: 实例方法 TargetCoreAPI
回返数字 : Promise.<Response> - 承诺做出回应

参数类型说明
编号number活动编号.
[可选objectsdk 选项
[选项.头object传递给 API 呼叫的页眉

目标CoreAPI.deleteXTActivity(id,[可选 ) QQ Promise.<Response>

删除 XT 活性 . 如果发现 XT 活动为 id 所引用,则删除该活动的现有定义.

仁爱: 实例方法 TargetCoreAPI
回返数字 : Promise.<Response> - 承诺做出回应

参数类型说明
编号number活动编号.
[可选objectsdk 选项
[选项.头object传递给 API 呼叫的页眉

目标 CoreAPI.get Activity ChangeLog(id,[可选 ) QQ Promise.<Response>

获取活动更改日志 . 返回给定活动 ID 的更改日志.

仁爱: 实例方法 TargetCoreAPI
回返数字 : Promise.<Response> - 承诺做出回应

参数类型说明
编号number活动编号.
[可选objectsdk 选项
[选项.头object传递给 API 呼叫的页眉

目标CoreAPI.getOffers([选项]) QQ Promise.<Response>

名单提供. 检索已创建内容报价列表. 通过查询字符串传递的参数是可选的,用于表示排序和过滤选项.

仁爱: 实例方法 TargetCoreAPI
回返数字 : Promise.<Response> - 承诺做出回应

参数类型默认说明
[可选object来控制提供搜索.
[选项.限number2147483647定义要返回的项目数量
[选项.offset]number0定义从“提供”列表中返回的第一批要约。 与限制结合使用,可以在应用程序中提供页码,供用户浏览一大批出价.
[选项.sort] 由]string定义返回项的排序标准.
[选项.头object传递给 API 呼叫的页眉

目标CoreAPI.get OfferById(id,[可选]) QQ Promise.<Response>

得到报价. 检索要约编号.

仁爱: 实例方法 TargetCoreAPI
回返数字 : Promise.<Response> - 承诺做出回应

参数类型说明
编号number提供身份证明.
[可选objectsdk 选项
[选项.头object传递给 API 呼叫的页眉

目标CoreAPI.create Offer( body,[可选 ) QQ Promise.<Response>

创建提供 . 创建由请求数据定义的新内容要约.

仁爱: 实例方法 TargetCoreAPI
回返数字 : Promise.<Response> - 承诺做出回应

参数类型说明
机构object提供JSON.
[可选objectsdk 选项
[选项.头object传递给 API 呼叫的页眉

目标CoreAPI.update Offer(id, body, [options]) QQ Promise.<Response>

最新提议. 更新 ID 引用的内容.

仁爱: 实例方法 TargetCoreAPI
回返数字 : Promise.<Response> - 承诺做出回应

参数类型说明
编号number提供身份证明.
机构object提供JSON
[可选objectsdk 选项
[选项.头object传递给 API 呼叫的页眉

目标CoreAPI.deleteOffer(id,[选项]) QQ Promise.<Response>

删除提议. 删除所提供 ID 引用的内容.

仁爱: 实例方法 TargetCoreAPI
回返数字 : Promise.<Response> - 承诺做出回应

参数类型说明
编号number提供身份证明.
[可选objectsdk 选项
[选项.头object传递给 API 呼叫的页眉

目标 CoreAPI.get Auditences([可选 ) QQ Promise.<Response>

列出观众名单. 列出所有可用的受众, 并按每个可用的字段进行过滤和排序 .

仁爱: 实例方法 TargetCoreAPI
回返数字 : Promise.<Response> - 承诺做出回应

参数类型默认说明
[可选object用于控制受众搜索的选项.
[选项.限number2147483647定义要返回的项目数量。 默认值为 2147483647
[选项.offset]number0定义从总报价列表中返回的第一批观众. 与限制结合使用,可以在应用程序中提供页码,供用户浏览一大批出价.
[选项.sort] 由]string定义返回项的排序标准.
[选项.头object传递给 API 呼叫的页眉

目标CoreAPI.createAuditence(机构,[可选 ) QQ Promise.<Response>

创建观众. 按请求内容指定创建新受众并返回新创建的受众定义.

仁爱: 实例方法 TargetCoreAPI
回返数字 : Promise.<Response> - 承诺做出回应

参数类型说明
机构object观众JSON.
[可选objectsdk 选项
[选项.头object传递给 API 呼叫的页眉

目标 CoreAPI.get AudenceById(id,[选项]) QQ Promise.<Response>

找观众. 获取所提供标识指定的受众定义.

仁爱: 实例方法 TargetCoreAPI
回返数字 : Promise.<Response> - 承诺做出回应

参数类型说明
编号number观众ID.
[可选objectsdk 选项
[选项.头object传递给 API 呼叫的页眉

目标CoreAPI.update 观众(id, body, [options]) QQ Promise.<Response>

更新观众. 以请求数据指定的新规则更新受众.

仁爱: 实例方法 TargetCoreAPI
回返数字 : Promise.<Response> - 承诺做出回应

参数类型说明
编号number观众ID.
机构object观众 JSON
[可选objectsdk 选项
[选项.头object传递给 API 呼叫的页眉

目标CoreAPI.deleteAudentence(id,[选项]) QQ Promise.<Response>

删除观众. 删除指定的标识所引用的受众.

仁爱: 实例方法 TargetCoreAPI
回返数字 : Promise.<Response> - 承诺做出回应

参数类型说明
编号number观众ID.
[可选objectsdk 选项
[选项.头object传递给 API 呼叫的页眉

目标CoreAPI.get Properties([选项]) QQ Promise.<Response>

列表属性. 获取属性列表 .

仁爱: 实例方法 TargetCoreAPI
回返数字 : Promise.<Response> - 承诺做出回应

参数类型说明
[可选objectsdk 选项
[选项.头object传递给 API 呼叫的页眉

目标CoreAPI.get PropertyById(id,[可选]) QQ Promise.<Response>

获取财产. 以地产身份收回地产...

仁爱: 实例方法 TargetCoreAPI
回返数字 : Promise.<Response> - 承诺做出回应

参数类型说明
编号number财产编号.
[可选objectsdk 选项
[选项.头object传递给 API 呼叫的页眉

目标CoreAPI.getMBoxes([可选 ) QQ Promise.<Response>

列出 MBoxs . 为特定客户端列出所有可用的 mbox , 包含过滤和排序选项 .

仁爱: 实例方法 TargetCoreAPI
回返数字 : Promise.<Response> - 承诺做出回应

参数类型说明
[可选objectsdk 选项
[选项.头object传递给 API 呼叫的页眉

目标 CoreAPI.getMBoxBy Name (名称, [选项]) Promise.<Response>

叫MBox来. 获取 mbox 参数列表 .

仁爱: 实例方法 TargetCoreAPI
回返数字 : Promise.<Response> - 承诺做出回应

参数类型说明
名称stringMBox名称.
[可选objectsdk 选项
[选项.头object传递给 API 呼叫的页眉

目标CoreAPI.getMBoxProfile 属性([可选 ) QQ Promise.<Response>

获取配置属性 . 获取类型配置的可用配置属性和mbox参数列表.

仁爱: 实例方法 TargetCoreAPI
回返数字 : Promise.<Response> - 承诺做出回应

参数类型说明
[可选objectsdk 选项
[选项.头object传递给 API 呼叫的页眉

coreAPI.get environments([可选 ) Promise.<Response>

获取环境. 列出所有可用的环境, 包括过滤和排序选项 。 使用 Environments API 来获取与客户端设定的各种主机组对应的环境ID.

仁爱: 实例方法 TargetCoreAPI
回返数字 : Promise.<Response> - 承诺做出回应

参数类型说明
[可选objectsdk 选项
[选项.头object传递给 API 呼叫的页眉

目标CoreAPI.getAB 实际操作(id,[可选 ) Promise.<Response>

获得AB活动性能. 由地产Id收回地产.

仁爱: 实例方法 TargetCoreAPI
回返数字 : Promise.<Response> - 承诺做出回应

参数类型说明
编号number活动编号.
[可选objectsdk 选项
[选项.头object传递给 API 呼叫的页眉

目标CoreAPI.getXT activity 性能(id,[可选 ) QQ Promise.<Response>

获得活动性能. 由地产Id收回地产.

仁爱: 实例方法 TargetCoreAPI
回返数字 : Promise.<Response> - 承诺做出回应

参数类型说明
编号number活动编号.
[可选objectsdk 选项
[选项.头object传递给 API 呼叫的页眉

目标CoreAPI.get activityPerformance(id,[选项]) * Promise.<Response>

获得活动性能. 检索所提供编号所参考的自动化个性化活动的执行情况报告数据.

仁爱: 实例方法 TargetCoreAPI
回返数字 : Promise.<Response> - 承诺做出回应

参数类型说明
编号number活动编号.
[可选objectsdk 选项
[选项.头object传递给 API 呼叫的页眉

目标CoreAPI.get Orders Report(id,[options]) QQ Promise.<Response>

得到命令报告. 检索命令/审计报告AB、XT或自动个性化活动的数据.

仁爱: 实例方法 TargetCoreAPI
回返数字 : Promise.<Response> - 承诺做出回应

参数类型说明
编号number活动编号.
[可选objectsdk 选项
[选项.头object传递给 API 呼叫的页眉

目标 CoreAPI. executeBatch(正体) QQ Promise.<Response>

执行 Batch APIs. 多个Admin API可以作为单批请求执行.

仁爱: 实例方法 TargetCoreAPI
回返数字 : Promise.<Response> - 承诺做出回应

参数类型说明
机构object执行批次的json

init( 租户, apiKey, 代号) QQ Promise.<TargetCoreAPI>

返回以新的目标CoreAPI对象解决的保证 .

仁爱:全球职能
回返数字 : Promise.<TargetCoreAPI> - 承诺解决目标CoreAPI事件

参数类型说明
租户string目标租户名
键string键 您的 Api 密钥
符号string有效验证符

除错日志

LOG LEVEL = 调试 < your call here >

捐款

欢迎捐款! 读取 贡献指南 更多信息.

许可证发放

这个项目根据Apache V2许可证获得许可. 见 自由主义 更多信息.

版本与发布记录

@adobe/aio-lib-target 共发布 18 个版本,首次发布于 2019/10/14;过去 12 个月发布了 1 个版本。

版本发布日期距今
4.0.3latest2026/03/317 个月前
4.0.22025/09/041.2 年前
4.0.12024/02/122 年前
4.0.02024/01/112 年前
3.0.3-pre.2024-01-08.sha-ad091911next2024/01/082 年前
3.0.32023/09/083 年前

关于 @adobe/aio-lib-target 的常见问题

@adobe/aio-lib-target 是什么?

Adobe 目标 SDK

如何安装 @adobe/aio-lib-target?

在项目目录运行 npm install @adobe/aio-lib-target,或使用 pnpm add / yarn add / bun add。

@adobe/aio-lib-target 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/adobe__aio-lib-target 是否存在。

@adobe/aio-lib-target 支持 ESM 还是 CommonJS?

以 CommonJS 形式发布,可以直接 require();在 ES Module 项目中也可以用 import 引入(Node.js 会把 module.exports 作为默认导出)。

@adobe/aio-lib-target 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=18。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@adobe/aio-lib-target 可以商用吗?

@adobe/aio-lib-target 使用 未声明 许可。package.json 没有声明许可证。没有许可证的代码默认保留全部权利,商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括,不构成法律意见,请以许可原文为准。

@adobe/aio-lib-target 的下载量有多少?

根据 npm 官方下载统计,@adobe/aio-lib-target 在 2026/10/05 – 2026/11/03 这 30 天内被下载 24,390 次,日均约 813 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@adobe/aio-lib-target 还在维护吗?

最新版本 4.0.3 发布于 2026/03/31(7 个月前);至今共发布 18 个版本,其中过去 12 个月发布了 1 个;首次发布于 2019/10/14。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。