GetActionRecommendations - Personalize
Request SyntaxURI 요청 파라미터요청 본문응답 구문응답 요소Errors참고

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

GetActionRecommendations

예측 점수를 기준으로 내림차순으로 정렬된 추천 작업 목록을 반환합니다. PERSONALIZED_ACTIONS 레시피로 교육된 솔루션 버전을 배포하는 사용자 지정 캠페인이 있는 경우 GetActionRecommendations API를 사용하세요.

PERSONALIZED_ACTIONS 레시피에 대한 자세한 내용은 PERSONALIZED_ACTIONS 레시피를 참조하세요. 작업 추천을 받는 방법에 대한 자세한 내용은 작업 추천 받기를 참조하세요.

Request Syntax

POST /action-recommendations HTTP/1.1
Content-type: application/json

{
   "campaignArn": "string",
   "filterArn": "string",
   "filterValues": { 
      "string" : "string" 
   },
   "numResults": number,
   "userId": "string"
}

URI 요청 파라미터

요청은 URI 파라미터를 사용하지 않습니다.

요청 본문

요청은 JSON 형식으로 다음 데이터를 받습니다.

campaignArn

작업 추천을 받기 위해 사용할 캠페인의 Amazon 리소스 이름(ARN)입니다. 이 캠페인은 PERSONALIZED_ACTIONS 레시피로 교육된 솔루션 버전을 배포해야 합니다.

타입: 문자열

길이 제약: 최대 길이 256.

패턴: arn:([a-z\d-]+):personalize:.*:.*:.+

Required: No

filterArn

반환되는 추천에 적용할 필터의 ARN입니다. 자세한 내용은 추천 필터링 단원을 참조하세요.

이 파라미터를 사용할 때는 필터 리소스가 ACTIVE이 맞는지 확인합니다.

타입: 문자열

길이 제약: 최대 길이 256.

패턴: arn:([a-z\d-]+):personalize:.*:.*:.+

Required: No

filterValues

추천을 필터링할 때 사용할 값. 필터 표현식의 각 자리 표시자 파라미터에 대해 파라미터 이름(대/소문자 구분)을 키로 그리고 필터 값을 해당 값으로 각각 제공합니다. 한 파라미터의 여러 값을 쉼표로 구분합니다.

INCLUDE 요소를 사용하여 작업을 포함하는 필터 표현식의 경우 표현식에 정의되어 있는 모든 파라미터의 값을 제공해야 합니다. EXCLUDE 요소를 사용하여 작업을 제외하는 표현식이 포함된 필터의 경우 filter-values를 생략할 수 있습니다. 이 경우 Personalize는 표현식의 해당 부분을 추천을 필터링하는 데 사용하지 않습니다.

자세한 내용은 추천 및 사용자 세그먼트 필터링 단원을 참조하세요.

유형: 문자열-문자열 맵

맵 항목: 최대 항목 수 25개.

키 길이 제약: 최대 길이 50.

키 패턴: [A-Za-z0-9_]+

값 길이 제약: 최대 길이 1000.

필수 여부: 아니요

numResults

반환할 결과 수. 기본값은 5입니다. 최대값은 100입니다.

유형: 정수

유효 범위: 최소값 0.

필수 여부: 아니요

userId

작업 추천을 제공할 사용자의 사용자 ID입니다.

타입: 문자열

길이 제약: 최대 길이 256.

필수 여부: 아니요

응답 구문

HTTP/1.1 200
Content-type: application/json

{
   "actionList": [ 
      { 
         "actionId": "string",
         "score": number
      }
   ],
   "recommendationId": "string"
}

응답 요소

작업이 성공하면 서비스가 HTTP 200 응답을 반송합니다.

다음 데이터는 서비스에 의해 JSON 형식으로 반환됩니다.

actionList

예측 점수를 기준으로 내림차순으로 정렬된 작업 추천 목록입니다. 목록에는 최대 100개의 작업이 있을 수 있습니다. 작업 점수에 대한 자세한 내용은 작업 추천 점수를 매기는 방식을 참조하세요.

유형: PredictedAction객체 어레이

recommendationId

추천의 ID.

타입: 문자열

Errors

InvalidInputException

필드 또는 파라미터에 유효한 값을 제공합니다.

HTTP 상태 코드: 400

ResourceNotFoundException

지정한 리소스가 존재하지 않습니다.

HTTP 상태 코드: 404

참고

언어별 AWS SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하십시오.