创建目标服务器配置

创建目标服务器是使用Destination SDK创建自己的目标的第一步。目标服务器包括服务器和模板规格，消息格式，以及文件格式选项（适用于基于文件的目标）。

本页举例说明了可用于创建自己的目标服务器的API请求和有效负载，使用 /authoring/destination-servers API端点。

有关可通过此端点配置的功能的详细说明，请阅读以下文章：

重要

Destination SDK支持的所有参数名称和值包括 区分大小写. 为避免区分大小写错误，请完全按照文档中所示使用参数名称和值。

目标服务器API操作快速入门

在继续之前，请查看快速入门指南要成功调用API需要了解的重要信息，包括如何获取所需的目标创作权限和所需的标头。

创建目标服务器配置

您可以通过以下方式创建新的目标服务器配置 POST 请求 /authoring/destination-servers 端点。

小贴士

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

API格式

POST /authoring/destination-servers

根据您创建的目标类型，您需要配置一个稍有不同的目标服务器类型。请参阅以下选项卡中有关Destination SDK支持的每种目标类型的目标服务器示例。

以下负载示例包含每种目标服务器类型支持的所有参数。您无需在请求中包含所有参数。可根据您的需求自定义有效负载。

选择下面的每个选项卡以查看相应的API请求。

创建实时（流）目标服务器

在配置基于实时（流）API的集成时，您需要创建类似于以下所示的实时（流）目标服务器。

请求

curl -X POST https://platform.adobe.io/data/core/activation/authoring/destination-servers \
 -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":"POST",
      "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`，其中 `region` 部分可以因客户而异。在这种情况下，您还需要配置 `region` as a 客户数据字段在 [目标配置] (…/destination-configuration/create-destination-configuration.md. 使用 `NONE` 如果Adobe端不需要转换，例如，如果您具有如下端点： `https://api.moviestar.com/data/items`.
`urlBasedDestination.url.value`	字符串	必需。填写Experience Platform应连接到的API端点的地址。
`httpTemplate.httpMethod`	字符串	必需。 Adobe将在对服务器的调用中使用的方法。选项包括 `GET`， `PUT`， `POST`， `DELETE`， `PATCH`.
`httpTemplate.requestBody.templatingStrategy`	字符串	必需。使用 `PEBBLE_V1`。
`httpTemplate.requestBody.value`	字符串	必需。此字符串是一个字符转义版本，用于将Platform客户的数据转换为您的服务期望的格式。有关如何编写模板的信息，请阅读使用模板部分. 有关字符转义的更多信息，请参阅 RFC JSON标准，第七节. 有关简单转换的示例，请参阅配置文件属性转换。
`httpTemplate.contentType`	字符串	必需。您的服务器接受的内容类型。此值很有可能 `application/json`.

响应

成功的响应会返回HTTP状态200以及新创建的目标服务器配置的详细信息。

创建Amazon S3目标服务器

您需要创建 Amazon S3 目标服务器，类似于配置基于文件的服务器时所显示的服务器 Amazon S3 目标。

请求

