설명서 Experience Platform Privacy Service 안내서

컨텐츠 엔드포인트

마지막 업데이트: 2025년 1월 27일

주제:

작성 대상:

개발자

/content 끝점을 사용하여 고객에 대한 액세스 정보(개인 정보 보호 주체가 올바르게 액세스를 요청할 수 있는 정보)를 안전하게 검색할 수 있습니다. /jobs/{JOB_ID} GET 요청에 대한 응답에 제공된 다운로드 URL이 Adobe 서비스 끝점을 가리킵니다. 그런 다음 /jobs/:JOB_ID/content에 GET 요청을 하여 고객 데이터를 JSON 형식으로 반환할 수 있습니다. 이 액세스 방법은 보안을 강화하기 위해 인증 및 액세스 제어의 여러 계층을 구현합니다.

이 안내서를 사용하기 전에 아래 예제 API 호출에 제공된 필수 인증 헤더에 대한 정보는 시작 안내서를 참조하십시오.

TIP

필요한 액세스 정보에 대한 작업 ID를 현재 모를 경우 /jobs 끝점을 호출하고 추가 쿼리 매개 변수를 사용하여 결과를 필터링합니다. 사용 가능한 쿼리 매개 변수의 전체 목록은 개인 정보 작업 끝점 안내서에서 찾을 수 있습니다.

개인 정보 작업 정보 검색

현재 처리 상태와 같은 특정 작업에 대한 정보를 검색하려면 /jobs 끝점에 대한 GET 요청의 경로에 해당 작업의 jobId을(를) 포함하십시오.

API 형식

GET /jobs/{JOB_ID}

요청

다음 요청은 jobId이(가) 요청 경로에 제공된 작업의 세부 정보를 검색합니다.

curl -X GET \
  https://platform.adobe.io/data/core/privacy/jobs/dbe3a6a6-f8e6-11ee-a365-8d1d6df81cc5 \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}'

응답

성공한 응답은 지정된 작업의 세부 정보를 반환합니다.

NOTE

개인 정보 작업은 downloadUrl을(를) 포함하려면 complete 상태여야 합니다.

{
    "jobId":"dbe3a6a6-f8e6-11ee-a365-8d1d6df81cc5",
    "requestId":"17129380910360540RX-753",
    "userKey":"1234",
    "action":"access",
    "status":"complete",
    "submittedBy":"jsnow@adobe.com",
    "createdDate":"04/12/2024 04:08 PM GMT",
    "lastModifiedDate":"04/12/2024 04:08 PM GMT",
    "userIds":[{
        "namespace":"ECID",
        "value":"1234",
        "type":"standard",
        "namespaceId":4,
        "isDeletedClientSide":false
        }],
    "productResponses":[{
        "product":"Identity",
        "retryCount":0,
        "processedDate":"04/12/2024 04:08 PM GMT",
        "productStatusResponse":{"status":"submitted"
        }}],
    "downloadUrl":"https://platform.adobe.io/data/core/privacy/jobs/dbe3a6a6-f8e6-11ee-a365-8d1d6df81cc5/content",
    "regulation":"gdpr"
}

속성

설명

jobId

개인 정보 작업에 대한 고유 식별자.

requestId

Privacy Service에 수행된 특정 요청에 대한 고유 식별자.

userKey

userKey은(는) 개인 정보 보호 요청을 제출할 때 제공한 key 값입니다. key 값은 데이터 주체에 적합한 식별자를 제공할 수 있는 기회입니다. 일반적으로 시스템은 해당 데이터 주체를 추적하기 위해 만든 고유 식별자입니다. 팁: 모든 활성 개인 정보 작업을 나열하고 key을(를) 각 작업과 비교할 수 있습니다.

action

요청한 작업 유형입니다. 허용되는 값은 access 및 delete입니다.

status

개인 정보 작업의 현재 상태입니다.

submittedBy

개인 정보 보호 작업을 제출한 사람의 이메일 주소입니다.

createdDate

개인 정보 작업을 만든 날짜 및 시간입니다.

lastModifiedDate

개인 정보 작업을 마지막으로 수정한 날짜 및 시간입니다.

userIds

사용자 식별자 및 관련 정보가 포함된 배열입니다.

userIds.namespace

사용자 식별자에 사용되는 네임스페이스.

userIds.value

사용자 식별자의 실제 값.

userIds.type

식별자의 형식입니다(예: standard 또는 custom).

userIds.namespaceId

사용자 ID를 분류하고 관리하는 데 사용되는 네임스페이스의 식별자입니다.

userIds.isDeletedClientSide

클라이언트 측에서 식별자가 삭제되었는지 여부를 나타내는 부울입니다.

productResponses

개인 정보 작업과 관련된 다양한 제품 또는 서비스의 응답이 포함된 배열입니다.

productResponses.product

데이터 주체의 정보를 얻는 데 사용한 제품 또는 서비스의 이름입니다.

productResponses.retryCount

요청을 다시 시도한 횟수입니다.

productResponses.processedDate

제품 응답이 처리된 날짜 및 시간입니다.

productResponses.productStatusResponse

제품 응답의 상태를 포함하는 개체.

productResponses.productStatusResponse.status

제품 응답의 상태입니다.

downloadURL

이 속성은 작업을 완료한 후 60일 동안 호출할 수 있는 끝점을 제공합니다. 작업의 상태는 complete이고 action은(는) access이어야 합니다. 그렇지 않으면 이 필드가 없습니다.

regulation

개인 정보 보호 요청이 처리되는 규정 프레임워크(예: gdpr, ccpa, lgpd_bra, pdpa_tha 등).

고객 액세스 정보 가져오기

데이터 주체의 쿼리에 대한 응답으로 생성된 '액세스 정보'를 가져오려면 /jobs/{JOB_ID}/content 끝점에 GET 요청을 하십시오. 응답은 데이터 주체의 데이터를 저장하는 각 제품에 대한 하위 폴더가 있는 폴더가 포함된 zip 파일(*.zip)입니다.

TIP

이 요청을 수행하려면 특정 작업 ID가 필요합니다. 특정 작업 ID를 검색해야 하는 경우 먼저 /jobs 끝점에 GET 요청을 하고 추가 쿼리 매개 변수를 사용하여 결과를 필터링합니다. 허용되는 쿼리 매개 변수를 포함한 자세한 정보는 개인 정보 작업 끝점 안내서에서 확인할 수 있습니다.

API 형식

GET /jobs/{JOB_ID}/content

요청

다음 요청은 요청에 입력한 작업 ID에 대한 '액세스 정보'를 반환합니다.

curl -X GET \
  https://platform.adobe.io/data/core/privacy/jobs/32d429b1-f7f4-11ee-a365-574bcf5a525d/content \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'Accept: application/json`

응답

응답은 zip 파일(*.zip)입니다. 정보는 보장될 수 없지만 일반적으로 JSON 형식으로 반환됩니다. 추출된 데이터는 모든 형식으로 반환될 수 있습니다.

recommendation-more-help