대상 서버 구성 만들기

대상 서버를 만드는 것은 Destination SDK으로 고유한 대상을 만드는 첫 번째 단계입니다. 대상 서버에는 server 및 템플릿 사양, 메시지 포맷및 파일 서식 옵션(파일 기반 대상).

이 페이지는 를 사용하여 고유한 대상 서버를 만드는 데 사용할 수 있는 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

만드는 대상 유형에 따라 약간 다른 유형의 대상 서버를 구성해야 합니다.

정적 스키마 대상 서버 만들기

을 사용하는 대상에 대한 대상 서버의 예는 아래 탭에서 을 참조하십시오. 정적 스키마.

아래의 샘플 페이로드에는 각 대상 서버 유형에서 지원하는 모든 매개 변수가 포함되어 있습니다. 요청에 모든 매개 변수를 포함할 필요는 없습니다. 페이로드는 필요에 따라 사용자 정의할 수 있습니다.

아래의 각 탭을 선택하여 해당 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에서 URL을 `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 표준, 섹션 7. 간단한 변환의 예를 보려면 프로필 속성 변환.
`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를 기반으로 스키마를 생성할 수 있습니다. 스키마를 구성하려면 먼저 동적 스키마에 대한 대상 서버를 구성해야 합니다.

을 사용하는 대상에 대한 대상 서버의 예는 아래 탭에서 을 참조하십시오 동적 스키마.

아래 샘플 페이로드에는 동적 스키마 서버에 필요한 모든 매개 변수가 포함되어 있습니다.

동적 스키마 서버 만들기

고유한 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에서 URL을 `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 표준, 섹션 7. 간단한 변환의 예를 보려면 프로필 속성 변환.

응답

성공한 응답은 새로 만든 대상 서버 구성에 대한 세부 정보와 함께 HTTP 상태 200을 반환합니다.

API 오류 처리

Destination SDK API 엔드포인트는 일반적인 Experience Platform API 오류 메시지 원칙을 따릅니다. 을(를) 참조하십시오 API 상태 코드 및 요청 헤더 오류 플랫폼 문제 해결 안내서에서 확인할 수 있습니다.

다음 단계

이 문서를 읽고 나면 이제 Destination SDK을 통해 새 대상 서버를 만드는 방법을 알 수 있습니다 /authoring/destination-servers API 엔드포인트.

이 끝점으로 수행할 수 있는 작업에 대한 자세한 내용은 다음 문서를 참조하십시오.

이 끝점이 대상 작성 프로세스에 맞는 위치를 이해하려면 다음 문서를 참조하십시오.

대상 서버 구성 만들기

대상 서버 API 작업 시작

대상 서버 구성 만들기

정적 스키마 대상 서버 만들기

동적 스키마 대상 서버 만들기

API 오류 처리

다음 단계

Business.Adobe.com 리소스

이 페이지에서는

다음 보기:

학습

설명서

커뮤니티

지원

리소스

Adobe 계정

Adobe