curl -X POST https://platform.adobe.io/data/core/activation/authoring/destination-servers \
 -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": "S3 destination",
    "destinationServerType": "FILE_BASED_S3",
    "fileBasedS3Destination": {
        "bucket": {
            "templatingStrategy": "PEBBLE_V1",
            "value": "{{customerData.bucket}}"
        },
        "path": {
            "templatingStrategy": "PEBBLE_V1",
            "value": "{{customerData.path}}"
        }
    },
    "fileConfigurations": {
        "compression": {
            "templatingStrategy": "PEBBLE_V1",
            "value": "{{customerData.compression}}"
        },
        "fileType": {
            "templatingStrategy": "PEBBLE_V1",
            "value": "{{customerData.fileType}}"
        },
        "csvOptions": {
            "quote": {
                "templatingStrategy": "NONE",
                "value": "\""
            },
            "quoteAll": {
                "templatingStrategy": "NONE",
                "value": "false"
            },
            "escape": {
                "templatingStrategy": "NONE",
                "value": "\\"
            },
            "escapeQuotes": {
                "templatingStrategy": "NONE",
                "value": "true"
            },
            "header": {
                "templatingStrategy": "NONE",
                "value": "true"
            },
            "ignoreLeadingWhiteSpace": {
                "templatingStrategy": "NONE",
                "value": "true"
            },
            "ignoreTrailingWhiteSpace": {
                "templatingStrategy": "NONE",
                "value": "true"
            },
            "nullValue": {
                "templatingStrategy": "NONE",
                "value": ""
            },
            "dateFormat": {
                "templatingStrategy": "NONE",
                "value": "yyyy-MM-dd"
            },
            "timestampFormat": {
                "templatingStrategy": "NONE",
                "value": "yyyy-MM-dd'T':mm:ss[.SSS][XXX]"
            },
            "charToEscapeQuoteEscaping": {
                "templatingStrategy": "NONE",
                "value": "\\"
            },
            "emptyValue": {
                "templatingStrategy": "NONE",
                "value": ""
            }
        }
    }
}

参数	类型	描述
`name`	字符串	目标连接的名称。
`destinationServerType`	字符串	根据目标平台设置此值。对象 Amazon S3，将其设置为 `FILE_BASED_S3`.
`fileBasedS3Destination.bucket.templatingStrategy`	字符串	必需。使用 `PEBBLE_V1`。
`fileBasedS3Destination.bucket.value`	字符串	的名称 Amazon S3 要由此目标使用的存储段。
`fileBasedS3Destination.path.templatingStrategy`	字符串	必需。使用 `PEBBLE_V1`。
`fileBasedS3Destination.path.value`	字符串	将托管导出文件的目标文件夹的路径。
`fileConfigurations`	不适用	参见文件格式配置有关如何配置这些设置的详细信息。

响应

成功的响应会返回HTTP状态200以及新创建的目标服务器配置的详细信息。

创建 SFTP 目标服务器

您需要创建 SFTP 目标服务器，类似于配置基于文件的服务器时所显示的服务器 SFTP 目标。

请求

curl -X POST https://platform.adobe.io/data/core/activation/authoring/destination-servers \
 -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":"File-based SFTP destination server",
   "destinationServerType":"FILE_BASED_SFTP",
   "fileBasedSftpDestination":{
      "rootDirectory":{
         "templatingStrategy":"PEBBLE_V1",
         "value":"{{customerData.rootDirectory}}"
      },
      "port": 22,
      "encryptionMode" : "PGP"
   },
    "fileConfigurations": {
        "compression": {
            "templatingStrategy": "PEBBLE_V1",
            "value": "{{customerData.compression}}"
        },
        "fileType": {
            "templatingStrategy": "PEBBLE_V1",
            "value": "{{customerData.fileType}}"
        },
        "csvOptions": {
            "quote": {
                "templatingStrategy": "NONE",
                "value": "\""
            },
            "quoteAll": {
                "templatingStrategy": "NONE",
                "value": "false"
            },
            "escape": {
                "templatingStrategy": "NONE",
                "value": "\\"
            },
            "escapeQuotes": {
                "templatingStrategy": "NONE",
                "value": "true"
            },
            "header": {
                "templatingStrategy": "NONE",
                "value": "true"
            },
            "ignoreLeadingWhiteSpace": {
                "templatingStrategy": "NONE",
                "value": "true"
            },
            "ignoreTrailingWhiteSpace": {
                "templatingStrategy": "NONE",
                "value": "true"
            },
            "nullValue": {
                "templatingStrategy": "NONE",
                "value": ""
            },
            "dateFormat": {
                "templatingStrategy": "NONE",
                "value": "yyyy-MM-dd"
            },
            "timestampFormat": {
                "templatingStrategy": "NONE",
                "value": "yyyy-MM-dd'T':mm:ss[.SSS][XXX]"
            },
            "charToEscapeQuoteEscaping": {
                "templatingStrategy": "NONE",
                "value": "\\"
            },
            "emptyValue": {
                "templatingStrategy": "NONE",
                "value": ""
            }
        }
    }
}

