대상 서버 구성 업데이트

이 페이지는 기존 대상 서버 구성을 업데이트하는 데 사용할 수 있는 API 요청 및 페이로드를 다음과 같이 구현합니다. /authoring/destination-servers API 엔드포인트.

TIP
프로덕션/공용 대상에 대한 모든 업데이트 작업은 를 사용한 후에만 표시됩니다. API 게시 Adobe 검토를 위해 업데이트를 제출합니다.

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

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

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

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

대상 서버 구성 업데이트 update

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

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 문자열

필수 여부.

  • 사용 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, PUT, PUT, DELETE, PATCH.
httpTemplate.requestBody.templatingStrategy 문자열 필수 여부.PEBBLE_V1 사용.
httpTemplate.requestBody.value 문자열

필수 여부. 이 문자열은 Platform 고객의 데이터를 서비스가 기대하는 형식으로 변환하는 문자 이스케이프 처리된 버전입니다.

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