Class UserInfo.Builder (0.90.0)

public static final class UserInfo.Builder extends GeneratedMessage.Builder<UserInfo.Builder> implements UserInfoOrBuilder

Information of end users.

Protobuf type google.cloud.recommendationengine.v1beta1.UserInfo

Implements

UserInfoOrBuilder

Static Methods

getDescriptor()

public static final Descriptors.Descriptor getDescriptor()
Returns
Type Description
Descriptor

Methods

build()

public UserInfo build()
Returns
Type Description
UserInfo

buildPartial()

public UserInfo buildPartial()
Returns
Type Description
UserInfo

clear()

public UserInfo.Builder clear()
Returns
Type Description
UserInfo.Builder
Overrides

clearDirectUserRequest()

public UserInfo.Builder clearDirectUserRequest()

Optional. Indicates if the request is made directly from the end user in which case the user_agent and ip_address fields can be populated from the HTTP request. This should not be set when using the javascript pixel. 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).

bool direct_user_request = 5 [(.google.api.field_behavior) = OPTIONAL];

Returns
Type Description
UserInfo.Builder

This builder for chaining.

clearIpAddress()

public UserInfo.Builder clearIpAddress()

Optional. IP address of the user. This could be either IPv4 (e.g. 104.133.9.80) or IPv6 (e.g. 2001:0db8:85a3:0000:0000:8a2e:0370:7334). This should not be set when using the javascript pixel or if direct_user_request is set. Used to extract location information for personalization.

string ip_address = 3 [(.google.api.field_behavior) = OPTIONAL];

Returns
Type Description
UserInfo.Builder

This builder for chaining.

clearUserAgent()

public UserInfo.Builder clearUserAgent()

Optional. User agent as included in the HTTP header. UTF-8 encoded string with a length limit of 1 KiB.

This should not be set when using the JavaScript pixel or if directUserRequest is set.

string user_agent = 4 [(.google.api.field_behavior) = OPTIONAL];

Returns
Type Description
UserInfo.Builder

This builder for chaining.

clearUserId()

public UserInfo.Builder clearUserId()

Optional. Unique identifier for logged-in user with a length limit of 128 bytes. Required only for logged-in users.

string user_id = 2 [(.google.api.field_behavior) = OPTIONAL];

Returns
Type Description
UserInfo.Builder

This builder for chaining.

clearVisitorId()

public UserInfo.Builder clearVisitorId()

Required. A unique identifier for tracking visitors with a length limit of 128 bytes.

For example, this could be implemented with a http cookie, which should be able to uniquely identify a visitor on a single device. This unique identifier should not change if the visitor log in/out of the website. Maximum length 128 bytes. Cannot be empty.

string visitor_id = 1 [(.google.api.field_behavior) = REQUIRED];

Returns
Type Description
UserInfo.Builder

This builder for chaining.

getDefaultInstanceForType()

public UserInfo getDefaultInstanceForType()
Returns
Type Description
UserInfo

getDescriptorForType()

public Descriptors.Descriptor getDescriptorForType()
Returns
Type Description
Descriptor
Overrides

getDirectUserRequest()

public boolean getDirectUserRequest()

Optional. Indicates if the request is made directly from the end user in which case the user_agent and ip_address fields can be populated from the HTTP request. This should not be set when using the javascript pixel. 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).

bool direct_user_request = 5 [(.google.api.field_behavior) = OPTIONAL];

Returns
Type Description
boolean

The directUserRequest.

getIpAddress()

public String getIpAddress()

Optional. IP address of the user. This could be either IPv4 (e.g. 104.133.9.80) or IPv6 (e.g. 2001:0db8:85a3:0000:0000:8a2e:0370:7334). This should not be set when using the javascript pixel or if direct_user_request is set. Used to extract location information for personalization.

string ip_address = 3 [(.google.api.field_behavior) = OPTIONAL];

Returns
Type Description
String

The ipAddress.

getIpAddressBytes()

public ByteString getIpAddressBytes()