参数	类型	描述
`name`	字符串	目标连接的名称。
`destinationServerType`	字符串	根据目标平台设置此值。对象 SFTP 目标，将其设置为 `FILE_BASED_SFTP`.
`fileBasedSftpDestination.rootDirectory.templatingStrategy`	字符串	必需。使用 `PEBBLE_V1`。
`fileBasedSftpDestination.rootDirectory.value`	字符串	目标存储的根目录。
`fileBasedSftpDestination.hostName.templatingStrategy`	字符串	必需。使用 `PEBBLE_V1`。
`fileBasedSftpDestination.hostName.value`	字符串	目标存储的主机名。
`port`	整数	SFTP文件服务器端口。
`encryptionMode`	字符串	指示是否使用文件加密。支持的值： PGP None
`fileConfigurations`	不适用	参见文件格式配置有关如何配置这些设置的详细信息。

响应

成功的响应会返回HTTP状态200以及新创建的目标服务器配置的详细信息。

创建 Azure Data Lake Storage 目标服务器

您需要创建 Azure Data Lake Storage 目标服务器，类似于配置基于文件的服务器时所显示的服务器 Azure Data Lake Storage 目标。

请求

curl -X POST https://platform.adobe.io/data/core/activation/authoring/destination-servers \
 -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":"ADLS destination server",
   "destinationServerType":"FILE_BASED_ADLS_GEN2",
   "fileBasedAdlsGen2Destination":{
      "path":{
         "templatingStrategy":"PEBBLE_V1",
         "value":"{{customerData.path}}"
      }
   },
  "fileConfigurations": {
        "compression": {
            "templatingStrategy": "PEBBLE_V1",
            "value": "{{customerData.compression}}"
        },
        "fileType": {
            "templatingStrategy": "PEBBLE_V1",
            "value": "{{customerData.fileType}}"
        },
        "csvOptions": {
            "quote": {
                "templatingStrategy": "NONE",
                "value": "\""
            },
            "quoteAll": {
                "templatingStrategy": "NONE",
                "value": "false"
            },
            "escape": {
                "templatingStrategy": "NONE",
                "value": "\\"
            },
            "escapeQuotes": {
                "templatingStrategy": "NONE",
                "value": "true"
            },
            "header": {
                "templatingStrategy": "NONE",
                "value": "true"
            },
            "ignoreLeadingWhiteSpace": {
                "templatingStrategy": "NONE",
                "value": "true"
            },
            "ignoreTrailingWhiteSpace": {
                "templatingStrategy": "NONE",
                "value": "true"
            },
            "nullValue": {
                "templatingStrategy": "NONE",
                "value": ""
            },
            "dateFormat": {
                "templatingStrategy": "NONE",
                "value": "yyyy-MM-dd"
            },
            "timestampFormat": {
                "templatingStrategy": "NONE",
                "value": "yyyy-MM-dd'T':mm:ss[.SSS][XXX]"
            },
            "charToEscapeQuoteEscaping": {
                "templatingStrategy": "NONE",
                "value": "\\"
            },
            "emptyValue": {
                "templatingStrategy": "NONE",
                "value": ""
            }
        }
    }
}

参数	类型	描述
`name`	字符串	目标连接的名称。
`destinationServerType`	字符串	根据目标平台设置此值。对象 Azure Data Lake Storage 目标，将其设置为 `FILE_BASED_ADLS_GEN2`.
`fileBasedAdlsGen2Destination.path.templatingStrategy`	字符串	必需。使用 `PEBBLE_V1`。
`fileBasedAdlsGen2Destination.path.value`	字符串	将托管导出文件的目标文件夹的路径。
`fileConfigurations`	不适用	参见文件格式配置有关如何配置这些设置的详细信息。

响应

成功的响应会返回HTTP状态200以及新创建的目标服务器配置的详细信息。

创建 Azure Blob Storage 目标服务器

您需要创建 Azure Blob Storage 目标服务器，类似于配置基于文件的服务器时所显示的服务器 Azure Blob Storage 目标。

请求

