기본 연결은 소스와 Adobe Experience Platform 간의 인증된 연결을 나타냅니다.
이 자습서에서는 기본 연결을 만드는 단계를 안내합니다. Oracle Eloqua 사용 Flow Service API.
이 안내서를 사용하려면 다음 Platform 구성 요소에 대한 작업 이해가 필요합니다.
다음 섹션에서는 에 성공적으로 연결하기 위해 알아야 하는 추가 정보를 제공합니다 Oracle Eloqua 사용 Flow Service API.
주문 Flow Service 연결 대상 Oracle Eloqua, 다음 연결 속성에 대한 값을 제공해야 합니다.
자격 증명 | 설명 |
---|---|
endpoint |
의 엔드포인트 Oracle Eloqua. |
username |
의 사용자 이름 Oracle Eloqua 계정입니다. 사용자 이름은 다음 형식으로 지정해야 합니다. siteName + \\ + username , 여기서 siteName 은(는) 로그인할 때 사용한 회사 이름입니다 Oracle Eloqua 및 username 은 사용자 이름입니다. 예를 들어 로그인 사용자 이름은 다음과 같을 수 있습니다. adobe\\emily . |
password |
다음에 해당하는 암호 Oracle Eloqua 사용자 이름. |
connectionSpec.id |
연결 사양은 기본 및 소스 연결 만들기와 관련된 인증 사양을 포함하여 소스의 커넥터 속성을 반환합니다. 의 연결 사양 ID 값 Oracle Eloqua 소스는 다음과 같이 수정됩니다. 35d6c4d8-c9a9-11eb-b8bc-0242ac130003 . |
의 인증 자격 증명에 대한 자세한 정보 Oracle Eloqua, 다음을 참조하십시오. Oracle Eloqua 인증 안내서.
Platform API를 성공적으로 호출하는 방법에 대한 자세한 내용은 의 안내서를 참조하십시오. platform API 시작하기.
기본 연결은 소스의 인증 자격 증명, 연결의 현재 상태 및 고유한 기본 연결 ID를 포함하여 소스와 플랫폼 간에 정보를 유지합니다. 기본 연결 ID를 사용하면 소스 내에서 파일을 탐색 및 탐색하고 데이터 유형 및 형식에 대한 정보를 포함하여 수집할 특정 항목을 식별할 수 있습니다.
POST 기본 연결 ID를 만들려면 /connections
을(를) 제공하는 동안 엔드포인트 Oracle Eloqua 요청 매개 변수의 일부로 인증 자격 증명을 사용합니다.
API 형식
POST /connections
요청
다음 요청은에 대한 기본 연결을 만듭니다. Oracle Eloqua:
curl -X POST \
'https://platform.adobe.io/data/foundation/flowservice/connections' \
-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}' \
-H 'Content-Type: application/json'
-d '{
"name": "Oracle Eloqua Base Connection",
"description": "Base Connection for Oracle Eloqua",
"auth": {
"specName": "Basic Authentication",
"params": {
"endpoint": "{ENDPOINT}",
"username": "{USERNAME}",
"password": "{PASSWORD}"
}
},
"connectionSpec": {
"id": "35d6c4d8-c9a9-11eb-b8bc-0242ac130003",
"version": "1.0"
}
}'
매개변수 | 설명 |
---|---|
name |
의 이름 Oracle Eloqua 기본 연결. 이 값을 사용하여 기본 연결을 조회할 수 있으므로 수사적 이름을 제공하는 것이 좋습니다. |
description |
(선택 사항) 기본 연결에 대한 추가 정보를 제공하기 위해 포함할 수 있는 속성입니다. |
auth.specName |
연결에 사용되는 인증 유형입니다. |
auth.params.endpoint |
의 엔드포인트 Oracle Eloqua 서버입니다. |
auth.params.username |
에 해당되는 사이트 이름 및 사용자 이름을 포함하는 연결된 자격 증명 Oracle Eloqua 계정입니다. |
auth.params.password |
에 해당하는 암호 Oracle Eloqua 계정입니다. |
connectionSpec.id |
의 연결 사양 ID 값 Oracle Eloqua 소스는 다음과 같이 수정됩니다. 35d6c4d8-c9a9-11eb-b8bc-0242ac130003 . |
응답
성공한 응답은 고유 식별자를 포함하여 새로 생성된 기본 연결의 세부 정보를 반환합니다(id
). 다음 단계에서 소스 연결을 만들려면 이 ID가 필요합니다.
{
"id": "2484f2df-c057-4ab5-84f2-dfc0577ab592",
"etag": "\"10033e77-0000-0200-0000-5e96785b0000\""
}
이 자습서를 따라 Oracle Eloqua 를 사용한 기본 연결 Flow Service API. 다음 자습서에서 이 기본 연결 ID를 사용할 수 있습니다.