Class CatalogAttribute.Builder (2.55.0)

Version 2.55.0

• 2.56.0 (latest)
• 2.55.0
• 2.54.0
• 2.53.0
• 2.51.0
• 2.50.0
• 2.49.0
• 2.48.0
• 2.47.0
• 2.46.0
• 2.45.0
• 2.44.0
• 2.43.0
• 2.42.0
• 2.41.0
• 2.39.0
• 2.38.0
• 2.37.0
• 2.36.0
• 2.35.0
• 2.34.0
• 2.33.0
• 2.32.0
• 2.31.0
• 2.30.0
• 2.29.0
• 2.26.0
• 2.25.0
• 2.24.0
• 2.23.0
• 2.22.0
• 2.21.0
• 2.20.0
• 2.19.0
• 2.18.0
• 2.17.0
• 2.16.0
• 2.15.0
• 2.14.0
• 2.13.0
• 2.11.0
• 2.10.0
• 2.9.0
• 2.8.0
• 2.7.0
• 2.6.0
• 2.5.1
• 2.4.0
• 2.3.0
• 2.2.3
• 2.1.0
• 2.0.19

public static final class CatalogAttribute.Builder extends GeneratedMessageV3.Builder<CatalogAttribute.Builder> implements CatalogAttributeOrBuilder

Catalog level attribute config for an attribute. For example, if customers want to enable/disable facet for a specific attribute.

Protobuf type google.cloud.retail.v2.CatalogAttribute

Inheritance

Object > AbstractMessageLite.Builder<MessageType,BuilderType> > AbstractMessage.Builder<BuilderType> > GeneratedMessageV3.Builder > CatalogAttribute.Builder

Implements

CatalogAttributeOrBuilder

Inherited Members

AbstractMessage.Builder.findInitializationErrors()

AbstractMessage.Builder.getInitializationErrorString()

AbstractMessage.Builder.internalMergeFrom(AbstractMessageLite)

AbstractMessage.Builder.mergeFrom(byte[])

AbstractMessage.Builder.mergeFrom(byte[],ExtensionRegistryLite)

AbstractMessage.Builder.mergeFrom(byte[],int,int)

AbstractMessage.Builder.mergeFrom(byte[],int,int,ExtensionRegistryLite)

AbstractMessage.Builder.mergeFrom(ByteString)

AbstractMessage.Builder.mergeFrom(ByteString,ExtensionRegistryLite)

AbstractMessage.Builder.mergeFrom(CodedInputStream)

AbstractMessage.Builder.mergeFrom(CodedInputStream,ExtensionRegistryLite)

AbstractMessage.Builder.mergeFrom(Message)

AbstractMessage.Builder.mergeFrom(InputStream)

AbstractMessage.Builder.mergeFrom(InputStream,ExtensionRegistryLite)

AbstractMessage.Builder.newUninitializedMessageException(Message)

AbstractMessage.Builder.toString()

AbstractMessageLite.Builder.<T>addAll(Iterable<T>,Collection<? super T>)

AbstractMessageLite.Builder.<T>addAll(Iterable<T>,List<? super T>)

AbstractMessageLite.Builder.internalMergeFrom(MessageType)

AbstractMessageLite.Builder.mergeDelimitedFrom(InputStream)

AbstractMessageLite.Builder.mergeDelimitedFrom(InputStream,ExtensionRegistryLite)

AbstractMessageLite.Builder.mergeFrom(MessageLite)

AbstractMessageLite.Builder.newUninitializedMessageException(MessageLite)

GeneratedMessageV3.Builder.addRepeatedField(Descriptors.FieldDescriptor,Object)

GeneratedMessageV3.Builder.clear()

GeneratedMessageV3.Builder.clearField(Descriptors.FieldDescriptor)

GeneratedMessageV3.Builder.clearOneof(Descriptors.OneofDescriptor)

GeneratedMessageV3.Builder.clone()

GeneratedMessageV3.Builder.getAllFields()

GeneratedMessageV3.Builder.getDescriptorForType()

GeneratedMessageV3.Builder.getField(Descriptors.FieldDescriptor)

GeneratedMessageV3.Builder.getFieldBuilder(Descriptors.FieldDescriptor)

GeneratedMessageV3.Builder.getOneofFieldDescriptor(Descriptors.OneofDescriptor)

GeneratedMessageV3.Builder.getParentForChildren()

GeneratedMessageV3.Builder.getRepeatedField(Descriptors.FieldDescriptor,int)

GeneratedMessageV3.Builder.getRepeatedFieldBuilder(Descriptors.FieldDescriptor,int)

GeneratedMessageV3.Builder.getRepeatedFieldCount(Descriptors.FieldDescriptor)

com.google.protobuf.GeneratedMessageV3.Builder.getUnknownFieldSetBuilder()

GeneratedMessageV3.Builder.getUnknownFields()