curl -X POST https://platform.adobe.io/data/core/activation/authoring/destination-servers \
 -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":"Blob destination server",
   "destinationServerType":"FILE_BASED_AZURE_BLOB",
   "fileBasedAzureBlobDestination":{
      "path":{
         "templatingStrategy":"PEBBLE_V1",
         "value":"{{customerData.path}}"
      },
      "container":{
         "templatingStrategy":"PEBBLE_V1",
         "value":"{{customerData.container}}"
      }
   },
  "fileConfigurations": {
        "compression": {
            "templatingStrategy": "PEBBLE_V1",
            "value": "{{customerData.compression}}"
        },
        "fileType": {
            "templatingStrategy": "PEBBLE_V1",
            "value": "{{customerData.fileType}}"
        },
        "csvOptions": {
            "quote": {
                "templatingStrategy": "NONE",
                "value": "\""
            },
            "quoteAll": {
                "templatingStrategy": "NONE",
                "value": "false"
            },
            "escape": {
                "templatingStrategy": "NONE",
                "value": "\\"
            },
            "escapeQuotes": {
                "templatingStrategy": "NONE",
                "value": "true"
            },
            "header": {
                "templatingStrategy": "NONE",
                "value": "true"
            },
            "ignoreLeadingWhiteSpace": {
                "templatingStrategy": "NONE",
                "value": "true"
            },
            "ignoreTrailingWhiteSpace": {
                "templatingStrategy": "NONE",
                "value": "true"
            },
            "nullValue": {
                "templatingStrategy": "NONE",
                "value": ""
            },
            "dateFormat": {
                "templatingStrategy": "NONE",
                "value": "yyyy-MM-dd"
            },
            "timestampFormat": {
                "templatingStrategy": "NONE",
                "value": "yyyy-MM-dd'T':mm:ss[.SSS][XXX]"
            },
            "charToEscapeQuoteEscaping": {
                "templatingStrategy": "NONE",
                "value": "\\"
            },
            "emptyValue": {
                "templatingStrategy": "NONE",
                "value": ""
            }
        }
    }
}

参数	类型	描述
`name`	字符串	目标连接的名称。
`destinationServerType`	字符串	根据目标平台设置此值。对象 Azure Blob Storage 目标，将其设置为 `FILE_BASED_AZURE_BLOB`.
`fileBasedAzureBlobDestination.path.templatingStrategy`	字符串	必需。使用 `PEBBLE_V1`。
`fileBasedAzureBlobDestination.path.value`	字符串	将托管导出文件的目标文件夹的路径。
`fileBasedAzureBlobDestination.container.templatingStrategy`	字符串	必需。使用 `PEBBLE_V1`。
`fileBasedAzureBlobDestination.container.value`	字符串	的名称 Azure Blob Storage 此目标使用的容器。
`fileConfigurations`	不适用	参见文件格式配置有关如何配置这些设置的详细信息。

响应

成功的响应会返回HTTP状态200以及新创建的目标服务器配置的详细信息。

创建 Data Landing Zone (DLZ) 目标服务器

您需要创建 Data Landing Zone (DLZ) 目标服务器，类似于配置基于文件的服务器时所显示的服务器 Data Landing Zone (DLZ) 目标。

请求

