흐름 서비스 API를 사용하여 대상 계정 삭제
Destinations 는 Adobe Experience Platform에서 데이터를 원활하게 활성화할 수 있도록 대상 플랫폼과의 사전 빌드된 통합입니다. 대상을 사용하여 크로스 채널 마케팅 캠페인, 이메일 캠페인, 타겟팅 광고 및 기타 다양한 사용 사례에 대해 알려진 데이터와 알 수 없는 데이터를 활성화할 수 있습니다.
데이터를 활성화하기 전에 먼저 대상 계정을 설정하여 대상에 연결해야 합니다. 이 자습서에서는 를 사용하여 더 이상 필요하지 않은 대상 계정을 삭제하는 단계를 설명합니다. Flow Service API.
시작하기 get-started
이 자습서에서는 유효한 연결 ID가 있어야 합니다. 연결 ID는 대상에 대한 계정 연결을 나타냅니다. 유효한 연결 ID가 없는 경우 대상 카탈로그 다음에 설명된 단계를 수행합니다. 대상에 연결 이 자습서를 시도하기 전에.
또한 이 자습서에서는 Adobe Experience Platform의 다음 구성 요소를 이해하고 있어야 합니다.
다음 섹션에서는 를 사용하여 대상 계정을 성공적으로 삭제하기 위해 알아야 하는 추가 정보를 제공합니다. Flow Service API.
샘플 API 호출 읽기 reading-sample-api-calls
이 튜토리얼에서는 요청 형식을 지정하는 방법을 보여 주는 예제 API 호출을 제공합니다. 여기에는 경로, 필수 헤더 및 적절한 포맷의 요청 페이로드가 포함됩니다. API 응답에서 반환되는 샘플 JSON도 제공됩니다. 샘플 API 호출에 대한 설명서에 사용되는 규칙에 대한 자세한 내용은 의 섹션을 참조하십시오. 예제 API 호출을 읽는 방법 다음에서 Experience Platform 문제 해결 가이드.
필수 헤더에 대한 값 수집 gather-values-for-required-headers
을 호출하기 위해 Platform API, 먼저 다음을 완료해야 합니다. 인증 자습서. 인증 자습서를 완료하면 모든 항목에서 필요한 각 헤더에 대한 값이 제공됩니다 Experience Platform 아래와 같이 API 호출:
Authorization: Bearer {ACCESS_TOKEN}
x-api-key: {API_KEY}
x-gw-ims-org-id: {ORG_ID}
의 모든 리소스 Experience Platform, 다음에 속하는 항목 포함 Flow Service는 특정 가상 샌드박스로 분리됩니다. 에 대한 모든 요청 Platform API에는 작업이 수행될 샌드박스의 이름을 지정하는 헤더가 필요합니다.
x-sandbox-name: {SANDBOX_NAME}
x-sandbox-name
헤더가 지정되지 않았습니다. 요청은에서 확인됩니다. prod
샌드박스.페이로드(POST, PUT, PATCH)가 포함된 모든 요청에는 추가 미디어 유형 헤더가 필요합니다.
Content-Type: application/json
삭제하려는 대상 계정의 연결 ID를 찾습니다 find-connection-id
대상 계정을 삭제하는 첫 번째 단계는 삭제하려는 대상 계정에 해당하는 연결 ID를 찾는 것입니다.
Experience Platform UI에서 다음을 찾아봅니다. 대상 > 계정 에서 숫자를 선택하여 삭제할 계정을 선택합니다. 대상 열.
다음으로 브라우저의 URL에서 대상 계정의 연결 ID를 검색할 수 있습니다.
연결 삭제 delete-connection
기존 데이터 흐름을 삭제하려면 아래 페이지를 참조하십시오.
- Experience Platform UI 사용 기존 데이터 흐름을 삭제하려면
- 흐름 서비스 API 사용 기존 데이터 흐름을 삭제합니다.
DELETE 연결 ID가 있고 대상 계정에 대한 데이터 흐름이 없는지 확인했으면 Flow Service API.
API 형식
DELETE /connections/{CONNECTION_ID}
{CONNECTION_ID}
id
삭제할 연결의 값입니다.요청
curl -X DELETE \
'https://platform.adobe.io/data/foundation/flowservice/connections/c8622ec7-7d94-44a5-a35a-ffcc6bdcc384' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}'
응답
성공적인 응답은 HTTP 상태 204(콘텐츠 없음) 및 빈 본문을 반환합니다. 연결에 대한 조회(GET) 요청을 시도하여 삭제를 확인할 수 있습니다. API가 대상 계정이 삭제되었음을 나타내는 HTTP 404(찾을 수 없음) 오류를 반환합니다.
API 오류 처리 api-error-handling
이 자습서의 API 끝점은 일반적인 Experience Platform API 오류 메시지 원칙을 따릅니다. 을(를) 참조하십시오 API 상태 코드 및 요청 헤더 오류 플랫폼 문제 해결 안내서에서 확인할 수 있습니다.
다음 단계
이 자습서에 따라 Flow Service 기존 대상 계정을 삭제하는 API입니다. 대상 사용에 대한 자세한 내용은 대상 개요.