GeneratedMessageV3.Builder.hasField(Descriptors.FieldDescriptor)

GeneratedMessageV3.Builder.hasOneof(Descriptors.OneofDescriptor)

GeneratedMessageV3.Builder.internalGetFieldAccessorTable()

GeneratedMessageV3.Builder.internalGetMapField(int)

com.google.protobuf.GeneratedMessageV3.Builder.internalGetMapFieldReflection(int)

GeneratedMessageV3.Builder.internalGetMutableMapField(int)

com.google.protobuf.GeneratedMessageV3.Builder.internalGetMutableMapFieldReflection(int)

GeneratedMessageV3.Builder.isClean()

GeneratedMessageV3.Builder.isInitialized()

GeneratedMessageV3.Builder.markClean()

GeneratedMessageV3.Builder.mergeUnknownFields(UnknownFieldSet)

com.google.protobuf.GeneratedMessageV3.Builder.mergeUnknownLengthDelimitedField(int,com.google.protobuf.ByteString)

com.google.protobuf.GeneratedMessageV3.Builder.mergeUnknownVarintField(int,int)

GeneratedMessageV3.Builder.newBuilderForField(Descriptors.FieldDescriptor)

GeneratedMessageV3.Builder.onBuilt()

GeneratedMessageV3.Builder.onChanged()

com.google.protobuf.GeneratedMessageV3.Builder.parseUnknownField(com.google.protobuf.CodedInputStream,com.google.protobuf.ExtensionRegistryLite,int)

GeneratedMessageV3.Builder.setField(Descriptors.FieldDescriptor,Object)

GeneratedMessageV3.Builder.setRepeatedField(Descriptors.FieldDescriptor,int,Object)

com.google.protobuf.GeneratedMessageV3.Builder.setUnknownFieldSetBuilder(com.google.protobuf.UnknownFieldSet.Builder)

GeneratedMessageV3.Builder.setUnknownFields(UnknownFieldSet)

GeneratedMessageV3.Builder.setUnknownFieldsProto3(UnknownFieldSet)

Object.equals(Object)

Object.finalize()

Object.getClass()

Object.hashCode()

Object.notify()

Object.notifyAll()

Object.wait()

Object.wait(long)

Object.wait(long,int)

Static Methods

getDescriptor()

public static final Descriptors.Descriptor getDescriptor()

Returns
Type	Description
Descriptor

Methods

addRepeatedField(Descriptors.FieldDescriptor field, Object value)

public CatalogAttribute.Builder addRepeatedField(Descriptors.FieldDescriptor field, Object value)

Parameters
Name	Description
field	FieldDescriptor
value	Object

Returns
Type	Description
CatalogAttribute.Builder

Overrides

GeneratedMessageV3.Builder<BuilderType>.addRepeatedField(Descriptors.FieldDescriptor field, Object value)

build()

public CatalogAttribute build()

Returns
Type	Description
CatalogAttribute

buildPartial()

public CatalogAttribute buildPartial()

Returns
Type	Description
CatalogAttribute

clear()

public CatalogAttribute.Builder clear()

Returns
Type	Description
CatalogAttribute.Builder

Overrides

GeneratedMessageV3.Builder<BuilderType>.clear()

clearDynamicFacetableOption()

public CatalogAttribute.Builder clearDynamicFacetableOption()

If DYNAMIC_FACETABLE_ENABLED, attribute values are available for dynamic facet. Could only be DYNAMIC_FACETABLE_DISABLED if CatalogAttribute.indexable_option is INDEXABLE_DISABLED. Otherwise, an INVALID_ARGUMENT error is returned.

Must be specified, otherwise throws INVALID_FORMAT error.

.google.cloud.retail.v2.CatalogAttribute.DynamicFacetableOption dynamic_facetable_option = 6;

Returns
Type	Description
CatalogAttribute.Builder	This builder for chaining.

clearExactSearchableOption()

public CatalogAttribute.Builder clearExactSearchableOption()

If EXACT_SEARCHABLE_ENABLED, attribute values will be exact searchable. This property only applies to textual custom attributes and requires indexable set to enabled to enable exact-searchable. If unset, the server behavior defaults to EXACT_SEARCHABLE_DISABLED.

.google.cloud.retail.v2.CatalogAttribute.ExactSearchableOption exact_searchable_option = 11;

Returns
Type	Description
CatalogAttribute.Builder	This builder for chaining.

clearFacetConfig()

public CatalogAttribute.Builder clearFacetConfig()

Contains facet options.

.google.cloud.retail.v2.CatalogAttribute.FacetConfig facet_config = 13;

Returns
Type	Description
CatalogAttribute.Builder

clearField(Descriptors.FieldDescriptor field)

public CatalogAttribute.Builder clearField(Descriptors.FieldDescriptor field)

Parameter
Name	Description
field	FieldDescriptor

Returns
Type	Description
CatalogAttribute.Builder

Overrides