Optional. IP address of the user. This could be either IPv4 (e.g. 104.133.9.80) or IPv6 (e.g. 2001:0db8:85a3:0000:0000:8a2e:0370:7334). This should not be set when using the javascript pixel or if direct_user_request is set. Used to extract location information for personalization.

string ip_address = 3 [(.google.api.field_behavior) = OPTIONAL];

Returns
Type Description
ByteString

The bytes for ipAddress.

getUserAgent()

public String getUserAgent()

Optional. User agent as included in the HTTP header. UTF-8 encoded string with a length limit of 1 KiB.

This should not be set when using the JavaScript pixel or if directUserRequest is set.

string user_agent = 4 [(.google.api.field_behavior) = OPTIONAL];

Returns
Type Description
String

The userAgent.

getUserAgentBytes()

public ByteString getUserAgentBytes()

Optional. User agent as included in the HTTP header. UTF-8 encoded string with a length limit of 1 KiB.

This should not be set when using the JavaScript pixel or if directUserRequest is set.

string user_agent = 4 [(.google.api.field_behavior) = OPTIONAL];

Returns
Type Description
ByteString

The bytes for userAgent.

getUserId()

public String getUserId()

Optional. Unique identifier for logged-in user with a length limit of 128 bytes. Required only for logged-in users.

string user_id = 2 [(.google.api.field_behavior) = OPTIONAL];

Returns
Type Description
String

The userId.

getUserIdBytes()

public ByteString getUserIdBytes()

Optional. Unique identifier for logged-in user with a length limit of 128 bytes. Required only for logged-in users.

string user_id = 2 [(.google.api.field_behavior) = OPTIONAL];

Returns
Type Description
ByteString

The bytes for userId.

getVisitorId()

public String getVisitorId()

Required. A unique identifier for tracking visitors with a length limit of 128 bytes.

For example, this could be implemented with a http cookie, which should be able to uniquely identify a visitor on a single device. This unique identifier should not change if the visitor log in/out of the website. Maximum length 128 bytes. Cannot be empty.

string visitor_id = 1 [(.google.api.field_behavior) = REQUIRED];

Returns
Type Description
String

The visitorId.

getVisitorIdBytes()

public ByteString getVisitorIdBytes()

Required. A unique identifier for tracking visitors with a length limit of 128 bytes.

For example, this could be implemented with a http cookie, which should be able to uniquely identify a visitor on a single device. This unique identifier should not change if the visitor log in/out of the website. Maximum length 128 bytes. Cannot be empty.

string visitor_id = 1 [(.google.api.field_behavior) = REQUIRED];

Returns
Type Description
ByteString

The bytes for visitorId.

internalGetFieldAccessorTable()

protected GeneratedMessage.FieldAccessorTable internalGetFieldAccessorTable()
Returns
Type Description
FieldAccessorTable
Overrides

isInitialized()

public final boolean isInitialized()
Returns
Type Description
boolean
Overrides

mergeFrom(UserInfo other)

public UserInfo.Builder mergeFrom(UserInfo other)
Parameter
Name Description
other UserInfo
Returns
Type Description
UserInfo.Builder

mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)

public UserInfo.Builder mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
Name Description
input CodedInputStream
extensionRegistry ExtensionRegistryLite
Returns
Type Description
UserInfo.Builder
Overrides
Exceptions
Type Description
IOException

mergeFrom(Message other)

public UserInfo.Builder mergeFrom(Message other)
Parameter
Name Description
other Message
Returns
Type Description
UserInfo.Builder
Overrides

setDirectUserRequest(boolean value)

public UserInfo.Builder setDirectUserRequest(boolean value)

Optional. Indicates if the request is made directly from the end user in which case the user_agent and ip_address fields can be populated from the HTTP request. This should not be set when using the javascript pixel. 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).

bool direct_user_request = 5 [(.google.api.field_behavior) = OPTIONAL];

Parameter
Name Description
value boolean

The directUserRequest to set.

Returns
Type Description
UserInfo.Builder

This builder for chaining.

setIpAddress(String value)

public UserInfo.Builder setIpAddress(String value)

