설명서Experience Platform대상 안내서

대상 서버 구성 업데이트

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

  • 관리자
  • 사용자

이 페이지에서는 /authoring/destination-servers API 끝점을 사용하여 기존 대상 서버 구성을 업데이트하는 데 사용할 수 있는 API 요청 및 페이로드를 구현합니다.

TIP
제품화된/공개 대상에 대한 모든 업데이트 작업은 게시 API를 사용하고 Adobe 검토를 위해 업데이트를 제출한 후에만 표시됩니다.

이 끝점을 통해 구성할 수 있는 기능에 대한 자세한 설명은 다음 문서를 참조하십시오.

IMPORTANT
Destination SDK에서 지원하는 모든 매개 변수 이름과 값은 대/소문자를 구분합니다. 대소문자 구분 오류를 방지하려면 설명서에 표시된 대로 매개 변수 이름과 값을 정확히 사용하십시오.

대상 서버 API 작업 시작 get-started

계속하기 전에 시작 안내서에서 필요한 대상 작성 권한 및 필수 헤더를 얻는 방법을 포함하여 API를 성공적으로 호출하기 위해 알아야 하는 중요한 정보를 검토하십시오.

대상 서버 구성 업데이트 update

업데이트된 페이로드로 /authoring/destination-servers 끝점에 대한 PUT 요청을 수행하여 기존 대상 서버 구성을 업데이트할 수 있습니다.

TIP
API 끝점: platform.adobe.io/data/core/activation/authoring/destination-servers

기존 대상 서버 구성 및 해당 {INSTANCE_ID}을(를) 가져오려면 대상 서버 구성 검색에 대한 문서를 참조하십시오.

API 형식

PUT /authoring/destination-servers/{INSTANCE_ID}
매개변수
설명
{INSTANCE_ID}
업데이트할 대상 서버 구성의 ID입니다. 기존 대상 서버 구성과 해당 {INSTANCE_ID}을(를) 가져오려면 대상 서버 구성 검색을 참조하십시오.

다음 요청은 페이로드에 제공된 매개 변수로 구성된 기존 대상 서버 구성을 업데이트합니다.

아래에서 각 탭을 선택하여 해당 페이로드를 확인합니다.

실시간(스트리밍)
accordion
요청
code language-shell 
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"
   }
}
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 8-row-3 layout-auto
매개변수 유형 설명
name 문자열 필수. Adobe에 대해서만 표시되는 서버의 이름을 나타냅니다. 이 이름은 파트너나 고객에게 표시되지 않습니다. 예 Moviestar destination server.
destinationServerType 문자열 필수.실시간(스트리밍) 대상에 대해 ​을(를) URL_BASED(으)로 설정합니다.
urlBasedDestination.url.templatingStrategy 문자열

