必读 must-read

Last update: Fri Jul 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：
API

创建对象：

有经验的
开发人员

技术要求

Adobe Campaign API必须仅用于“服务器到服务器”。
如果您要实施的用例与Adobe Campaign API允许的规模一致，请始终与您的Adobe技术联系人核实。
设置AdobeIO访问需要特定权限，如果遇到任何问题，请与Adobe支持部门联系。

权限和访问

默认情况下，Adobe Campaign API使用管理员上下文，因此组织单位和角色不适用。
Adobe Campaign API将从角色上下文中排除。
如果要使用一个或多个组织单位配置API，请与联系以Adobe技术联系人。

资源表示

所有API资源都可在 JSON 中使用，扩展名为URL，或位于HTTP接受标头内：

GET /profileAndServices/<resourceName>.json

NOTE

在URL中没有扩展名，json格式是内容类型的默认格式。

请求样本

-X GET https://mc.adobe.io/<ORGANIZATION>/campaign/profileAndServices/profile.json \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-H 'Cache-Control: no-cache' \
-H 'X-Api-Key: <API_KEY>'

主键和URL

不要尝试自己构建URL。所有URL均由API返回。但是，可以根据顶级资源名称构建URL。
说明示例的自动主键(PKey)值不适用于其他特定部署。它们由Adobe Campaign API生成。
绝不能将Adobe Campaign生成的自动主键值存储到外部数据库或网站中。您必须在数据库定义中生成特定的键字段，并在开发过程中使用它。

自定义密匙 custom-keys

如果用户档案资源已通过自定义键字段扩展，则可以使用此字段作为键，而不是Adobe Campaign生成的自动主键：

GET /.../profileAndServicesExt/profile/<customKey>

如果密钥值与原始密钥不同，或者您将自己的业务密钥用作URI而不是Adobe提供的业务密钥，则无法使用PATCH操作修改自定义密钥。

仅对 顶层配置文件资源 使用自定义键。 URL由API返回，绝不应该自行构建。

示例请求

要使用自定义键检索用户档案的订阅，请对自定义键执行GET操作。

-X GET https://mc.adobe.io/<ORGANIZATION>/campaign/profileAndServicesExt/profile/<customKey> \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-H 'Cache-Control: no-cache' \
-H 'X-Api-Key: <API_KEY>'

对返回的订阅URL执行GET请求。

-X GET <SUBSCRIPTION_URL> \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-H 'Cache-Control: no-cache' \
-H 'X-Api-Key: <API_KEY>'

它会返回用户档案的订阅列表。

"service": {
"PKey": "<PKEY>",
"href": "https://mc.adobe.io/<ORGANIZATION>/campaign/profileAndServices/service/<PKEY>",
"label": "Sport Newsletter",
"name": "SVC1",
"title": "Sport Newsletter (SVC1)"
}

recommendation-more-help

3ef63344-7f3d-48f9-85ed-02bf569c4fff