GeneratedMessageV3.Builder<BuilderType>.clearField(Descriptors.FieldDescriptor field)

clearInUse()

public CatalogAttribute.Builder clearInUse()

Output only. Indicates whether this attribute has been used by any products. True if at least one Product is using this attribute in Product.attributes. Otherwise, this field is False.

CatalogAttribute can be pre-loaded by using CatalogService.AddCatalogAttribute, [CatalogService.ImportCatalogAttributes][], or CatalogService.UpdateAttributesConfig APIs. This field is False for pre-loaded CatalogAttributes.

Only pre-loaded catalog attributes that are neither in use by products nor predefined can be deleted. Catalog attributes that are either in use by products or are predefined attributes cannot be deleted; however, their configuration properties will reset to default values upon removal request.

After catalog changes, it takes about 10 minutes for this field to update.

bool in_use = 9 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type	Description
CatalogAttribute.Builder	This builder for chaining.

clearIndexableOption()

public CatalogAttribute.Builder clearIndexableOption()

When AttributesConfig.attribute_config_level is CATALOG_LEVEL_ATTRIBUTE_CONFIG, if INDEXABLE_ENABLED attribute values are indexed so that it can be filtered, faceted, or boosted in SearchService.Search.

Must be specified when AttributesConfig.attribute_config_level is CATALOG_LEVEL_ATTRIBUTE_CONFIG, otherwise throws INVALID_FORMAT error.

.google.cloud.retail.v2.CatalogAttribute.IndexableOption indexable_option = 5;

Returns
Type	Description
CatalogAttribute.Builder	This builder for chaining.

clearKey()

public CatalogAttribute.Builder clearKey()

Required. Attribute name. For example: color, brands, attributes.custom_attribute, such as attributes.xyz. To be indexable, the attribute name can contain only alpha-numeric characters and underscores. For example, an attribute named attributes.abc_xyz can be indexed, but an attribute named attributes.abc-xyz cannot be indexed.

If the attribute key starts with attributes., then the attribute is a custom attribute. Attributes such as brands, patterns, and title are built-in and called system attributes.

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

Returns
Type	Description
CatalogAttribute.Builder	This builder for chaining.

clearOneof(Descriptors.OneofDescriptor oneof)

public CatalogAttribute.Builder clearOneof(Descriptors.OneofDescriptor oneof)

Parameter
Name	Description
oneof	OneofDescriptor

Returns
Type	Description
CatalogAttribute.Builder

Overrides

GeneratedMessageV3.Builder<BuilderType>.clearOneof(Descriptors.OneofDescriptor oneof)

clearRetrievableOption()

public CatalogAttribute.Builder clearRetrievableOption()

If RETRIEVABLE_ENABLED, attribute values are retrievable in the search results. If unset, the server behavior defaults to RETRIEVABLE_DISABLED.

.google.cloud.retail.v2.CatalogAttribute.RetrievableOption retrievable_option = 12;

Returns
Type	Description
CatalogAttribute.Builder	This builder for chaining.

clearSearchableOption()

public CatalogAttribute.Builder clearSearchableOption()

When AttributesConfig.attribute_config_level is CATALOG_LEVEL_ATTRIBUTE_CONFIG, if SEARCHABLE_ENABLED, attribute values are searchable by text queries in SearchService.Search.

If SEARCHABLE_ENABLED but attribute type is numerical, attribute values will not be searchable by text queries in SearchService.Search, as there are no text values associated to numerical attributes.

Must be specified, when AttributesConfig.attribute_config_level is CATALOG_LEVEL_ATTRIBUTE_CONFIG, otherwise throws INVALID_FORMAT error.

.google.cloud.retail.v2.CatalogAttribute.SearchableOption searchable_option = 7;

Returns
Type	Description
CatalogAttribute.Builder	This builder for chaining.

clearType()

public CatalogAttribute.Builder clearType()

Output only. The type of this attribute. This is derived from the attribute in Product.attributes.

.google.cloud.retail.v2.CatalogAttribute.AttributeType type = 10 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type	Description
CatalogAttribute.Builder	This builder for chaining.

clone()

public CatalogAttribute.Builder clone()

Returns
Type	Description
CatalogAttribute.Builder

Overrides

GeneratedMessageV3.Builder<BuilderType>.clone()

getDefaultInstanceForType()

public CatalogAttribute getDefaultInstanceForType()

Returns
Type	Description
CatalogAttribute

getDescriptorForType()

public Descriptors.Descriptor getDescriptorForType()

Returns
Type	Description
Descriptor

Overrides

GeneratedMessageV3.Builder<BuilderType>.getDescriptorForType()

getDynamicFacetableOption()

public CatalogAttribute.DynamicFacetableOption getDynamicFacetableOption()

If DYNAMIC_FACETABLE_ENABLED, attribute values are available for dynamic facet. Could only be DYNAMIC_FACETABLE_DISABLED if CatalogAttribute.indexable_option is INDEXABLE_DISABLED. Otherwise, an INVALID_ARGUMENT error is returned.

