Must-Read

技術需求

• Adobe CampaignAPI僅能用於伺服器到伺服器。
• 請務必洽詢您的Adobe技術聯絡人，確認您要實作的使用案例是否符合Adobe CampaignAPI所允許的比例。
• 設定AdobeIO存取權需要特定權限，如有任何問題，請聯絡Adobe支援。

權限與存取

• 預設情況下，Adobe CampaignAPI使用管理員上下文，因此組織單位和角色不適用。
• Adobe CampaignAPI被排除在角色上下文之外。
• 如果您想要設定具有組織單位或角色的API，請先洽詢您的Adobe技術聯絡人。

資源表示法

所有API資源都可在​JSON​中使用，其URL副檔名或在HTTP接受標題中：

GET /profileAndServices/<resourceName>.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。 API會傳回所有URL。 不過，您仍可以根據頂層資源名稱來建立URL。

• 說明示例的自動主鍵(PKey)值不打算用於其他特定部署。 由Adobe CampaignAPI製作。

• Adobe Campaign生成的自動主鍵值絕對不能儲存到外部資料庫或網站中。 您必須在資料庫定義中生成特定的鍵欄位，並在開發過程中使用它。

自訂金鑰

如果配置檔案資源已擴展自定義密鑰欄位，則可以將此欄位用作密鑰，而不是由Adobe Campaign生成的自動主密鑰：

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

如果鍵值與原始鍵不同，或者您使用自己的業務鍵作為URI，而非PATCH提供的業務鍵，則無法使用Adobe操作修改自定義鍵。

僅對​頂層配置檔案資源​使用自定義鍵。 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)"
}