Class CatalogAttribute.Builder (2.6.0)

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.v2alpha.CatalogAttribute

Static Methods

getDescriptor()

public static final Descriptors.Descriptor getDescriptor()
Returns
TypeDescription
Descriptor

Methods

addRepeatedField(Descriptors.FieldDescriptor field, Object value)

public CatalogAttribute.Builder addRepeatedField(Descriptors.FieldDescriptor field, Object value)
Parameters
NameDescription
fieldFieldDescriptor
valueObject
Returns
TypeDescription
CatalogAttribute.Builder
Overrides

build()

public CatalogAttribute build()
Returns
TypeDescription
CatalogAttribute

buildPartial()

public CatalogAttribute buildPartial()
Returns
TypeDescription
CatalogAttribute

clear()

public CatalogAttribute.Builder clear()
Returns
TypeDescription
CatalogAttribute.Builder
Overrides

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.

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

Returns
TypeDescription
CatalogAttribute.Builder

This builder for chaining.

clearField(Descriptors.FieldDescriptor field)

public CatalogAttribute.Builder clearField(Descriptors.FieldDescriptor field)
Parameter
NameDescription
fieldFieldDescriptor
Returns
TypeDescription
CatalogAttribute.Builder
Overrides

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 CatalogAttributes that are neither in use by products nor predefined can be deleted. CatalogAttributes that are either in use by products or are predefined 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
TypeDescription
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.

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

Returns
TypeDescription
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.

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

Returns
TypeDescription
CatalogAttribute.Builder

This builder for chaining.

clearOneof(Descriptors.OneofDescriptor oneof)

public CatalogAttribute.Builder clearOneof(Descriptors.OneofDescriptor oneof)
Parameter
NameDescription
oneofOneofDescriptor
Returns
TypeDescription
CatalogAttribute.Builder
Overrides

clearRecommendationsFilteringOption()

public CatalogAttribute.Builder clearRecommendationsFilteringOption()

When AttributesConfig.attribute_config_level is CATALOG_LEVEL_ATTRIBUTE_CONFIG, if RECOMMENDATIONS_FILTERING_ENABLED, attribute values are filterable for recommendations. This option works for categorical features only, does not work for numerical features, inventory filtering.

.google.cloud.retail.v2alpha.RecommendationsFilteringOption recommendations_filtering_option = 8;

Returns
TypeDescription
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.

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

Returns
TypeDescription
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.v2alpha.CatalogAttribute.AttributeType type = 10 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
TypeDescription
CatalogAttribute.Builder

This builder for chaining.

clone()

public CatalogAttribute.Builder clone()
Returns
TypeDescription
CatalogAttribute.Builder
Overrides

getDefaultInstanceForType()

public CatalogAttribute getDefaultInstanceForType()
Returns
TypeDescription
CatalogAttribute

getDescriptorForType()

public Descriptors.Descriptor getDescriptorForType()
Returns
TypeDescription
Descriptor
Overrides

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.

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

Returns
TypeDescription
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.

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

Returns
TypeDescription
int

The enum numeric value on the wire for dynamicFacetableOption.

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 CatalogAttributes that are neither in use by products nor predefined can be deleted. CatalogAttributes that are either in use by products or are predefined 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
TypeDescription
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.

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

Returns
TypeDescription
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.

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

Returns
TypeDescription
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.

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

Returns
TypeDescription
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.

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

Returns
TypeDescription
ByteString

The bytes for key.

getRecommendationsFilteringOption()

public RecommendationsFilteringOption getRecommendationsFilteringOption()

When AttributesConfig.attribute_config_level is CATALOG_LEVEL_ATTRIBUTE_CONFIG, if RECOMMENDATIONS_FILTERING_ENABLED, attribute values are filterable for recommendations. This option works for categorical features only, does not work for numerical features, inventory filtering.

.google.cloud.retail.v2alpha.RecommendationsFilteringOption recommendations_filtering_option = 8;

Returns
TypeDescription
RecommendationsFilteringOption

The recommendationsFilteringOption.

getRecommendationsFilteringOptionValue()

public int getRecommendationsFilteringOptionValue()

When AttributesConfig.attribute_config_level is CATALOG_LEVEL_ATTRIBUTE_CONFIG, if RECOMMENDATIONS_FILTERING_ENABLED, attribute values are filterable for recommendations. This option works for categorical features only, does not work for numerical features, inventory filtering.

.google.cloud.retail.v2alpha.RecommendationsFilteringOption recommendations_filtering_option = 8;

Returns
TypeDescription
int

The enum numeric value on the wire for recommendationsFilteringOption.

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.

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

Returns
TypeDescription
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.

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

Returns
TypeDescription
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.v2alpha.CatalogAttribute.AttributeType type = 10 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
TypeDescription
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.v2alpha.CatalogAttribute.AttributeType type = 10 [(.google.api.field_behavior) = OUTPUT_ONLY];

Returns
TypeDescription
int

The enum numeric value on the wire for type.

internalGetFieldAccessorTable()

protected GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()
Returns
TypeDescription
FieldAccessorTable
Overrides

