更新目的地伺服器設定

此頁面以範例說明可用於更新現有目的地伺服器設定的API請求和裝載，使用 /authoring/destination-servers api端點。

秘訣

生產/公開目的地上的任何更新操作只有在您使用發佈API 並提交更新以供Adobe檢閱。

如需可透過此端點設定的功能的詳細說明，請參閱以下文章：

重要

Destination SDK支援的所有引數名稱和值如下 區分大小寫. 為避免區分大小寫錯誤，請完全依照檔案中所示使用引數名稱和值。

開始使用目的地伺服器API作業

在繼續之前，請檢閱快速入門手冊如需您成功呼叫API所需的重要資訊，包括如何取得必要的目的地撰寫許可權和必要的標頭。

更新目的地伺服器設定

您可以更新現有目標伺服器組態，透過設定 PUT 要求給 /authoring/destination-servers 具有已更新裝載的端點。

秘訣

API端點： platform.adobe.io/data/core/activation/authoring/destination-servers

若要取得現有的目的地伺服器組態及其對應組態 {INSTANCE_ID}，請參閱「」一文，瞭解擷取目的地伺服器組態.

API格式

PUT /authoring/destination-servers/{INSTANCE_ID}

參數	說明
`{INSTANCE_ID}`	您要更新的目的地伺服器組態ID。若要取得現有的目的地伺服器組態及其對應組態 `{INSTANCE_ID}`，請參閱擷取目的地伺服器設定.

以下要求會更新現有的目的地伺服器設定，此設定由承載中提供的引數所設定。

選取下方的每個索引標籤以檢視對應的裝載。

請求

curl -X PUT https://platform.adobe.io/data/core/activation/authoring/destination-servers\{INSTANCE_ID} \
 -H 'Authorization: Bearer {ACCESS_TOKEN}' \
 -H 'Content-Type: application/json' \
 -H 'x-gw-ims-org-id: {ORG_ID}' \
 -H 'x-api-key: {API_KEY}' \
 -H 'x-sandbox-name: {SANDBOX_NAME}' \
 -d '
{
   "name":"Moviestar destination server",
   "destinationServerType":"URL_BASED",
   "urlBasedDestination":{
      "url":{
         "templatingStrategy":"PEBBLE_V1",
         "value":"https://api.moviestar.com/data/{{customerData.region}}/items"
      }
   },
   "httpTemplate":{
      "httpMethod":"PUT",
      "requestBody":{
         "templatingStrategy":"PEBBLE_V1",
         "value":"{ \"attributes\": [ {% for ns in [\"external_id\", \"yourdestination_id\"] %} {% if input.profile.identityMap[ns] is not empty and first_namespace_encountered %} , {% endif %} {% set first_namespace_encountered = true %} {% for identity in input.profile.identityMap[ns]%} { \"{{ ns }}\": \"{{ identity.id }}\" {% if input.profile.segmentMembership.ups is not empty %} , \"AEPSegments\": { \"add\": [ {% for segment in input.profile.segmentMembership.ups %} {% if segment.value.status == \"realized\" or segment.value.status == \"existing\" %} {% if added_segment_found %} , {% endif %} {% set added_segment_found = true %} \"{{ destination.segmentAliases[segment.key] }}\" {% endif %} {% endfor %} ], \"remove\": [ {% for segment in input.profile.segmentMembership.ups %} {% if segment.value.status == \"exited\" %} {% if removed_segment_found %} , {% endif %} {% set removed_segment_found = true %} \"{{ destination.segmentAliases[segment.key] }}\" {% endif %} {% endfor %} ] } {% set removed_segment_found = false %} {% set added_segment_found = false %} {% endif %} {% if input.profile.attributes is not empty %} , {% endif %} {% for attribute in input.profile.attributes %} \"{{ attribute.key }}\": {% if attribute.value is empty %} null {% else %} \"{{ attribute.value.value }}\" {% endif %} {% if not loop.last%} , {% endif %} {% endfor %} } {% if not loop.last %} , {% endif %} {% endfor %} {% endfor %} ] }"
      },
      "contentType":"application/json"
   }
}

參數	類型	說明
`name`	字串	必要. 代表伺服器的易記名稱，僅對Adobe可見。合作夥伴或客戶看不到此名稱。範例 `Moviestar destination server`.
`destinationServerType`	字串	必要. 將設為 `URL_BASED` 適用於即時（串流）目的地。
`urlBasedDestination.url.templatingStrategy`	字串	必要. 使用 `PEBBLE_V1` 如果Adobe需要轉換 `value` 下方的欄位。如果您有類似以下的端點，請使用此選項： `https://api.moviestar.com/data/{{customerData.region}}/items`. 使用 `NONE` 如果Adobe端不需要轉換，例如，如果您有類似以下的端點： `https://api.moviestar.com/data/items`.
`urlBasedDestination.url.value`	字串	必要. 填寫Experience Platform應連線的API端點位址。
`httpTemplate.httpMethod`	字串	必要. Adobe將在對伺服器呼叫中使用的方法。選項包括 `GET`， `PUT`， `PUT`， `DELETE`， `PATCH`.
`httpTemplate.requestBody.templatingStrategy`	字串	必要. 使用 `PEBBLE_V1`.
`httpTemplate.requestBody.value`	字串	必要. 此字串是字元逸出版本，可將Platform客戶的資料轉換為您的服務預期格式。如需如何寫入範本的詳細資訊，請閱讀使用範本區段. 如需字元逸出的詳細資訊，請參閱 RFC JSON標準，第七節. 如需簡單轉換的範例，請參閱設定檔屬性轉換。
`httpTemplate.contentType`	字串	必要. 您的伺服器接受的內容型別。此值極有可能 `application/json`.

回應