필수.

  • Adobe이 아래 value 필드의 URL을 변환해야 하는 경우 PEBBLE_V1을(를) 사용합니다. https://api.moviestar.com/data/{{customerData.region}}/items과(와) 같은 끝점이 있는 경우 이 옵션을 사용합니다.
  • Adobe 측에서 변환이 필요하지 않은 경우(예: https://api.moviestar.com/data/items 같은 끝점이 있는 경우) NONE을(를) 사용하십시오.
urlBasedDestination.url.value 문자열 필수. Experience Platform이 연결해야 하는 API 끝점의 주소를 입력합니다.
httpTemplate.httpMethod 문자열 필수. Adobe이 서버 호출에 사용할 메서드입니다. 옵션은 GET, PUT, PUT, DELETE, PATCH입니다.
httpTemplate.requestBody.templatingStrategy 문자열 필수. PEBBLE_V1 사용.
httpTemplate.requestBody.value 문자열

필수. 이 문자열은 플랫폼 고객의 데이터를 서비스에 필요한 형식으로 변환하는 문자 이스케이프 처리된 버전입니다.
httpTemplate.contentType 문자열 필수. 서버가 허용하는 콘텐츠 형식입니다. 이 값은 application/json일 수 있습니다.
accordion
응답
성공한 응답은 업데이트된 대상 서버 구성의 세부 정보와 함께 HTTP 상태 200을 반환합니다.
Amazon S3
accordion
요청
code language-shell 
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": "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": ""
            }
        }
    }
}
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 layout-auto
매개변수 유형 설명
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 N/A 이러한 설정을 구성하는 방법에 대한 자세한 내용은 파일 서식 구성을 참조하십시오.
accordion
응답
성공한 응답은 업데이트된 대상 서버 구성의 세부 정보와 함께 HTTP 상태 200을 반환합니다.
SFTP
accordion
요청
code language-shell 
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":"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": ""
            }
        }
    }
}
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 8-row-3 9-row-3 layout-auto
매개변수 유형 설명
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 N/A 이러한 설정을 구성하는 방법에 대한 자세한 내용은 파일 서식 구성을 참조하십시오.
accordion
응답
성공한 응답은 업데이트된 대상 서버 구성의 세부 정보와 함께 HTTP 상태 200을 반환합니다.
Azure 데이터 레이크 저장소
accordion
요청
code language-shell 
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":"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": ""
            }
        }
    }
}
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 layout-auto
매개변수 유형 설명
name 문자열 대상 연결의 이름입니다.
destinationServerType 문자열 대상 플랫폼에 따라 이 값을 설정하십시오. Azure Data Lake Storage 대상의 경우 FILE_BASED_ADLS_GEN2(으)로 설정하십시오.
fileBasedAdlsGen2Destination.path.templatingStrategy 문자열 필수. PEBBLE_V1 사용.
fileBasedAdlsGen2Destination.path.value 문자열 내보낸 파일을 호스팅할 대상 폴더의 경로입니다.
fileConfigurations N/A 이러한 설정을 구성하는 방법에 대한 자세한 내용은 파일 서식 구성을 참조하십시오.
accordion
응답
성공한 응답은 업데이트된 대상 서버 구성의 세부 정보와 함께 HTTP 상태 200을 반환합니다.
Azure Blob 저장소
accordion
요청
code language-shell 
curl -X PUT https://platform.adobe.io/data/core/activation/authoring/destination-servers/{INSTANCE_D} \
 -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": ""
            }
        }
    }
}
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 layout-auto
매개변수 유형 설명
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 N/A 이러한 설정을 구성하는 방법에 대한 자세한 내용은 파일 서식 구성을 참조하십시오.
accordion
응답
성공한 응답은 업데이트된 대상 서버 구성의 세부 정보와 함께 HTTP 상태 200을 반환합니다.
DLZ(데이터 랜딩 영역)
accordion
요청
code language-shell 
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":"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": ""
            }
        }
    }
}
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 layout-auto
매개변수 유형 설명
name 문자열 대상 연결의 이름입니다.
destinationServerType 문자열 대상 플랫폼에 따라 이 값을 설정하십시오. Data Landing Zone 대상의 경우 FILE_BASED_DLZ(으)로 설정하십시오.
fileBasedDlzDestination.path.templatingStrategy 문자열 필수. PEBBLE_V1 사용.
fileBasedDlzDestination.path.value 문자열 내보낸 파일을 호스팅할 대상 폴더의 경로입니다.
fileConfigurations N/A 이러한 설정을 구성하는 방법에 대한 자세한 내용은 파일 서식 구성을 참조하십시오.
accordion
응답
성공한 응답은 업데이트된 대상 서버 구성의 세부 정보와 함께 HTTP 상태 200을 반환합니다.
Google 클라우드 저장소
accordion
요청
code language-shell 
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":"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": ""
            }
        }
    }
}
table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 layout-auto
매개변수 유형 설명
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 N/A 이러한 설정을 구성하는 방법에 대한 자세한 내용은 파일 서식 구성을 참조하십시오.
accordion
응답
성공한 응답은 업데이트된 대상 서버 구성의 세부 정보와 함께 HTTP 상태 200을 반환합니다.

API 오류 처리 error-handling

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

다음 단계 next-steps

이 문서를 읽은 후에는 Destination SDK /authoring/destination-servers API 끝점을 통해 대상 서버 구성을 업데이트하는 방법을 배웁니다.

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

recommendation-more-help
7f4d1967-bf93-4dba-9789-bb6b505339d6