Must be specified, otherwise throws INVALID_FORMAT error.

.google.cloud.retail.v2.CatalogAttribute.DynamicFacetableOption dynamic_facetable_option = 6;

Returns
Type	Description
CatalogAttribute.DynamicFacetableOption	The dynamicFacetableOption.

getDynamicFacetableOptionValue()

public int getDynamicFacetableOptionValue()

If DYNAMIC_FACETABLE_ENABLED, attribute values are available for dynamic facet. Could only be DYNAMIC_FACETABLE_DISABLED if CatalogAttribute.indexable_option is INDEXABLE_DISABLED. Otherwise, an INVALID_ARGUMENT error is returned.

Must be specified, otherwise throws INVALID_FORMAT error.

.google.cloud.retail.v2.CatalogAttribute.DynamicFacetableOption dynamic_facetable_option = 6;

Returns
Type	Description
int	The enum numeric value on the wire for dynamicFacetableOption.

getExactSearchableOption()

public CatalogAttribute.ExactSearchableOption getExactSearchableOption()

If EXACT_SEARCHABLE_ENABLED, attribute values will be exact searchable. This property only applies to textual custom attributes and requires indexable set to enabled to enable exact-searchable. If unset, the server behavior defaults to EXACT_SEARCHABLE_DISABLED.

.google.cloud.retail.v2.CatalogAttribute.ExactSearchableOption exact_searchable_option = 11;

Returns
Type	Description
CatalogAttribute.ExactSearchableOption	The exactSearchableOption.

getExactSearchableOptionValue()

public int getExactSearchableOptionValue()

If EXACT_SEARCHABLE_ENABLED, attribute values will be exact searchable. This property only applies to textual custom attributes and requires indexable set to enabled to enable exact-searchable. If unset, the server behavior defaults to EXACT_SEARCHABLE_DISABLED.

.google.cloud.retail.v2.CatalogAttribute.ExactSearchableOption exact_searchable_option = 11;

Returns
Type	Description
int	The enum numeric value on the wire for exactSearchableOption.

getFacetConfig()

public CatalogAttribute.FacetConfig getFacetConfig()

Contains facet options.

.google.cloud.retail.v2.CatalogAttribute.FacetConfig facet_config = 13;

Returns
Type	Description
CatalogAttribute.FacetConfig	The facetConfig.

getFacetConfigBuilder()

public CatalogAttribute.FacetConfig.Builder getFacetConfigBuilder()

Contains facet options.

.google.cloud.retail.v2.CatalogAttribute.FacetConfig facet_config = 13;

Returns
Type	Description
CatalogAttribute.FacetConfig.Builder

getFacetConfigOrBuilder()

public CatalogAttribute.FacetConfigOrBuilder getFacetConfigOrBuilder()

Contains facet options.

.google.cloud.retail.v2.CatalogAttribute.FacetConfig facet_config = 13;

Returns
Type	Description
CatalogAttribute.FacetConfigOrBuilder

getInUse()

public boolean getInUse()

Output only. Indicates whether this attribute has been used by any products. True if at least one Product is using this attribute in Product.attributes. Otherwise, this field is False.

CatalogAttribute can be pre-loaded by using CatalogService.AddCatalogAttribute, [CatalogService.ImportCatalogAttributes][], or CatalogService.UpdateAttributesConfig APIs. This field is False for pre-loaded CatalogAttributes.

Only pre-loaded catalog attributes that are neither in use by products nor predefined can be deleted. Catalog attributes that are either in use by products or are predefined attributes cannot be deleted; however, their configuration properties will reset to default values upon removal request.

After catalog changes, it takes about 10 minutes for this field to update.

bool in_use = 9 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type	Description
boolean	The inUse.

getIndexableOption()

public CatalogAttribute.IndexableOption getIndexableOption()

When AttributesConfig.attribute_config_level is CATALOG_LEVEL_ATTRIBUTE_CONFIG, if INDEXABLE_ENABLED attribute values are indexed so that it can be filtered, faceted, or boosted in SearchService.Search.

Must be specified when AttributesConfig.attribute_config_level is CATALOG_LEVEL_ATTRIBUTE_CONFIG, otherwise throws INVALID_FORMAT error.

.google.cloud.retail.v2.CatalogAttribute.IndexableOption indexable_option = 5;

Returns
Type	Description
CatalogAttribute.IndexableOption	The indexableOption.

getIndexableOptionValue()

public int getIndexableOptionValue()

When AttributesConfig.attribute_config_level is CATALOG_LEVEL_ATTRIBUTE_CONFIG, if INDEXABLE_ENABLED attribute values are indexed so that it can be filtered, faceted, or boosted in SearchService.Search.