curl -X POST https://platform.adobe.io/data/core/activation/authoring/destination-servers \
 -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":"DLZ destination server",
   "destinationServerType":"FILE_BASED_DLZ",
   "fileBasedDlzDestination":{
      "path":{
         "templatingStrategy":"PEBBLE_V1",
         "value":"{{customerData.path}}"
      },
      "useCase": "Your use case"
   },
   "fileConfigurations": {
        "compression": {
            "templatingStrategy": "PEBBLE_V1",
            "value": "{{customerData.compression}}"
        },
        "fileType": {
            "templatingStrategy": "PEBBLE_V1",
            "value": "{{customerData.fileType}}"
        },
        "csvOptions": {
            "quote": {
                "templatingStrategy": "NONE",
                "value": "\""
            },
            "quoteAll": {
                "templatingStrategy": "NONE",
                "value": "false"
            },
            "escape": {
                "templatingStrategy": "NONE",
                "value": "\\"
            },
            "escapeQuotes": {
                "templatingStrategy": "NONE",
                "value": "true"
            },
            "header": {
                "templatingStrategy": "NONE",
                "value": "true"
            },
            "ignoreLeadingWhiteSpace": {
                "templatingStrategy": "NONE",
                "value": "true"
            },
            "ignoreTrailingWhiteSpace": {
                "templatingStrategy": "NONE",
                "value": "true"
            },
            "nullValue": {
                "templatingStrategy": "NONE",
                "value": ""
            },
            "dateFormat": {
                "templatingStrategy": "NONE",
                "value": "yyyy-MM-dd"
            },
            "timestampFormat": {
                "templatingStrategy": "NONE",
                "value": "yyyy-MM-dd'T':mm:ss[.SSS][XXX]"
            },
            "charToEscapeQuoteEscaping": {
                "templatingStrategy": "NONE",
                "value": "\\"
            },
            "emptyValue": {
                "templatingStrategy": "NONE",
                "value": ""
            }
        }
    }
}

参数	类型	描述
`name`	字符串	目标连接的名称。
`destinationServerType`	字符串	根据目标平台设置此值。对象 Data Landing Zone 目标，将其设置为 `FILE_BASED_DLZ`.
`fileBasedDlzDestination.path.templatingStrategy`	字符串	必需。使用 `PEBBLE_V1`。
`fileBasedDlzDestination.path.value`	字符串	将托管导出文件的目标文件夹的路径。
`fileConfigurations`	不适用	参见文件格式配置有关如何配置这些设置的详细信息。

响应

成功的响应会返回HTTP状态200以及新创建的目标服务器配置的详细信息。

创建 Google Cloud Storage 目标服务器

您需要创建 Google Cloud Storage 目标服务器，类似于配置基于文件的服务器时所显示的服务器 Google Cloud Storage 目标。

请求

curl -X POST https://platform.adobe.io/data/core/activation/authoring/destination-servers \
 -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":"Google Cloud Storage Server",
   "destinationServerType":"FILE_BASED_GOOGLE_CLOUD",
   "fileBasedGoogleCloudStorageDestination":{
      "bucket":{
         "templatingStrategy":"PEBBLE_V1",
         "value":"{{customerData.bucket}}"
      },
      "path":{
         "templatingStrategy":"PEBBLE_V1",
         "value":"{{customerData.path}}"
      }
   },
  "fileConfigurations": {
        "compression": {
            "templatingStrategy": "PEBBLE_V1",
            "value": "{{customerData.compression}}"
        },
        "fileType": {
            "templatingStrategy": "PEBBLE_V1",
            "value": "{{customerData.fileType}}"
        },
        "csvOptions": {
            "quote": {
                "templatingStrategy": "NONE",
                "value": "\""
            },
            "quoteAll": {
                "templatingStrategy": "NONE",
                "value": "false"
            },
            "escape": {
                "templatingStrategy": "NONE",
                "value": "\\"
            },
            "escapeQuotes": {
                "templatingStrategy": "NONE",
                "value": "true"
            },
            "header": {
                "templatingStrategy": "NONE",
                "value": "true"
            },
            "ignoreLeadingWhiteSpace": {
                "templatingStrategy": "NONE",
                "value": "true"
            },
            "ignoreTrailingWhiteSpace": {
                "templatingStrategy": "NONE",
                "value": "true"
            },
            "nullValue": {
                "templatingStrategy": "NONE",
                "value": ""
            },
            "dateFormat": {
                "templatingStrategy": "NONE",
                "value": "yyyy-MM-dd"
            },
            "timestampFormat": {
                "templatingStrategy": "NONE",
                "value": "yyyy-MM-dd'T':mm:ss[.SSS][XXX]"
            },
            "charToEscapeQuoteEscaping": {
                "templatingStrategy": "NONE",
                "value": "\\"
            },
            "emptyValue": {
                "templatingStrategy": "NONE",
                "value": ""
            }
        }
    }
}