isInitialized()

public final boolean isInitialized()
Returns
TypeDescription
boolean
Overrides

mergeFrom(CatalogAttribute other)

public CatalogAttribute.Builder mergeFrom(CatalogAttribute other)
Parameter
NameDescription
otherCatalogAttribute
Returns
TypeDescription
CatalogAttribute.Builder

mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)

public CatalogAttribute.Builder mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
NameDescription
inputCodedInputStream
extensionRegistryExtensionRegistryLite
Returns
TypeDescription
CatalogAttribute.Builder
Overrides Exceptions
TypeDescription
IOException

mergeFrom(Message other)

public CatalogAttribute.Builder mergeFrom(Message other)
Parameter
NameDescription
otherMessage
Returns
TypeDescription
CatalogAttribute.Builder
Overrides

mergeUnknownFields(UnknownFieldSet unknownFields)

public final CatalogAttribute.Builder mergeUnknownFields(UnknownFieldSet unknownFields)
Parameter
NameDescription
unknownFieldsUnknownFieldSet
Returns
TypeDescription
CatalogAttribute.Builder
Overrides

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.

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

Parameter
NameDescription
valueCatalogAttribute.DynamicFacetableOption

The dynamicFacetableOption to set.

Returns
TypeDescription
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.

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

Parameter
NameDescription
valueint

The enum numeric value on the wire for dynamicFacetableOption to set.

Returns
TypeDescription
CatalogAttribute.Builder

This builder for chaining.

setField(Descriptors.FieldDescriptor field, Object value)

public CatalogAttribute.Builder setField(Descriptors.FieldDescriptor field, Object value)
Parameters
NameDescription
fieldFieldDescriptor
valueObject
Returns
TypeDescription
CatalogAttribute.Builder
Overrides

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 CatalogAttributes that are neither in use by products nor predefined can be deleted. CatalogAttributes that are either in use by products or are predefined 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
NameDescription
valueboolean

The inUse to set.

Returns
TypeDescription
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.

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

Parameter
NameDescription
valueCatalogAttribute.IndexableOption

The indexableOption to set.

Returns
TypeDescription
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.

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

Parameter
NameDescription
valueint

The enum numeric value on the wire for indexableOption to set.

Returns
TypeDescription
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.

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

Parameter
NameDescription
valueString

The key to set.

Returns
TypeDescription
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.

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

Parameter
NameDescription
valueByteString

The bytes for key to set.

Returns
TypeDescription
CatalogAttribute.Builder

This builder for chaining.

setRecommendationsFilteringOption(RecommendationsFilteringOption value)

public CatalogAttribute.Builder setRecommendationsFilteringOption(RecommendationsFilteringOption value)

When AttributesConfig.attribute_config_level is CATALOG_LEVEL_ATTRIBUTE_CONFIG, if RECOMMENDATIONS_FILTERING_ENABLED, attribute values are filterable for recommendations. This option works for categorical features only, does not work for numerical features, inventory filtering.

.google.cloud.retail.v2alpha.RecommendationsFilteringOption recommendations_filtering_option = 8;

Parameter
NameDescription
valueRecommendationsFilteringOption

The recommendationsFilteringOption to set.

Returns
TypeDescription
CatalogAttribute.Builder

This builder for chaining.

setRecommendationsFilteringOptionValue(int value)

public CatalogAttribute.Builder setRecommendationsFilteringOptionValue(int value)

When AttributesConfig.attribute_config_level is CATALOG_LEVEL_ATTRIBUTE_CONFIG, if RECOMMENDATIONS_FILTERING_ENABLED, attribute values are filterable for recommendations. This option works for categorical features only, does not work for numerical features, inventory filtering.

.google.cloud.retail.v2alpha.RecommendationsFilteringOption recommendations_filtering_option = 8;

Parameter
NameDescription
valueint

The enum numeric value on the wire for recommendationsFilteringOption to set.

Returns
TypeDescription
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
NameDescription
fieldFieldDescriptor
indexint
valueObject
Returns
TypeDescription
CatalogAttribute.Builder
Overrides

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.

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

Parameter
NameDescription
valueCatalogAttribute.SearchableOption

The searchableOption to set.

Returns
TypeDescription
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.

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

Parameter
NameDescription
valueint

The enum numeric value on the wire for searchableOption to set.

Returns
TypeDescription
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.v2alpha.CatalogAttribute.AttributeType type = 10 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
NameDescription
valueCatalogAttribute.AttributeType

The type to set.

Returns
TypeDescription
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.v2alpha.CatalogAttribute.AttributeType type = 10 [(.google.api.field_behavior) = OUTPUT_ONLY];

Parameter
NameDescription
valueint

The enum numeric value on the wire for type to set.

Returns
TypeDescription
CatalogAttribute.Builder

This builder for chaining.

setUnknownFields(UnknownFieldSet unknownFields)

public final CatalogAttribute.Builder setUnknownFields(UnknownFieldSet unknownFields)
Parameter
NameDescription
unknownFieldsUnknownFieldSet
Returns
TypeDescription
CatalogAttribute.Builder
Overrides