Must be specified when AttributesConfig.attribute_config_level is CATALOG_LEVEL_ATTRIBUTE_CONFIG, otherwise throws INVALID_FORMAT error.

.google.cloud.retail.v2.CatalogAttribute.IndexableOption indexable_option = 5;

Returns
Type	Description
int	The enum numeric value on the wire for indexableOption.

getKey()

public String getKey()

Required. Attribute name. For example: color, brands, attributes.custom_attribute, such as attributes.xyz. To be indexable, the attribute name can contain only alpha-numeric characters and underscores. For example, an attribute named attributes.abc_xyz can be indexed, but an attribute named attributes.abc-xyz cannot be indexed.

If the attribute key starts with attributes., then the attribute is a custom attribute. Attributes such as brands, patterns, and title are built-in and called system attributes.

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

Returns
Type	Description
String	The key.

getKeyBytes()

public ByteString getKeyBytes()

Required. Attribute name. For example: color, brands, attributes.custom_attribute, such as attributes.xyz. To be indexable, the attribute name can contain only alpha-numeric characters and underscores. For example, an attribute named attributes.abc_xyz can be indexed, but an attribute named attributes.abc-xyz cannot be indexed.

If the attribute key starts with attributes., then the attribute is a custom attribute. Attributes such as brands, patterns, and title are built-in and called system attributes.

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

Returns
Type	Description
ByteString	The bytes for key.

getRetrievableOption()

public CatalogAttribute.RetrievableOption getRetrievableOption()

If RETRIEVABLE_ENABLED, attribute values are retrievable in the search results. If unset, the server behavior defaults to RETRIEVABLE_DISABLED.

.google.cloud.retail.v2.CatalogAttribute.RetrievableOption retrievable_option = 12;

Returns
Type	Description
CatalogAttribute.RetrievableOption	The retrievableOption.

getRetrievableOptionValue()

public int getRetrievableOptionValue()

If RETRIEVABLE_ENABLED, attribute values are retrievable in the search results. If unset, the server behavior defaults to RETRIEVABLE_DISABLED.

.google.cloud.retail.v2.CatalogAttribute.RetrievableOption retrievable_option = 12;

Returns
Type	Description
int	The enum numeric value on the wire for retrievableOption.

getSearchableOption()

public CatalogAttribute.SearchableOption getSearchableOption()

When AttributesConfig.attribute_config_level is CATALOG_LEVEL_ATTRIBUTE_CONFIG, if SEARCHABLE_ENABLED, attribute values are searchable by text queries in SearchService.Search.

If SEARCHABLE_ENABLED but attribute type is numerical, attribute values will not be searchable by text queries in SearchService.Search, as there are no text values associated to numerical attributes.

Must be specified, when AttributesConfig.attribute_config_level is CATALOG_LEVEL_ATTRIBUTE_CONFIG, otherwise throws INVALID_FORMAT error.

.google.cloud.retail.v2.CatalogAttribute.SearchableOption searchable_option = 7;

Returns
Type	Description
CatalogAttribute.SearchableOption	The searchableOption.

getSearchableOptionValue()

public int getSearchableOptionValue()

When AttributesConfig.attribute_config_level is CATALOG_LEVEL_ATTRIBUTE_CONFIG, if SEARCHABLE_ENABLED, attribute values are searchable by text queries in SearchService.Search.

If SEARCHABLE_ENABLED but attribute type is numerical, attribute values will not be searchable by text queries in SearchService.Search, as there are no text values associated to numerical attributes.

Must be specified, when AttributesConfig.attribute_config_level is CATALOG_LEVEL_ATTRIBUTE_CONFIG, otherwise throws INVALID_FORMAT error.

.google.cloud.retail.v2.CatalogAttribute.SearchableOption searchable_option = 7;

Returns
Type	Description
int	The enum numeric value on the wire for searchableOption.

getType()

public CatalogAttribute.AttributeType getType()

Output only. The type of this attribute. This is derived from the attribute in Product.attributes.

.google.cloud.retail.v2.CatalogAttribute.AttributeType type = 10 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type	Description
CatalogAttribute.AttributeType	The type.

getTypeValue()

public int getTypeValue()

Output only. The type of this attribute. This is derived from the attribute in Product.attributes.

.google.cloud.retail.v2.CatalogAttribute.AttributeType type = 10 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
Type	Description
int	The enum numeric value on the wire for type.

hasFacetConfig()

public boolean hasFacetConfig()

Contains facet options.

.google.cloud.retail.v2.CatalogAttribute.FacetConfig facet_config = 13;

Returns
Type	Description
boolean	Whether the facetConfig field is set.

internalGetFieldAccessorTable()

protected GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()

Returns
Type	Description
FieldAccessorTable

Overrides

GeneratedMessageV3.Builder<BuilderType>.internalGetFieldAccessorTable()

isInitialized()

public final boolean isInitialized()

Returns
Type	Description
boolean

Overrides

GeneratedMessageV3.Builder<BuilderType>.isInitialized()