Optional. IP address of the user. This could be either IPv4 (e.g. 104.133.9.80) or IPv6 (e.g. 2001:0db8:85a3:0000:0000:8a2e:0370:7334). This should not be set when using the javascript pixel or if direct_user_request is set. Used to extract location information for personalization.

string ip_address = 3 [(.google.api.field_behavior) = OPTIONAL];

Parameter
Name Description
value String

The ipAddress to set.

Returns
Type Description
UserInfo.Builder

This builder for chaining.

setIpAddressBytes(ByteString value)

public UserInfo.Builder setIpAddressBytes(ByteString value)

Optional. IP address of the user. This could be either IPv4 (e.g. 104.133.9.80) or IPv6 (e.g. 2001:0db8:85a3:0000:0000:8a2e:0370:7334). This should not be set when using the javascript pixel or if direct_user_request is set. Used to extract location information for personalization.

string ip_address = 3 [(.google.api.field_behavior) = OPTIONAL];

Parameter
Name Description
value ByteString

The bytes for ipAddress to set.

Returns
Type Description
UserInfo.Builder

This builder for chaining.

setUserAgent(String value)

public UserInfo.Builder setUserAgent(String value)

Optional. User agent as included in the HTTP header. UTF-8 encoded string with a length limit of 1 KiB.

This should not be set when using the JavaScript pixel or if directUserRequest is set.

string user_agent = 4 [(.google.api.field_behavior) = OPTIONAL];

Parameter
Name Description
value String

The userAgent to set.

Returns
Type Description
UserInfo.Builder

This builder for chaining.

setUserAgentBytes(ByteString value)

public UserInfo.Builder setUserAgentBytes(ByteString value)

Optional. User agent as included in the HTTP header. UTF-8 encoded string with a length limit of 1 KiB.

This should not be set when using the JavaScript pixel or if directUserRequest is set.

string user_agent = 4 [(.google.api.field_behavior) = OPTIONAL];

Parameter
Name Description
value ByteString

The bytes for userAgent to set.

Returns
Type Description
UserInfo.Builder

This builder for chaining.

setUserId(String value)

public UserInfo.Builder setUserId(String value)

Optional. Unique identifier for logged-in user with a length limit of 128 bytes. Required only for logged-in users.

string user_id = 2 [(.google.api.field_behavior) = OPTIONAL];

Parameter
Name Description
value String

The userId to set.

Returns
Type Description
UserInfo.Builder

This builder for chaining.

setUserIdBytes(ByteString value)

public UserInfo.Builder setUserIdBytes(ByteString value)

Optional. Unique identifier for logged-in user with a length limit of 128 bytes. Required only for logged-in users.

string user_id = 2 [(.google.api.field_behavior) = OPTIONAL];

Parameter
Name Description
value ByteString

The bytes for userId to set.

Returns
Type Description
UserInfo.Builder

This builder for chaining.

setVisitorId(String value)

public UserInfo.Builder setVisitorId(String value)

Required. A unique identifier for tracking visitors with a length limit of 128 bytes.

For example, this could be implemented with a http cookie, which should be able to uniquely identify a visitor on a single device. This unique identifier should not change if the visitor log in/out of the website. Maximum length 128 bytes. Cannot be empty.

string visitor_id = 1 [(.google.api.field_behavior) = REQUIRED];

Parameter
Name Description
value String

The visitorId to set.

Returns
Type Description
UserInfo.Builder

This builder for chaining.

setVisitorIdBytes(ByteString value)

public UserInfo.Builder setVisitorIdBytes(ByteString value)

Required. A unique identifier for tracking visitors with a length limit of 128 bytes.

For example, this could be implemented with a http cookie, which should be able to uniquely identify a visitor on a single device. This unique identifier should not change if the visitor log in/out of the website. Maximum length 128 bytes. Cannot be empty.

string visitor_id = 1 [(.google.api.field_behavior) = REQUIRED];

Parameter
Name Description
value ByteString

The bytes for visitorId to set.

Returns
Type Description
UserInfo.Builder

This builder for chaining.