参数	类型	描述
`name`	字符串	目标连接的名称。
`destinationServerType`	字符串	根据目标平台设置此值。对象 Google Cloud Storage 目标，将其设置为 `FILE_BASED_GOOGLE_CLOUD`.
`fileBasedGoogleCloudStorageDestination.bucket.templatingStrategy`	字符串	必需。使用 `PEBBLE_V1`。
`fileBasedGoogleCloudStorageDestination.bucket.value`	字符串	的名称 Google Cloud Storage 要由此目标使用的存储段。
`fileBasedGoogleCloudStorageDestination.path.templatingStrategy`	字符串	必需。使用 `PEBBLE_V1`。
`fileBasedGoogleCloudStorageDestination.path.value`	字符串	将托管导出文件的目标文件夹的路径。
`fileConfigurations`	不适用	参见文件格式配置有关如何配置这些设置的详细信息。

响应

成功的响应会返回HTTP状态200以及新创建的目标服务器配置的详细信息。

创建动态架构服务器

在配置从您自己的API端点检索其配置文件架构的目标时，您需要创建类似于以下所示的动态架构服务器。与静态架构相反，动态架构不使用 profileFields 数组。相反，动态架构使用动态架构服务器，该服务器连接到您自己的API，并从其中检索架构配置。

请求

curl -X POST https://platform.adobe.io/data/core/activation/authoring/destination-servers \
 -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":"Dynamic Schema Server",
   "destinationServerType":"URL_BASED",
   "urlBasedDestination":{
      "url":{
         "templatingStrategy":"PEBBLE_V1",
         "value":"https://YOUR_API_ENDPOINT/"
      }
   },
   "httpTemplate":{
      "httpMethod":"GET"
   },
   "responseFields":[
      {
         "templatingStrategy":"PEBBLE_V1",
         "value":"{\n    \"type\":\"object\",\n    \"title\": \"Contact Schema\",\n    \"properties\": {\n        {% for setDefinition in response.body.items %}\n            \"{{setDefinition.key}}\": {\n                \"title\" : \"{{setDefinition.name.value}}\",\n                \"type\" : \"object\",\n                \"properties\": {\n                    {% for attribute in setDefinition.attributes %}\n                        \"{{attribute.key}}\": {\n                            \"title\" : \"{{attribute.name.value}}\",\n                            \"type\" : \"string\"\n                        }\n                        {% if not loop.last %},{%endif%}\n                    {% endfor %}\n                }\n            }\n            {% if not loop.last %},{%endif%}\n        {% endfor %}\n    }\n}",
         "name":"schema"
      }
   ]
}

参数	类型	描述
`name`	字符串	必需。表示您的动态架构服务器的友好名称，仅对Adobe可见。
`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`.
`responseFields.templatingStrategy`	字符串	必需。使用 `PEBBLE_V1`。
`responseFields.value`	字符串	必需。此字符串是一个字符转义转换模板，它将从合作伙伴API收到的响应转换为将在Platform UI中显示的合作伙伴架构。有关如何编写模板的信息，请阅读使用模板部分. 有关字符转义的更多信息，请参阅 RFC JSON标准，第七节. 有关简单转换的示例，请参阅配置文件属性转换。

响应

成功的响应会返回HTTP状态200以及新创建的目标服务器配置的详细信息。

API错误处理

Destination SDKAPI端点遵循常规Experience PlatformAPI错误消息原则。请参阅 API状态代码和请求标头错误平台疑难解答指南中的。

后续步骤

阅读本文档后，您现在知道如何通过Destination SDK创建新的目标服务器 /authoring/destination-servers API端点。

要了解有关可使用此端点执行的操作的更多信息，请参阅以下文章：

要了解此端点在目标创作过程中的适用位置，请参阅以下文章：

创建目标服务器配置

目标服务器API操作快速入门

创建目标服务器配置

API错误处理

后续步骤

Business.Adobe.com 资源

在此页面上

查看下一个：

学习

文档

社区

技术支持

资源

Adobe 帐户

Adobe