mergeFacetConfig(CatalogAttribute.FacetConfig value)

public CatalogAttribute.Builder mergeFacetConfig(CatalogAttribute.FacetConfig value)

Contains facet options.

.google.cloud.retail.v2.CatalogAttribute.FacetConfig facet_config = 13;

Parameter
Name	Description
value	CatalogAttribute.FacetConfig

Returns
Type	Description
CatalogAttribute.Builder

mergeFrom(CatalogAttribute other)

public CatalogAttribute.Builder mergeFrom(CatalogAttribute other)

Parameter
Name	Description
other	CatalogAttribute

Returns
Type	Description
CatalogAttribute.Builder

mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)

public CatalogAttribute.Builder mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)

Parameters
Name	Description
input	CodedInputStream
extensionRegistry	ExtensionRegistryLite

Returns
Type	Description
CatalogAttribute.Builder

Overrides

AbstractMessage.Builder<BuilderType>.mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)

Exceptions
Type	Description
IOException

mergeFrom(Message other)

public CatalogAttribute.Builder mergeFrom(Message other)

Parameter
Name	Description
other	Message

Returns
Type	Description
CatalogAttribute.Builder

Overrides

AbstractMessage.Builder<BuilderType>.mergeFrom(Message other)

mergeUnknownFields(UnknownFieldSet unknownFields)

public final CatalogAttribute.Builder mergeUnknownFields(UnknownFieldSet unknownFields)

Parameter
Name	Description
unknownFields	UnknownFieldSet

Returns
Type	Description
CatalogAttribute.Builder

Overrides

GeneratedMessageV3.Builder<BuilderType>.mergeUnknownFields(UnknownFieldSet unknownFields)

setDynamicFacetableOption(CatalogAttribute.DynamicFacetableOption value)

public CatalogAttribute.Builder setDynamicFacetableOption(CatalogAttribute.DynamicFacetableOption value)

If DYNAMIC_FACETABLE_ENABLED, attribute values are available for dynamic facet. Could only be DYNAMIC_FACETABLE_DISABLED if CatalogAttribute.indexable_option is INDEXABLE_DISABLED. Otherwise, an INVALID_ARGUMENT error is returned.

Must be specified, otherwise throws INVALID_FORMAT error.

.google.cloud.retail.v2.CatalogAttribute.DynamicFacetableOption dynamic_facetable_option = 6;

Parameter
Name	Description
value	CatalogAttribute.DynamicFacetableOption The dynamicFacetableOption to set.

Returns
Type	Description
CatalogAttribute.Builder	This builder for chaining.

setDynamicFacetableOptionValue(int value)

public CatalogAttribute.Builder setDynamicFacetableOptionValue(int value)

If DYNAMIC_FACETABLE_ENABLED, attribute values are available for dynamic facet. Could only be DYNAMIC_FACETABLE_DISABLED if CatalogAttribute.indexable_option is INDEXABLE_DISABLED. Otherwise, an INVALID_ARGUMENT error is returned.

Must be specified, otherwise throws INVALID_FORMAT error.

.google.cloud.retail.v2.CatalogAttribute.DynamicFacetableOption dynamic_facetable_option = 6;

Parameter
Name	Description
value	int The enum numeric value on the wire for dynamicFacetableOption to set.

Returns
Type	Description
CatalogAttribute.Builder	This builder for chaining.

setExactSearchableOption(CatalogAttribute.ExactSearchableOption value)

public CatalogAttribute.Builder setExactSearchableOption(CatalogAttribute.ExactSearchableOption value)

If EXACT_SEARCHABLE_ENABLED, attribute values will be exact searchable. This property only applies to textual custom attributes and requires indexable set to enabled to enable exact-searchable. If unset, the server behavior defaults to EXACT_SEARCHABLE_DISABLED.

.google.cloud.retail.v2.CatalogAttribute.ExactSearchableOption exact_searchable_option = 11;

Parameter
Name	Description
value	CatalogAttribute.ExactSearchableOption The exactSearchableOption to set.

Returns
Type	Description
CatalogAttribute.Builder	This builder for chaining.

setExactSearchableOptionValue(int value)

public CatalogAttribute.Builder setExactSearchableOptionValue(int value)

If EXACT_SEARCHABLE_ENABLED, attribute values will be exact searchable. This property only applies to textual custom attributes and requires indexable set to enabled to enable exact-searchable. If unset, the server behavior defaults to EXACT_SEARCHABLE_DISABLED.

.google.cloud.retail.v2.CatalogAttribute.ExactSearchableOption exact_searchable_option = 11;

Parameter
Name	Description
value	int The enum numeric value on the wire for exactSearchableOption to set.

Returns
Type	Description
CatalogAttribute.Builder	This builder for chaining.

setFacetConfig(CatalogAttribute.FacetConfig value)

public CatalogAttribute.Builder setFacetConfig(CatalogAttribute.FacetConfig value)

