다음을 통해 공유

RankRequest 클래스

  • 참조

Personalizer 서비스에서 순위를 매겨야 하는 작업 집합을 요청합니다.

Azure로 보내려면 모든 필수 매개 변수를 채워야 합니다.

상속
Model
RankRequest

생성자

RankRequest(*, actions, context_features=None, excluded_actions=None, event_id: str = None, defer_activation: bool = False, **kwargs)

매개 변수

context_features
list[object]
필수

Personalizer에 사전 사전으로 사용되는 컨텍스트의 기능입니다. 이는 애플리케이션에 따라 달라지며 일반적으로 현재 사용자, 디바이스, 프로필 정보, 시간 및 날짜에 대한 데이터 등에 대한 기능을 포함합니다.

actions
list[RankableAction]
필수

필수 사항입니다. Personalizer 서비스에서 선택할 수 있는 작업 집합입니다. 집합에 50개 이상의 작업이 포함되어서는 안 됩니다. 작업의 순서는 순위 결과에 영향을 주지 않지만 순서는 애플리케이션에서 표시하는 데 사용한 시퀀스와 일치해야 합니다.

excluded_actions
list[str]
필수

순위에서 제외할 작업 ID 집합입니다.

event_id
str
필수

필요에 따라 이 Rank 이벤트를 고유하게 식별하는 eventId를 전달합니다. null이면 서비스에서 고유한 eventId를 생성합니다. eventId는 이 요청을 보상과 연결하고 Personalizer를 호출할 때 의사 임의 생성기를 시드하는 데 사용됩니다.

defer_activation
bool
필수

사용자에게 순위 결과가 표시되면 false를 보내므로 Personalizer는 Reward 호출을 예상합니다. 그렇지 않으면 기본 Reward를 이벤트에 할당합니다. 페이지가 나중에 렌더링되기 때문에 사용자가 순위 결과를 볼 수 없거나 순위 결과가 코드에 의해 더 이상 다운스트림으로 재정의될 수 있는 경우 true를 보냅니다. 기본값: False입니다.

메서드

as_dict

json.dump를 사용하여 JSONify일 수 있는 받아쓰기를 반환합니다.

고급 사용은 필요에 따라 콜백을 매개 변수로 사용할 수 있습니다.

키는 Python에서 사용되는 특성 이름입니다. Attr_desc 메타데이터의 받아쓰기입니다. 현재 msrest 형식의 'type'과 RestAPI로 인코딩된 키가 있는 'key'가 포함되어 있습니다. Value는 이 개체의 현재 값입니다.

반환된 문자열은 키를 serialize하는 데 사용됩니다. 반환 형식이 목록인 경우 계층적 결과 받아쓰기로 간주됩니다.

이 파일의 세 가지 예제를 참조하세요.

  • attribute_transformer

  • full_restapi_key_transformer

  • last_restapi_key_transformer

XML serialization을 원하는 경우 kwargs is_xml=True를 전달할 수 있습니다.
deserialize

RestAPI 구문을 사용하여 str을 구문 분석하고 모델을 반환합니다.
enable_additional_properties_sending
from_dict

지정된 키 추출기를 사용하여 받아쓰기를 구문 분석하여 모델을 반환합니다.

기본적으로 키 추출기(rest_key_case_insensitive_extractor, attribute_key_case_insensitive_extractor 및 last_rest_key_case_insensitive_extractor)를 고려합니다.
is_xml_model
serialize

이 모델에서 azure로 전송될 JSON을 반환합니다.

이는 as_dict(full_restapi_key_transformer, keep_readonly=False)에 대한 별칭입니다.

XML serialization을 원하는 경우 kwargs is_xml=True를 전달할 수 있습니다.
validate

이 모델의 유효성을 재귀적으로 검사하고 ValidationError 목록을 반환합니다.

as_dict

json.dump를 사용하여 JSONify일 수 있는 받아쓰기를 반환합니다.

고급 사용은 필요에 따라 콜백을 매개 변수로 사용할 수 있습니다.

키는 Python에서 사용되는 특성 이름입니다. Attr_desc 메타데이터의 받아쓰기입니다. 현재 msrest 형식의 'type'과 RestAPI로 인코딩된 키가 있는 'key'가 포함되어 있습니다. Value는 이 개체의 현재 값입니다.

반환된 문자열은 키를 serialize하는 데 사용됩니다. 반환 형식이 목록인 경우 계층적 결과 받아쓰기로 간주됩니다.

이 파일의 세 가지 예제를 참조하세요.

  • attribute_transformer

  • full_restapi_key_transformer

  • last_restapi_key_transformer

XML serialization을 원하는 경우 kwargs is_xml=True를 전달할 수 있습니다.

as_dict(keep_readonly=True, key_transformer=<function attribute_transformer>, **kwargs)

매개 변수

key_transformer
<xref:function>

키 변환기 함수입니다.

keep_readonly
기본값: True

반환

dict JSON 호환 개체

반환 형식

dict

deserialize

RestAPI 구문을 사용하여 str을 구문 분석하고 모델을 반환합니다.

deserialize(data, content_type=None)

매개 변수

data
str
필수

RestAPI 구조를 사용하는 str입니다. 기본적으로 JSON입니다.

content_type
str
기본값: None

기본적으로 JSON은 XML인 경우 application/xml을 설정합니다.

반환

이 모델의 instance

예외

DeserializationError if something went wrong

enable_additional_properties_sending 

enable_additional_properties_sending()

from_dict

지정된 키 추출기를 사용하여 받아쓰기를 구문 분석하여 모델을 반환합니다.

기본적으로 키 추출기(rest_key_case_insensitive_extractor, attribute_key_case_insensitive_extractor 및 last_rest_key_case_insensitive_extractor)를 고려합니다.

from_dict(data, key_extractors=None, content_type=None)

매개 변수

data
dict
필수

RestAPI 구조를 사용하는 받아쓰기

content_type
str
기본값: None

기본적으로 JSON은 XML인 경우 application/xml을 설정합니다.

key_extractors
기본값: None

반환

이 모델의 instance

예외

DeserializationError if something went wrong

is_xml_model 

is_xml_model()

serialize

이 모델에서 azure로 전송될 JSON을 반환합니다.

이는 as_dict(full_restapi_key_transformer, keep_readonly=False)에 대한 별칭입니다.

XML serialization을 원하는 경우 kwargs is_xml=True를 전달할 수 있습니다.

serialize(keep_readonly=False, **kwargs)

매개 변수

keep_readonly
bool
기본값: False

읽기 전용 특성을 직렬화하려는 경우

반환

dict JSON 호환 개체

반환 형식

dict

validate

이 모델의 유효성을 재귀적으로 검사하고 ValidationError 목록을 반환합니다.

validate()

반환

유효성 검사 오류 목록

반환 형식

list