Struct gapi_grpc::google::cloud::retail::v2::UserInfo

pub struct UserInfo {
    pub user_id: String,
    pub ip_address: String,
    pub user_agent: String,
    pub direct_user_request: bool,
}

Information of an end user.

Fields

user_id: String

Highly recommended for logged-in users. Unique identifier for logged-in user, such as a user name.

The field must be a UTF-8 encoded string with a length limit of 128 characters. Otherwise, an INVALID_ARGUMENT error is returned.

ip_address: String

The end user’s IP address. This field is used to extract location information for personalization.

This field must be either an IPv4 address (e.g. “104.133.9.80”) or an IPv6 address (e.g. “2001:0db8:85a3:0000:0000:8a2e:0370:7334”). Otherwise, an INVALID_ARGUMENT error is returned.

This should not be set when using the JavaScript tag in [UserEventService.CollectUserEvent][google.cloud.retail.v2.UserEventService.CollectUserEvent] or if [direct_user_request][google.cloud.retail.v2.UserInfo.direct_user_request] is set.

user_agent: String

User agent as included in the HTTP header.

The field must be a UTF-8 encoded string with a length limit of 1,000 characters. Otherwise, an INVALID_ARGUMENT error is returned.

This should not be set when using the client side event reporting with GTM or JavaScript tag in [UserEventService.CollectUserEvent][google.cloud.retail.v2.UserEventService.CollectUserEvent] or if [direct_user_request][google.cloud.retail.v2.UserInfo.direct_user_request] is set.

direct_user_request: bool

True if the request is made directly from the end user, in which case the [ip_address][google.cloud.retail.v2.UserInfo.ip_address] and [user_agent][google.cloud.retail.v2.UserInfo.user_agent] can be populated from the HTTP request. This flag should be set only if the API request is made directly from the end user such as a mobile app (and not if a gateway or a server is processing and pushing the user events).

This should not be set when using the JavaScript tag in [UserEventService.CollectUserEvent][google.cloud.retail.v2.UserEventService.CollectUserEvent].

Trait Implementations

impl Clone for UserInfo

fn clone(&self) -> UserInfo

Returns a copy of the value.

pub fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for UserInfo

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for UserInfo

fn default() -> UserInfo

Returns the “default value” for a type.

impl Message for UserInfo

fn encode_raw<B>(&self, buf: &mut B) where
    B: BufMut, 

fn merge_field<B>(
    &mut self,
    tag: u32,
    wire_type: WireType,
    buf: &mut B,
    ctx: DecodeContext
) -> Result<(), DecodeError> where
    B: Buf, 

fn encoded_len(&self) -> usize

Returns the encoded length of the message without a length delimiter.

fn clear(&mut self)

Clears the message, resetting all fields to their default.

pub fn encode<B>(&self, buf: &mut B) -> Result<(), EncodeError> where
    B: BufMut, 

Encodes the message to a buffer.

pub fn encode_length_delimited<B>(&self, buf: &mut B) -> Result<(), EncodeError> where
    B: BufMut, 

Encodes the message with a length-delimiter to a buffer.

pub fn decode<B>(buf: B) -> Result<Self, DecodeError> where
    Self: Default,
    B: Buf, 

Decodes an instance of the message from a buffer.

pub fn decode_length_delimited<B>(buf: B) -> Result<Self, DecodeError> where
    Self: Default,
    B: Buf, 

Decodes a length-delimited instance of the message from the buffer.

pub fn merge<B>(&mut self, buf: B) -> Result<(), DecodeError> where
    B: Buf, 

Decodes an instance of the message from a buffer, and merges it into self.

pub fn merge_length_delimited<B>(&mut self, buf: B) -> Result<(), DecodeError> where
    B: Buf, 

Decodes a length-delimited instance of the message from buffer, and merges it into self.

impl PartialEq<UserInfo> for UserInfo

fn eq(&self, other: &UserInfo) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &UserInfo) -> bool

This method tests for !=.

impl StructuralPartialEq for UserInfo