Contains facet options.

.google.cloud.retail.v2.CatalogAttribute.FacetConfig facet_config = 13;

Parameter
Name	Description
value	CatalogAttribute.FacetConfig

Returns
Type	Description
CatalogAttribute.Builder

setFacetConfig(CatalogAttribute.FacetConfig.Builder builderForValue)

public CatalogAttribute.Builder setFacetConfig(CatalogAttribute.FacetConfig.Builder builderForValue)

Contains facet options.

.google.cloud.retail.v2.CatalogAttribute.FacetConfig facet_config = 13;

Parameter
Name	Description
builderForValue	CatalogAttribute.FacetConfig.Builder

Returns
Type	Description
CatalogAttribute.Builder

setField(Descriptors.FieldDescriptor field, Object value)

public CatalogAttribute.Builder setField(Descriptors.FieldDescriptor field, Object value)

Parameters
Name	Description
field	FieldDescriptor
value	Object

Returns
Type	Description
CatalogAttribute.Builder

Overrides

GeneratedMessageV3.Builder<BuilderType>.setField(Descriptors.FieldDescriptor field, Object value)

setInUse(boolean value)

public CatalogAttribute.Builder setInUse(boolean value)

Output only. Indicates whether this attribute has been used by any products. True if at least one Product is using this attribute in Product.attributes. Otherwise, this field is False.

CatalogAttribute can be pre-loaded by using CatalogService.AddCatalogAttribute, [CatalogService.ImportCatalogAttributes][], or CatalogService.UpdateAttributesConfig APIs. This field is False for pre-loaded CatalogAttributes.

Only pre-loaded catalog attributes that are neither in use by products nor predefined can be deleted. Catalog attributes that are either in use by products or are predefined attributes cannot be deleted; however, their configuration properties will reset to default values upon removal request.

After catalog changes, it takes about 10 minutes for this field to update.

bool in_use = 9 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name	Description
value	boolean The inUse to set.

Returns
Type	Description
CatalogAttribute.Builder	This builder for chaining.

setIndexableOption(CatalogAttribute.IndexableOption value)

public CatalogAttribute.Builder setIndexableOption(CatalogAttribute.IndexableOption value)

When AttributesConfig.attribute_config_level is CATALOG_LEVEL_ATTRIBUTE_CONFIG, if INDEXABLE_ENABLED attribute values are indexed so that it can be filtered, faceted, or boosted in SearchService.Search.

Must be specified when AttributesConfig.attribute_config_level is CATALOG_LEVEL_ATTRIBUTE_CONFIG, otherwise throws INVALID_FORMAT error.

.google.cloud.retail.v2.CatalogAttribute.IndexableOption indexable_option = 5;

Parameter
Name	Description
value	CatalogAttribute.IndexableOption The indexableOption to set.

Returns
Type	Description
CatalogAttribute.Builder	This builder for chaining.

setIndexableOptionValue(int value)

public CatalogAttribute.Builder setIndexableOptionValue(int value)

When AttributesConfig.attribute_config_level is CATALOG_LEVEL_ATTRIBUTE_CONFIG, if INDEXABLE_ENABLED attribute values are indexed so that it can be filtered, faceted, or boosted in SearchService.Search.

Must be specified when AttributesConfig.attribute_config_level is CATALOG_LEVEL_ATTRIBUTE_CONFIG, otherwise throws INVALID_FORMAT error.

.google.cloud.retail.v2.CatalogAttribute.IndexableOption indexable_option = 5;

Parameter
Name	Description
value	int The enum numeric value on the wire for indexableOption to set.

Returns
Type	Description
CatalogAttribute.Builder	This builder for chaining.

setKey(String value)

public CatalogAttribute.Builder setKey(String value)

Required. Attribute name. For example: color, brands, attributes.custom_attribute, such as attributes.xyz. To be indexable, the attribute name can contain only alpha-numeric characters and underscores. For example, an attribute named attributes.abc_xyz can be indexed, but an attribute named attributes.abc-xyz cannot be indexed.

If the attribute key starts with attributes., then the attribute is a custom attribute. Attributes such as brands, patterns, and title are built-in and called system attributes.

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

Parameter
Name	Description
value	String The key to set.

Returns
Type	Description
CatalogAttribute.Builder	This builder for chaining.

setKeyBytes(ByteString value)

public CatalogAttribute.Builder setKeyBytes(ByteString value)

Required. Attribute name. For example: color, brands, attributes.custom_attribute, such as attributes.xyz. To be indexable, the attribute name can contain only alpha-numeric characters and underscores. For example, an attribute named attributes.abc_xyz can be indexed, but an attribute named attributes.abc-xyz cannot be indexed.

If the attribute key starts with attributes., then the attribute is a custom attribute. Attributes such as brands, patterns, and title are built-in and called system attributes.

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

