RankRequest Klas

Een reeks acties aanvragen die moeten worden gerangschikt door de Personalizer-service.

Alle vereiste parameters moeten worden ingevuld om naar Azure te kunnen worden verzonden.

Overname

Model

RankRequest

Constructor

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

Parameters

context_features

list[object]

Vereist

Kenmerken van de context die wordt gebruikt voor Personalizer als woordenlijst van woordenlijsten. Dit is afhankelijk van de toepassing en bevat doorgaans functies over de huidige gebruiker, hun apparaat, profielgegevens, gegevens over tijd en datum, enzovoort.

actions

list[RankableAction]

Vereist

Vereist. De reeks acties waaruit de Personalizer-service kan kiezen. De set mag niet meer dan 50 acties bevatten. De volgorde van de acties heeft geen invloed op het rangschikkingsresultaat, maar de volgorde moet overeenkomen met de volgorde die uw toepassing zou hebben gebruikt om ze weer te geven.

excluded_actions

list[str]

Vereist

De set actie-id's die moet worden uitgesloten van de classificatie.

event_id

str

Vereist

Geef eventueel een eventId door die deze Rank-gebeurtenis uniek identificeert. Als dit null is, genereert de service een unieke eventId. De eventId wordt gebruikt voor het koppelen van deze aanvraag aan de beloning, evenals het seeden van de pseudo-willekeurige generator bij het maken van een Personalizer-aanroep.

defer_activation

bool

Vereist

Verzend onwaar als de gebruiker de rangschikkingsresultaten ziet, daarom verwacht Personalizer een Reward-aanroep, anders wordt de standaardbeloning toegewezen aan de gebeurtenis. Verzend waar als het mogelijk is dat de gebruiker de rangschikkingsresultaten niet ziet, omdat de pagina later wordt weergegeven, of de Rank-resultaten verder stroomafwaarts worden overschreven door code. Standaardwaarde: False .

Methoden

as_dict	Retourneer een dict die JSONify kan zijn met behulp van json.dump. Geavanceerd gebruik kan desgewenst een callback gebruiken als parameter: Sleutel is de kenmerknaam die wordt gebruikt in Python. Attr_desc is een dict van metagegevens. Bevat momenteel 'type' met het msrest-type en 'key' met de restAPI-gecodeerde sleutel. Waarde is de huidige waarde in dit object. De geretourneerde tekenreeks wordt gebruikt om de sleutel te serialiseren. Als het retourtype een lijst is, wordt dit beschouwd als hiërarchisch resultaatdicteren. Bekijk de drie voorbeelden in dit bestand: attribute_transformer full_restapi_key_transformer last_restapi_key_transformer Als u XML-serialisatie wilt, kunt u de kwargs is_xml=True doorgeven.
deserialize	Parseert een str met behulp van de RestAPI-syntaxis en retourneert een model.
enable_additional_properties_sending
from_dict	Een dict parseren met behulp van de opgegeven sleutelextractor retourneert een model. Houd standaard rekening met sleutelextracties (rest_key_case_insensitive_extractor, attribute_key_case_insensitive_extractor en last_rest_key_case_insensitive_extractor)
is_xml_model
serialize	Retourneert de JSON die vanuit dit model naar Azure wordt verzonden. Dit is een alias voor as_dict(full_restapi_key_transformer, keep_readonly=False). Als u XML-serialisatie wilt, kunt u de kwargs is_xml=True doorgeven.
validate	Valideer dit model recursief en retourneer een lijst met ValidationError.

as_dict

Retourneer een dict die JSONify kan zijn met behulp van json.dump.

Geavanceerd gebruik kan desgewenst een callback gebruiken als parameter:

Sleutel is de kenmerknaam die wordt gebruikt in Python. Attr_desc is een dict van metagegevens. Bevat momenteel 'type' met het msrest-type en 'key' met de restAPI-gecodeerde sleutel. Waarde is de huidige waarde in dit object.

De geretourneerde tekenreeks wordt gebruikt om de sleutel te serialiseren. Als het retourtype een lijst is, wordt dit beschouwd als hiërarchisch resultaatdicteren.

Bekijk de drie voorbeelden in dit bestand:

• attribute_transformer

• full_restapi_key_transformer

• last_restapi_key_transformer

Als u XML-serialisatie wilt, kunt u de kwargs is_xml=True doorgeven.

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

Parameters

key_transformer

<xref:function>

Een sleuteltransformatorfunctie.

keep_readonly

standaardwaarde: True

Retouren

Een dict JSON-compatibel object

Retourtype

dict

deserialize

Parseert een str met behulp van de RestAPI-syntaxis en retourneert een model.

deserialize(data, content_type=None)

Parameters

data

str

Vereist

Een str met behulp van restAPI-structuur. JSON standaard.

content_type

str

standaardwaarde: None

JSON standaard: stel application/xml in als XML.

Retouren

Een exemplaar van dit model

Uitzonderingen

DeserializationError if something went wrong

enable_additional_properties_sending

enable_additional_properties_sending()

from_dict

Een dict parseren met behulp van de opgegeven sleutelextractor retourneert een model.

Houd standaard rekening met sleutelextracties (rest_key_case_insensitive_extractor, attribute_key_case_insensitive_extractor en last_rest_key_case_insensitive_extractor)

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

Parameters

data

dict

Vereist

Een dict met behulp van de RestAPI-structuur

content_type

str

standaardwaarde: None

JSON standaard: stel application/xml in als XML.

key_extractors

standaardwaarde: None

Retouren

Een exemplaar van dit model

Uitzonderingen

DeserializationError if something went wrong

is_xml_model

is_xml_model()

serialize

Retourneert de JSON die vanuit dit model naar Azure wordt verzonden.

Dit is een alias voor as_dict(full_restapi_key_transformer, keep_readonly=False).

Als u XML-serialisatie wilt, kunt u de kwargs is_xml=True doorgeven.

serialize(keep_readonly=False, **kwargs)

Parameters

keep_readonly

bool

standaardwaarde: False

Als u de alleen-lezen kenmerken wilt serialiseren

Retouren

Een dict JSON-compatibel object

Retourtype

dict

validate

Valideer dit model recursief en retourneer een lijst met ValidationError.

validate()

Retouren

Een lijst met validatiefouten

Retourtype

list