Parameter
Name	Description
value	ByteString The bytes for key to set.

Returns
Type	Description
CatalogAttribute.Builder	This builder for chaining.

setRepeatedField(Descriptors.FieldDescriptor field, int index, Object value)

public CatalogAttribute.Builder setRepeatedField(Descriptors.FieldDescriptor field, int index, Object value)

Parameters
Name	Description
field	FieldDescriptor
index	int
value	Object

Returns
Type	Description
CatalogAttribute.Builder

Overrides

GeneratedMessageV3.Builder<BuilderType>.setRepeatedField(Descriptors.FieldDescriptor field, int index, Object value)

setRetrievableOption(CatalogAttribute.RetrievableOption value)

public CatalogAttribute.Builder setRetrievableOption(CatalogAttribute.RetrievableOption value)

If RETRIEVABLE_ENABLED, attribute values are retrievable in the search results. If unset, the server behavior defaults to RETRIEVABLE_DISABLED.

.google.cloud.retail.v2.CatalogAttribute.RetrievableOption retrievable_option = 12;

Parameter
Name	Description
value	CatalogAttribute.RetrievableOption The retrievableOption to set.

Returns
Type	Description
CatalogAttribute.Builder	This builder for chaining.

setRetrievableOptionValue(int value)

public CatalogAttribute.Builder setRetrievableOptionValue(int value)

If RETRIEVABLE_ENABLED, attribute values are retrievable in the search results. If unset, the server behavior defaults to RETRIEVABLE_DISABLED.

.google.cloud.retail.v2.CatalogAttribute.RetrievableOption retrievable_option = 12;

Parameter
Name	Description
value	int The enum numeric value on the wire for retrievableOption to set.

Returns
Type	Description
CatalogAttribute.Builder	This builder for chaining.

setSearchableOption(CatalogAttribute.SearchableOption value)

public CatalogAttribute.Builder setSearchableOption(CatalogAttribute.SearchableOption value)

When AttributesConfig.attribute_config_level is CATALOG_LEVEL_ATTRIBUTE_CONFIG, if SEARCHABLE_ENABLED, attribute values are searchable by text queries in SearchService.Search.

If SEARCHABLE_ENABLED but attribute type is numerical, attribute values will not be searchable by text queries in SearchService.Search, as there are no text values associated to numerical attributes.

Must be specified, when AttributesConfig.attribute_config_level is CATALOG_LEVEL_ATTRIBUTE_CONFIG, otherwise throws INVALID_FORMAT error.

.google.cloud.retail.v2.CatalogAttribute.SearchableOption searchable_option = 7;

Parameter
Name	Description
value	CatalogAttribute.SearchableOption The searchableOption to set.

Returns
Type	Description
CatalogAttribute.Builder	This builder for chaining.

setSearchableOptionValue(int value)

public CatalogAttribute.Builder setSearchableOptionValue(int value)

When AttributesConfig.attribute_config_level is CATALOG_LEVEL_ATTRIBUTE_CONFIG, if SEARCHABLE_ENABLED, attribute values are searchable by text queries in SearchService.Search.

If SEARCHABLE_ENABLED but attribute type is numerical, attribute values will not be searchable by text queries in SearchService.Search, as there are no text values associated to numerical attributes.

Must be specified, when AttributesConfig.attribute_config_level is CATALOG_LEVEL_ATTRIBUTE_CONFIG, otherwise throws INVALID_FORMAT error.

.google.cloud.retail.v2.CatalogAttribute.SearchableOption searchable_option = 7;

Parameter
Name	Description
value	int The enum numeric value on the wire for searchableOption to set.

Returns
Type	Description
CatalogAttribute.Builder	This builder for chaining.

setType(CatalogAttribute.AttributeType value)

public CatalogAttribute.Builder setType(CatalogAttribute.AttributeType value)

Output only. The type of this attribute. This is derived from the attribute in Product.attributes.

.google.cloud.retail.v2.CatalogAttribute.AttributeType type = 10 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name	Description
value	CatalogAttribute.AttributeType The type to set.

Returns
Type	Description
CatalogAttribute.Builder	This builder for chaining.

setTypeValue(int value)

public CatalogAttribute.Builder setTypeValue(int value)

Output only. The type of this attribute. This is derived from the attribute in Product.attributes.

.google.cloud.retail.v2.CatalogAttribute.AttributeType type = 10 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
Name	Description
value	int The enum numeric value on the wire for type to set.

Returns
Type	Description
CatalogAttribute.Builder	This builder for chaining.

setUnknownFields(UnknownFieldSet unknownFields)

public final CatalogAttribute.Builder setUnknownFields(UnknownFieldSet unknownFields)

Parameter
Name	Description
unknownFields	UnknownFieldSet

Returns
Type	Description
CatalogAttribute.Builder

Overrides

GeneratedMessageV3.Builder<BuilderType>.setUnknownFields(UnknownFieldSet unknownFields)