# Class Attributes.Builder (1.21.0)

1.21.0 (latest) 1.19.0 1.16.0 1.15.0 1.13.0 1.11.0 1.10.0 1.8.0 1.6.0 1.4.0 1.3.0 1.2.0 1.1.0 1.0.0 0.26.0 0.24.0 0.23.0 0.20.0 0.19.0 0.18.0 0.16.0 0.15.0 0.14.0 0.13.0 0.12.0 0.11.0 0.10.0 0.9.0 0.8.0 0.7.0 0.5.0 0.4.0 0.3.0 0.2.0 0.1.0

    public static final class Attributes.Builder extends GeneratedMessage.Builder<Attributes.Builder> implements AttributesOrBuilder

Attributes.

Protobuf type `google.shopping.merchant.promotions.v1.Attributes`

## Inheritance

[java.lang.Object](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html) \> [AbstractMessageLite.Builder\<MessageType,BuilderType\>](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.AbstractMessageLite.Builder.html) \> [AbstractMessage.Builder\<BuilderType\>](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.AbstractMessage.Builder.html) \> [GeneratedMessage.Builder](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.GeneratedMessage.Builder.html) \> Attributes.Builder

## Implements

[AttributesOrBuilder](https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.AttributesOrBuilder)

## Inherited Members

[AbstractMessage.Builder.findInitializationErrors()](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.AbstractMessage.Builder.html#com_google_protobuf_AbstractMessage_Builder_findInitializationErrors__) [AbstractMessage.Builder.getInitializationErrorString()](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.AbstractMessage.Builder.html#com_google_protobuf_AbstractMessage_Builder_getInitializationErrorString__) [AbstractMessage.Builder.internalMergeFrom(AbstractMessageLite)](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.AbstractMessage.Builder.html#com_google_protobuf_AbstractMessage_Builder_internalMergeFrom_com_google_protobuf_AbstractMessageLite_) [AbstractMessage.Builder.mergeFrom(byte\[\])](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.AbstractMessage.Builder.html#com_google_protobuf_AbstractMessage_Builder_mergeFrom_byte___) [AbstractMessage.Builder.mergeFrom(byte\[\],ExtensionRegistryLite)](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.AbstractMessage.Builder.html#com_google_protobuf_AbstractMessage_Builder_mergeFrom_byte___com_google_protobuf_ExtensionRegistryLite_) [AbstractMessage.Builder.mergeFrom(byte\[\],int,int)](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.AbstractMessage.Builder.html#com_google_protobuf_AbstractMessage_Builder_mergeFrom_byte___int_int_) [AbstractMessage.Builder.mergeFrom(byte\[\],int,int,ExtensionRegistryLite)](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.AbstractMessage.Builder.html#com_google_protobuf_AbstractMessage_Builder_mergeFrom_byte___int_int_com_google_protobuf_ExtensionRegistryLite_) [AbstractMessage.Builder.mergeFrom(ByteString)](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.AbstractMessage.Builder.html#com_google_protobuf_AbstractMessage_Builder_mergeFrom_com_google_protobuf_ByteString_) [AbstractMessage.Builder.mergeFrom(ByteString,ExtensionRegistryLite)](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.AbstractMessage.Builder.html#com_google_protobuf_AbstractMessage_Builder_mergeFrom_com_google_protobuf_ByteString_com_google_protobuf_ExtensionRegistryLite_) [AbstractMessage.Builder.mergeFrom(CodedInputStream)](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.AbstractMessage.Builder.html#com_google_protobuf_AbstractMessage_Builder_mergeFrom_com_google_protobuf_CodedInputStream_) [AbstractMessage.Builder.mergeFrom(CodedInputStream,ExtensionRegistryLite)](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.AbstractMessage.Builder.html#com_google_protobuf_AbstractMessage_Builder_mergeFrom_com_google_protobuf_CodedInputStream_com_google_protobuf_ExtensionRegistryLite_) [AbstractMessage.Builder.mergeFrom(Message)](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.AbstractMessage.Builder.html#com_google_protobuf_AbstractMessage_Builder_mergeFrom_com_google_protobuf_Message_) [AbstractMessage.Builder.mergeFrom(InputStream)](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.AbstractMessage.Builder.html#com_google_protobuf_AbstractMessage_Builder_mergeFrom_java_io_InputStream_) [AbstractMessage.Builder.mergeFrom(InputStream,ExtensionRegistryLite)](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.AbstractMessage.Builder.html#com_google_protobuf_AbstractMessage_Builder_mergeFrom_java_io_InputStream_com_google_protobuf_ExtensionRegistryLite_) [AbstractMessage.Builder.newUninitializedMessageException(Message)](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.AbstractMessage.Builder.html#com_google_protobuf_AbstractMessage_Builder_newUninitializedMessageException_com_google_protobuf_Message_) [AbstractMessage.Builder.toString()](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.AbstractMessage.Builder.html#com_google_protobuf_AbstractMessage_Builder_toString__) [AbstractMessageLite.Builder.\<T\>addAll(Iterable\<T\>,Collection\<? super T\>)](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.AbstractMessageLite.Builder.html#com_google_protobuf_AbstractMessageLite_Builder__T_addAll_java_lang_Iterable_T__java_util_Collection___super_T__) [AbstractMessageLite.Builder.\<T\>addAll(Iterable\<T\>,List\<? super T\>)](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.AbstractMessageLite.Builder.html#com_google_protobuf_AbstractMessageLite_Builder__T_addAll_java_lang_Iterable_T__java_util_List___super_T__) [AbstractMessageLite.Builder.internalMergeFrom(MessageType)](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.AbstractMessageLite.Builder.html#com_google_protobuf_AbstractMessageLite_Builder_internalMergeFrom_MessageType_) [AbstractMessageLite.Builder.mergeDelimitedFrom(InputStream)](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.AbstractMessageLite.Builder.html#com_google_protobuf_AbstractMessageLite_Builder_mergeDelimitedFrom_java_io_InputStream_) [AbstractMessageLite.Builder.mergeDelimitedFrom(InputStream,ExtensionRegistryLite)](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.AbstractMessageLite.Builder.html#com_google_protobuf_AbstractMessageLite_Builder_mergeDelimitedFrom_java_io_InputStream_com_google_protobuf_ExtensionRegistryLite_) [AbstractMessageLite.Builder.mergeFrom(MessageLite)](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.AbstractMessageLite.Builder.html#com_google_protobuf_AbstractMessageLite_Builder_mergeFrom_com_google_protobuf_MessageLite_) [AbstractMessageLite.Builder.newUninitializedMessageException(MessageLite)](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.AbstractMessageLite.Builder.html#com_google_protobuf_AbstractMessageLite_Builder_newUninitializedMessageException_com_google_protobuf_MessageLite_) [GeneratedMessage.Builder.addRepeatedField(Descriptors.FieldDescriptor,Object)](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.GeneratedMessage.Builder.html#com_google_protobuf_GeneratedMessage_Builder_addRepeatedField_com_google_protobuf_Descriptors_FieldDescriptor_java_lang_Object_) [GeneratedMessage.Builder.clear()](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.GeneratedMessage.Builder.html#com_google_protobuf_GeneratedMessage_Builder_clear__) [GeneratedMessage.Builder.clearField(Descriptors.FieldDescriptor)](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.GeneratedMessage.Builder.html#com_google_protobuf_GeneratedMessage_Builder_clearField_com_google_protobuf_Descriptors_FieldDescriptor_) [GeneratedMessage.Builder.clearOneof(Descriptors.OneofDescriptor)](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.GeneratedMessage.Builder.html#com_google_protobuf_GeneratedMessage_Builder_clearOneof_com_google_protobuf_Descriptors_OneofDescriptor_) [GeneratedMessage.Builder.clone()](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.GeneratedMessage.Builder.html#com_google_protobuf_GeneratedMessage_Builder_clone__) [GeneratedMessage.Builder.getAllFields()](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.GeneratedMessage.Builder.html#com_google_protobuf_GeneratedMessage_Builder_getAllFields__) [GeneratedMessage.Builder.getDescriptorForType()](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.GeneratedMessage.Builder.html#com_google_protobuf_GeneratedMessage_Builder_getDescriptorForType__) [GeneratedMessage.Builder.getField(Descriptors.FieldDescriptor)](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.GeneratedMessage.Builder.html#com_google_protobuf_GeneratedMessage_Builder_getField_com_google_protobuf_Descriptors_FieldDescriptor_) [GeneratedMessage.Builder.getFieldBuilder(Descriptors.FieldDescriptor)](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.GeneratedMessage.Builder.html#com_google_protobuf_GeneratedMessage_Builder_getFieldBuilder_com_google_protobuf_Descriptors_FieldDescriptor_) [GeneratedMessage.Builder.getOneofFieldDescriptor(Descriptors.OneofDescriptor)](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.GeneratedMessage.Builder.html#com_google_protobuf_GeneratedMessage_Builder_getOneofFieldDescriptor_com_google_protobuf_Descriptors_OneofDescriptor_) [GeneratedMessage.Builder.getParentForChildren()](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.GeneratedMessage.Builder.html#com_google_protobuf_GeneratedMessage_Builder_getParentForChildren__) [GeneratedMessage.Builder.getRepeatedField(Descriptors.FieldDescriptor,int)](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.GeneratedMessage.Builder.html#com_google_protobuf_GeneratedMessage_Builder_getRepeatedField_com_google_protobuf_Descriptors_FieldDescriptor_int_) [GeneratedMessage.Builder.getRepeatedFieldBuilder(Descriptors.FieldDescriptor,int)](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.GeneratedMessage.Builder.html#com_google_protobuf_GeneratedMessage_Builder_getRepeatedFieldBuilder_com_google_protobuf_Descriptors_FieldDescriptor_int_) [GeneratedMessage.Builder.getRepeatedFieldCount(Descriptors.FieldDescriptor)](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.GeneratedMessage.Builder.html#com_google_protobuf_GeneratedMessage_Builder_getRepeatedFieldCount_com_google_protobuf_Descriptors_FieldDescriptor_) com.google.protobuf.GeneratedMessage.Builder.getUnknownFieldSetBuilder() [GeneratedMessage.Builder.getUnknownFields()](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.GeneratedMessage.Builder.html#com_google_protobuf_GeneratedMessage_Builder_getUnknownFields__) [GeneratedMessage.Builder.hasField(Descriptors.FieldDescriptor)](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.GeneratedMessage.Builder.html#com_google_protobuf_GeneratedMessage_Builder_hasField_com_google_protobuf_Descriptors_FieldDescriptor_) [GeneratedMessage.Builder.hasOneof(Descriptors.OneofDescriptor)](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.GeneratedMessage.Builder.html#com_google_protobuf_GeneratedMessage_Builder_hasOneof_com_google_protobuf_Descriptors_OneofDescriptor_) [GeneratedMessage.Builder.internalGetFieldAccessorTable()](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.GeneratedMessage.Builder.html#com_google_protobuf_GeneratedMessage_Builder_internalGetFieldAccessorTable__) [GeneratedMessage.Builder.internalGetMapField(int)](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.GeneratedMessage.Builder.html#com_google_protobuf_GeneratedMessage_Builder_internalGetMapField_int_) com.google.protobuf.GeneratedMessage.Builder.internalGetMapFieldReflection(int) [GeneratedMessage.Builder.internalGetMutableMapField(int)](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.GeneratedMessage.Builder.html#com_google_protobuf_GeneratedMessage_Builder_internalGetMutableMapField_int_) com.google.protobuf.GeneratedMessage.Builder.internalGetMutableMapFieldReflection(int) [GeneratedMessage.Builder.isClean()](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.GeneratedMessage.Builder.html#com_google_protobuf_GeneratedMessage_Builder_isClean__) [GeneratedMessage.Builder.isInitialized()](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.GeneratedMessage.Builder.html#com_google_protobuf_GeneratedMessage_Builder_isInitialized__) [GeneratedMessage.Builder.markClean()](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.GeneratedMessage.Builder.html#com_google_protobuf_GeneratedMessage_Builder_markClean__) [GeneratedMessage.Builder.mergeUnknownFields(UnknownFieldSet)](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.GeneratedMessage.Builder.html#com_google_protobuf_GeneratedMessage_Builder_mergeUnknownFields_com_google_protobuf_UnknownFieldSet_) com.google.protobuf.GeneratedMessage.Builder.mergeUnknownLengthDelimitedField(int,com.google.protobuf.ByteString) com.google.protobuf.GeneratedMessage.Builder.mergeUnknownVarintField(int,int) [GeneratedMessage.Builder.newBuilderForField(Descriptors.FieldDescriptor)](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.GeneratedMessage.Builder.html#com_google_protobuf_GeneratedMessage_Builder_newBuilderForField_com_google_protobuf_Descriptors_FieldDescriptor_) [GeneratedMessage.Builder.onBuilt()](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.GeneratedMessage.Builder.html#com_google_protobuf_GeneratedMessage_Builder_onBuilt__) [GeneratedMessage.Builder.onChanged()](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.GeneratedMessage.Builder.html#com_google_protobuf_GeneratedMessage_Builder_onChanged__) com.google.protobuf.GeneratedMessage.Builder.parseUnknownField(com.google.protobuf.CodedInputStream,com.google.protobuf.ExtensionRegistryLite,int) [GeneratedMessage.Builder.setField(Descriptors.FieldDescriptor,Object)](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.GeneratedMessage.Builder.html#com_google_protobuf_GeneratedMessage_Builder_setField_com_google_protobuf_Descriptors_FieldDescriptor_java_lang_Object_) [GeneratedMessage.Builder.setRepeatedField(Descriptors.FieldDescriptor,int,Object)](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.GeneratedMessage.Builder.html#com_google_protobuf_GeneratedMessage_Builder_setRepeatedField_com_google_protobuf_Descriptors_FieldDescriptor_int_java_lang_Object_) com.google.protobuf.GeneratedMessage.Builder.setUnknownFieldSetBuilder(com.google.protobuf.UnknownFieldSet.Builder) [GeneratedMessage.Builder.setUnknownFields(UnknownFieldSet)](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.GeneratedMessage.Builder.html#com_google_protobuf_GeneratedMessage_Builder_setUnknownFields_com_google_protobuf_UnknownFieldSet_) com.google.protobuf.GeneratedMessage.Builder.setUnknownFieldsProto3(com.google.protobuf.UnknownFieldSet) [Object.equals(Object)](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#equals-java.lang.Object-) [Object.finalize()](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#finalize--) [Object.getClass()](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#getClass--) [Object.hashCode()](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#hashCode--) [Object.notify()](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#notify--) [Object.notifyAll()](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#notifyAll--) [Object.wait()](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#wait--) [Object.wait(long)](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#wait-long-) [Object.wait(long,int)](https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html#wait-long-int-)

## Static Methods

### getDescriptor()

    public static final Descriptors.Descriptor getDescriptor()

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.Descriptors.Descriptor.html` |   |

## Methods

### addAllBrandExclusion(Iterable\<String\> values)

    public Attributes.Builder addAllBrandExclusion(Iterable<String> values)

Optional. Product filter by [brand
exclusion](https://support.google.com/merchants/answer/13861679?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion. The product filter attributes only applies when the
products eligible for promotion product applicability
`product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string brand_exclusion = 12 [(.google.api.field_behavior) = OPTIONAL];`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `values` | `https://docs.oracle.com/javase/8/docs/api/java/lang/Iterable.html<https://docs.oracle.com/javase/8/docs/api/java/lang/String.html>` The brandExclusion to add. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### addAllBrandInclusion(Iterable\<String\> values)

    public Attributes.Builder addAllBrandInclusion(Iterable<String> values)

Optional. Product filter by brand for the promotion. The product filter
attributes only applies when the products eligible for promotion product
applicability `product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string brand_inclusion = 8 [(.google.api.field_behavior) = OPTIONAL];`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `values` | `https://docs.oracle.com/javase/8/docs/api/java/lang/Iterable.html<https://docs.oracle.com/javase/8/docs/api/java/lang/String.html>` The brandInclusion to add. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### addAllItemGroupIdExclusion(Iterable\<String\> values)

    public Attributes.Builder addAllItemGroupIdExclusion(Iterable<String> values)

Optional. Product filter by [item group
ID](https://support.google.com/merchants/answer/13837298?ref_topic=13773355&sjid=17642868584668136159-NC).
The product filter attributes only applies when the products eligible for
promotion product applicability `product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).
exclusion for the promotion.

`repeated string item_group_id_exclusion = 13 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `values` | `https://docs.oracle.com/javase/8/docs/api/java/lang/Iterable.html<https://docs.oracle.com/javase/8/docs/api/java/lang/String.html>` The itemGroupIdExclusion to add. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### addAllItemGroupIdInclusion(Iterable\<String\> values)

    public Attributes.Builder addAllItemGroupIdInclusion(Iterable<String> values)

Optional. Product filter by item group ID for the promotion. The product
filter attributes only applies when the products eligible for promotion
product applicability \[product_applicability\] attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string item_group_id_inclusion = 9 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `values` | `https://docs.oracle.com/javase/8/docs/api/java/lang/Iterable.html<https://docs.oracle.com/javase/8/docs/api/java/lang/String.html>` The itemGroupIdInclusion to add. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### addAllItemIdExclusion(Iterable\<String\> values)

    public Attributes.Builder addAllItemIdExclusion(Iterable<String> values)

Optional. Product filter by [item ID
exclusion](https://support.google.com/merchants/answer/13863524?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion. The product filter attributes only applies when the
products eligible for promotion product applicability
`product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string item_id_exclusion = 11 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `values` | `https://docs.oracle.com/javase/8/docs/api/java/lang/Iterable.html<https://docs.oracle.com/javase/8/docs/api/java/lang/String.html>` The itemIdExclusion to add. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### addAllItemIdInclusion(Iterable\<String\> values)

    public Attributes.Builder addAllItemIdInclusion(Iterable<String> values)

Optional. Product filter by [item
ID](https://support.google.com/merchants/answer/13861565?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion. The product filter attributes only applies when the
products eligible for promotion product applicability
`product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string item_id_inclusion = 7 [(.google.api.field_behavior) = OPTIONAL];`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `values` | `https://docs.oracle.com/javase/8/docs/api/java/lang/Iterable.html<https://docs.oracle.com/javase/8/docs/api/java/lang/String.html>` The itemIdInclusion to add. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### addAllProductTypeExclusion(Iterable\<String\> values)

    public Attributes.Builder addAllProductTypeExclusion(Iterable<String> values)

Optional. Product filter by [product type
exclusion](https://support.google.com/merchants/answer/13863746?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion. The product filter attributes only applies when the
products eligible for promotion product applicability
`product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string product_type_exclusion = 14 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `values` | `https://docs.oracle.com/javase/8/docs/api/java/lang/Iterable.html<https://docs.oracle.com/javase/8/docs/api/java/lang/String.html>` The productTypeExclusion to add. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### addAllProductTypeInclusion(Iterable\<String\> values)

    public Attributes.Builder addAllProductTypeInclusion(Iterable<String> values)

Optional. Product filter by product type for the promotion. The product
filter attributes only applies when the products eligible for promotion
product applicability `product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string product_type_inclusion = 10 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `values` | `https://docs.oracle.com/javase/8/docs/api/java/lang/Iterable.html<https://docs.oracle.com/javase/8/docs/api/java/lang/String.html>` The productTypeInclusion to add. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### addAllPromotionDestinations(Iterable\<? extends Destination.DestinationEnum\> values)

    public Attributes.Builder addAllPromotionDestinations(Iterable<? extends Destination.DestinationEnum> values)

Required. The list of destinations (also known as [Marketing
methods](https://support.google.com/merchants/answer/15130232)) where the
promotion applies to. If you don't specify a destination by including a
supported value in your data source, your promotion will display in
Shopping ads and free listings by default.

You may have previously submitted the following values as destinations for
your products: Shopping Actions, Surfaces across Google, Local surfaces
across Google. To represent these values use `FREE_LISTINGS`,
`FREE_LOCAL_LISTINGS`, `LOCAL_INVENTORY_ADS`. For more details see
[Promotion
destination](https://support.google.com/merchants/answer/13837465?sjid=5155774230887277618-NC)

`
repeated .google.shopping.type.Destination.DestinationEnum promotion_destinations = 6 [(.google.api.field_behavior) = REQUIRED];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `values` | `https://docs.oracle.com/javase/8/docs/api/java/lang/Iterable.html<? extends com.google.shopping.type.Destination.DestinationEnum>` The promotionDestinations to add. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### addAllPromotionDestinationsValue(Iterable\<Integer\> values)

    public Attributes.Builder addAllPromotionDestinationsValue(Iterable<Integer> values)

Required. The list of destinations (also known as [Marketing
methods](https://support.google.com/merchants/answer/15130232)) where the
promotion applies to. If you don't specify a destination by including a
supported value in your data source, your promotion will display in
Shopping ads and free listings by default.

You may have previously submitted the following values as destinations for
your products: Shopping Actions, Surfaces across Google, Local surfaces
across Google. To represent these values use `FREE_LISTINGS`,
`FREE_LOCAL_LISTINGS`, `LOCAL_INVENTORY_ADS`. For more details see
[Promotion
destination](https://support.google.com/merchants/answer/13837465?sjid=5155774230887277618-NC)

`
repeated .google.shopping.type.Destination.DestinationEnum promotion_destinations = 6 [(.google.api.field_behavior) = REQUIRED];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `values` | `https://docs.oracle.com/javase/8/docs/api/java/lang/Iterable.html<https://docs.oracle.com/javase/8/docs/api/java/lang/Integer.html>` The enum numeric values on the wire for promotionDestinations to add. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### addAllStoreCodesExclusion(Iterable\<String\> values)

    public Attributes.Builder addAllStoreCodesExclusion(Iterable<String> values)

Optional. [Store codes to
exclude](https://support.google.com/merchants/answer/13859586?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion. The store filter attributes only applies when the
`store_applicability` attribute is set to
[specific_stores](https://support.google.com/merchants/answer/13857563?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string store_codes_exclusion = 30 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `values` | `https://docs.oracle.com/javase/8/docs/api/java/lang/Iterable.html<https://docs.oracle.com/javase/8/docs/api/java/lang/String.html>` The storeCodesExclusion to add. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### addAllStoreCodesInclusion(Iterable\<String\> values)

    public Attributes.Builder addAllStoreCodesInclusion(Iterable<String> values)

Optional. [Store codes to
include](https://support.google.com/merchants/answer/13857470?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion. The store filter attributes only applies when the
`store_applicability` attribute is set to
[specific_stores](https://support.google.com/merchants/answer/13857563?ref_topic=13773355&sjid=17642868584668136159-NC).

Store code (the store ID from
your Business Profile) of the physical store the product is sold in. See
the [Local product inventory data
specification](https://support.google.com/merchants/answer/3061342) for
more information.

`repeated string store_codes_inclusion = 29 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `values` | `https://docs.oracle.com/javase/8/docs/api/java/lang/Iterable.html<https://docs.oracle.com/javase/8/docs/api/java/lang/String.html>` The storeCodesInclusion to add. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### addBrandExclusion(String value)

    public Attributes.Builder addBrandExclusion(String value)

Optional. Product filter by [brand
exclusion](https://support.google.com/merchants/answer/13861679?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion. The product filter attributes only applies when the
products eligible for promotion product applicability
`product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string brand_exclusion = 12 [(.google.api.field_behavior) = OPTIONAL];`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `value` | `https://docs.oracle.com/javase/8/docs/api/java/lang/String.html` The brandExclusion to add. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### addBrandExclusionBytes(ByteString value)

    public Attributes.Builder addBrandExclusionBytes(ByteString value)

Optional. Product filter by [brand
exclusion](https://support.google.com/merchants/answer/13861679?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion. The product filter attributes only applies when the
products eligible for promotion product applicability
`product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string brand_exclusion = 12 [(.google.api.field_behavior) = OPTIONAL];`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `value` | `https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.ByteString.html` The bytes of the brandExclusion to add. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### addBrandInclusion(String value)

    public Attributes.Builder addBrandInclusion(String value)

Optional. Product filter by brand for the promotion. The product filter
attributes only applies when the products eligible for promotion product
applicability `product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string brand_inclusion = 8 [(.google.api.field_behavior) = OPTIONAL];`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `value` | `https://docs.oracle.com/javase/8/docs/api/java/lang/String.html` The brandInclusion to add. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### addBrandInclusionBytes(ByteString value)

    public Attributes.Builder addBrandInclusionBytes(ByteString value)

Optional. Product filter by brand for the promotion. The product filter
attributes only applies when the products eligible for promotion product
applicability `product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string brand_inclusion = 8 [(.google.api.field_behavior) = OPTIONAL];`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `value` | `https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.ByteString.html` The bytes of the brandInclusion to add. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### addItemGroupIdExclusion(String value)

    public Attributes.Builder addItemGroupIdExclusion(String value)

Optional. Product filter by [item group
ID](https://support.google.com/merchants/answer/13837298?ref_topic=13773355&sjid=17642868584668136159-NC).
The product filter attributes only applies when the products eligible for
promotion product applicability `product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).
exclusion for the promotion.

`repeated string item_group_id_exclusion = 13 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `value` | `https://docs.oracle.com/javase/8/docs/api/java/lang/String.html` The itemGroupIdExclusion to add. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### addItemGroupIdExclusionBytes(ByteString value)

    public Attributes.Builder addItemGroupIdExclusionBytes(ByteString value)

Optional. Product filter by [item group
ID](https://support.google.com/merchants/answer/13837298?ref_topic=13773355&sjid=17642868584668136159-NC).
The product filter attributes only applies when the products eligible for
promotion product applicability `product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).
exclusion for the promotion.

`repeated string item_group_id_exclusion = 13 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `value` | `https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.ByteString.html` The bytes of the itemGroupIdExclusion to add. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### addItemGroupIdInclusion(String value)

    public Attributes.Builder addItemGroupIdInclusion(String value)

Optional. Product filter by item group ID for the promotion. The product
filter attributes only applies when the products eligible for promotion
product applicability \[product_applicability\] attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string item_group_id_inclusion = 9 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `value` | `https://docs.oracle.com/javase/8/docs/api/java/lang/String.html` The itemGroupIdInclusion to add. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### addItemGroupIdInclusionBytes(ByteString value)

    public Attributes.Builder addItemGroupIdInclusionBytes(ByteString value)

Optional. Product filter by item group ID for the promotion. The product
filter attributes only applies when the products eligible for promotion
product applicability \[product_applicability\] attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string item_group_id_inclusion = 9 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `value` | `https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.ByteString.html` The bytes of the itemGroupIdInclusion to add. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### addItemIdExclusion(String value)

    public Attributes.Builder addItemIdExclusion(String value)

Optional. Product filter by [item ID
exclusion](https://support.google.com/merchants/answer/13863524?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion. The product filter attributes only applies when the
products eligible for promotion product applicability
`product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string item_id_exclusion = 11 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `value` | `https://docs.oracle.com/javase/8/docs/api/java/lang/String.html` The itemIdExclusion to add. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### addItemIdExclusionBytes(ByteString value)

    public Attributes.Builder addItemIdExclusionBytes(ByteString value)

Optional. Product filter by [item ID
exclusion](https://support.google.com/merchants/answer/13863524?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion. The product filter attributes only applies when the
products eligible for promotion product applicability
`product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string item_id_exclusion = 11 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `value` | `https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.ByteString.html` The bytes of the itemIdExclusion to add. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### addItemIdInclusion(String value)

    public Attributes.Builder addItemIdInclusion(String value)

Optional. Product filter by [item
ID](https://support.google.com/merchants/answer/13861565?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion. The product filter attributes only applies when the
products eligible for promotion product applicability
`product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string item_id_inclusion = 7 [(.google.api.field_behavior) = OPTIONAL];`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `value` | `https://docs.oracle.com/javase/8/docs/api/java/lang/String.html` The itemIdInclusion to add. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### addItemIdInclusionBytes(ByteString value)

    public Attributes.Builder addItemIdInclusionBytes(ByteString value)

Optional. Product filter by [item
ID](https://support.google.com/merchants/answer/13861565?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion. The product filter attributes only applies when the
products eligible for promotion product applicability
`product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string item_id_inclusion = 7 [(.google.api.field_behavior) = OPTIONAL];`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `value` | `https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.ByteString.html` The bytes of the itemIdInclusion to add. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### addProductTypeExclusion(String value)

    public Attributes.Builder addProductTypeExclusion(String value)

Optional. Product filter by [product type
exclusion](https://support.google.com/merchants/answer/13863746?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion. The product filter attributes only applies when the
products eligible for promotion product applicability
`product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string product_type_exclusion = 14 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `value` | `https://docs.oracle.com/javase/8/docs/api/java/lang/String.html` The productTypeExclusion to add. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### addProductTypeExclusionBytes(ByteString value)

    public Attributes.Builder addProductTypeExclusionBytes(ByteString value)

Optional. Product filter by [product type
exclusion](https://support.google.com/merchants/answer/13863746?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion. The product filter attributes only applies when the
products eligible for promotion product applicability
`product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string product_type_exclusion = 14 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `value` | `https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.ByteString.html` The bytes of the productTypeExclusion to add. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### addProductTypeInclusion(String value)

    public Attributes.Builder addProductTypeInclusion(String value)

Optional. Product filter by product type for the promotion. The product
filter attributes only applies when the products eligible for promotion
product applicability `product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string product_type_inclusion = 10 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `value` | `https://docs.oracle.com/javase/8/docs/api/java/lang/String.html` The productTypeInclusion to add. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### addProductTypeInclusionBytes(ByteString value)

    public Attributes.Builder addProductTypeInclusionBytes(ByteString value)

Optional. Product filter by product type for the promotion. The product
filter attributes only applies when the products eligible for promotion
product applicability `product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string product_type_inclusion = 10 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `value` | `https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.ByteString.html` The bytes of the productTypeInclusion to add. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### addPromotionDestinations(Destination.DestinationEnum value)

    public Attributes.Builder addPromotionDestinations(Destination.DestinationEnum value)

Required. The list of destinations (also known as [Marketing
methods](https://support.google.com/merchants/answer/15130232)) where the
promotion applies to. If you don't specify a destination by including a
supported value in your data source, your promotion will display in
Shopping ads and free listings by default.

You may have previously submitted the following values as destinations for
your products: Shopping Actions, Surfaces across Google, Local surfaces
across Google. To represent these values use `FREE_LISTINGS`,
`FREE_LOCAL_LISTINGS`, `LOCAL_INVENTORY_ADS`. For more details see
[Promotion
destination](https://support.google.com/merchants/answer/13837465?sjid=5155774230887277618-NC)

`
repeated .google.shopping.type.Destination.DestinationEnum promotion_destinations = 6 [(.google.api.field_behavior) = REQUIRED];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `value` | `com.google.shopping.type.Destination.DestinationEnum` The promotionDestinations to add. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### addPromotionDestinationsValue(int value)

    public Attributes.Builder addPromotionDestinationsValue(int value)

Required. The list of destinations (also known as [Marketing
methods](https://support.google.com/merchants/answer/15130232)) where the
promotion applies to. If you don't specify a destination by including a
supported value in your data source, your promotion will display in
Shopping ads and free listings by default.

You may have previously submitted the following values as destinations for
your products: Shopping Actions, Surfaces across Google, Local surfaces
across Google. To represent these values use `FREE_LISTINGS`,
`FREE_LOCAL_LISTINGS`, `LOCAL_INVENTORY_ADS`. For more details see
[Promotion
destination](https://support.google.com/merchants/answer/13837465?sjid=5155774230887277618-NC)

`
repeated .google.shopping.type.Destination.DestinationEnum promotion_destinations = 6 [(.google.api.field_behavior) = REQUIRED];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `value` | `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` The enum numeric value on the wire for promotionDestinations to add. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### addStoreCodesExclusion(String value)

    public Attributes.Builder addStoreCodesExclusion(String value)

Optional. [Store codes to
exclude](https://support.google.com/merchants/answer/13859586?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion. The store filter attributes only applies when the
`store_applicability` attribute is set to
[specific_stores](https://support.google.com/merchants/answer/13857563?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string store_codes_exclusion = 30 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `value` | `https://docs.oracle.com/javase/8/docs/api/java/lang/String.html` The storeCodesExclusion to add. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### addStoreCodesExclusionBytes(ByteString value)

    public Attributes.Builder addStoreCodesExclusionBytes(ByteString value)

Optional. [Store codes to
exclude](https://support.google.com/merchants/answer/13859586?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion. The store filter attributes only applies when the
`store_applicability` attribute is set to
[specific_stores](https://support.google.com/merchants/answer/13857563?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string store_codes_exclusion = 30 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `value` | `https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.ByteString.html` The bytes of the storeCodesExclusion to add. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### addStoreCodesInclusion(String value)

    public Attributes.Builder addStoreCodesInclusion(String value)

Optional. [Store codes to
include](https://support.google.com/merchants/answer/13857470?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion. The store filter attributes only applies when the
`store_applicability` attribute is set to
[specific_stores](https://support.google.com/merchants/answer/13857563?ref_topic=13773355&sjid=17642868584668136159-NC).

Store code (the store ID from
your Business Profile) of the physical store the product is sold in. See
the [Local product inventory data
specification](https://support.google.com/merchants/answer/3061342) for
more information.

`repeated string store_codes_inclusion = 29 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `value` | `https://docs.oracle.com/javase/8/docs/api/java/lang/String.html` The storeCodesInclusion to add. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### addStoreCodesInclusionBytes(ByteString value)

    public Attributes.Builder addStoreCodesInclusionBytes(ByteString value)

Optional. [Store codes to
include](https://support.google.com/merchants/answer/13857470?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion. The store filter attributes only applies when the
`store_applicability` attribute is set to
[specific_stores](https://support.google.com/merchants/answer/13857563?ref_topic=13773355&sjid=17642868584668136159-NC).

Store code (the store ID from
your Business Profile) of the physical store the product is sold in. See
the [Local product inventory data
specification](https://support.google.com/merchants/answer/3061342) for
more information.

`repeated string store_codes_inclusion = 29 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `value` | `https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.ByteString.html` The bytes of the storeCodesInclusion to add. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### build()

    public Attributes build()

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes` |   |

### buildPartial()

    public Attributes buildPartial()

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes` |   |

### clear()

    public Attributes.Builder clear()

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` |   |

**Overrides** [GeneratedMessage.Builder\<BuilderType\>.clear()](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.GeneratedMessage.Builder.html#com_google_protobuf_GeneratedMessage_Builder_clear__)

### clearBrandExclusion()

    public Attributes.Builder clearBrandExclusion()

Optional. Product filter by [brand
exclusion](https://support.google.com/merchants/answer/13861679?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion. The product filter attributes only applies when the
products eligible for promotion product applicability
`product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string brand_exclusion = 12 [(.google.api.field_behavior) = OPTIONAL];`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### clearBrandInclusion()

    public Attributes.Builder clearBrandInclusion()

Optional. Product filter by brand for the promotion. The product filter
attributes only applies when the products eligible for promotion product
applicability `product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string brand_inclusion = 8 [(.google.api.field_behavior) = OPTIONAL];`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### clearCouponValueType()

    public Attributes.Builder clearCouponValueType()

Required. The [coupon value type](https://support.google.com/merchants/answer/13861986?ref_topic=13773355&sjid=17642868584668136159-NC)
attribute to signal the type of promotion that you are running. Depending
on type of the selected coupon value [some attributes are
required](https://support.google.com/merchants/answer/6393006?ref_topic=7322920).

`
.google.shopping.merchant.promotions.v1.CouponValueType coupon_value_type = 5 [(.google.api.field_behavior) = REQUIRED];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### clearFreeGiftDescription()

    public Attributes.Builder clearFreeGiftDescription()

Optional. [Free gift
description](https://support.google.com/merchants/answer/13847245?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion.

`string free_gift_description = 23 [(.google.api.field_behavior) = OPTIONAL];`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### clearFreeGiftItemId()

    public Attributes.Builder clearFreeGiftItemId()

Optional. [Free gift item
ID](https://support.google.com/merchants/answer/13857152?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion.

`string free_gift_item_id = 24 [(.google.api.field_behavior) = OPTIONAL];`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### clearFreeGiftValue()

    public Attributes.Builder clearFreeGiftValue()

Optional. [Free gift
value](https://support.google.com/merchants/answer/13844477?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion.

`
.google.shopping.type.Price free_gift_value = 22 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` |   |

### clearGenericRedemptionCode()

    public Attributes.Builder clearGenericRedemptionCode()

Optional. Generic redemption code for the promotion. To be used with the
`offerType` field and must meet the [minimum
requirements](https://support.google.com/merchants/answer/13837405?ref_topic=13773355&sjid=17642868584668136159-NC).

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

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### clearGetThisQuantityDiscounted()

    public Attributes.Builder clearGetThisQuantityDiscounted()

Optional. The number of items discounted in the promotion. The attribute is
set when `couponValueType` is equal to `buy_m_get_n_money_off` or
`buy_m_get_n_percent_off`.

`int64 get_this_quantity_discounted = 21 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### clearItemGroupIdExclusion()

    public Attributes.Builder clearItemGroupIdExclusion()

Optional. Product filter by [item group
ID](https://support.google.com/merchants/answer/13837298?ref_topic=13773355&sjid=17642868584668136159-NC).
The product filter attributes only applies when the products eligible for
promotion product applicability `product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).
exclusion for the promotion.

`repeated string item_group_id_exclusion = 13 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### clearItemGroupIdInclusion()

    public Attributes.Builder clearItemGroupIdInclusion()

Optional. Product filter by item group ID for the promotion. The product
filter attributes only applies when the products eligible for promotion
product applicability \[product_applicability\] attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string item_group_id_inclusion = 9 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### clearItemIdExclusion()

    public Attributes.Builder clearItemIdExclusion()

Optional. Product filter by [item ID
exclusion](https://support.google.com/merchants/answer/13863524?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion. The product filter attributes only applies when the
products eligible for promotion product applicability
`product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string item_id_exclusion = 11 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### clearItemIdInclusion()

    public Attributes.Builder clearItemIdInclusion()

Optional. Product filter by [item
ID](https://support.google.com/merchants/answer/13861565?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion. The product filter attributes only applies when the
products eligible for promotion product applicability
`product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string item_id_inclusion = 7 [(.google.api.field_behavior) = OPTIONAL];`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### clearLimitQuantity()

    public Attributes.Builder clearLimitQuantity()

Optional. [Maximum purchase
quantity](https://support.google.com/merchants/answer/13861564?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion.

`int64 limit_quantity = 17 [(.google.api.field_behavior) = OPTIONAL];`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### clearLimitValue()

    public Attributes.Builder clearLimitValue()

Optional. [Maximum product
price](https://support.google.com/merchants/answer/2906014) for
promotion.

`.google.shopping.type.Price limit_value = 18 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` |   |

### clearLongTitle()

    public Attributes.Builder clearLongTitle()

Required. [Long
title](https://support.google.com/merchants/answer/13838102?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion.

`string long_title = 4 [(.google.api.field_behavior) = REQUIRED];`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### clearMinimumPurchaseAmount()

    public Attributes.Builder clearMinimumPurchaseAmount()

Optional. [Minimum purchase
amount](https://support.google.com/merchants/answer/13837705?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion.

`
.google.shopping.type.Price minimum_purchase_amount = 15 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` |   |

### clearMinimumPurchaseQuantity()

    public Attributes.Builder clearMinimumPurchaseQuantity()

`int64 minimum_purchase_quantity = 16 [(.google.api.field_behavior) = OPTIONAL];`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### clearMoneyOffAmount()

    public Attributes.Builder clearMoneyOffAmount()

Optional. The [money off
amount](https://support.google.com/merchants/answer/13838101?ref_topic=13773355&sjid=17642868584668136159-NC)
offered in the promotion.

`
.google.shopping.type.Price money_off_amount = 20 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` |   |

### clearOfferType()

    public Attributes.Builder clearOfferType()

Required.
[Type](https://support.google.com/merchants/answer/13837405?ref_topic=13773355&sjid=17642868584668136159-NC)
of the promotion. Use this attribute to indicate whether or not customers
need a coupon code to redeem your promotion.

`
.google.shopping.merchant.promotions.v1.OfferType offer_type = 2 [(.google.api.field_behavior) = REQUIRED];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### clearPercentOff()

    public Attributes.Builder clearPercentOff()

Optional. The [percentage
discount](https://support.google.com/merchants/answer/13837404?sjid=17642868584668136159-NC)
offered in the promotion.

`int64 percent_off = 19 [(.google.api.field_behavior) = OPTIONAL];`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### clearProductApplicability()

    public Attributes.Builder clearProductApplicability()

Required. Applicability of the promotion to either all products or
[only specific
products](https://support.google.com/merchants/answer/6396257?ref_topic=6396150&sjid=17642868584668136159-NC).

`
.google.shopping.merchant.promotions.v1.ProductApplicability product_applicability = 1 [(.google.api.field_behavior) = REQUIRED];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### clearProductTypeExclusion()

    public Attributes.Builder clearProductTypeExclusion()

Optional. Product filter by [product type
exclusion](https://support.google.com/merchants/answer/13863746?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion. The product filter attributes only applies when the
products eligible for promotion product applicability
`product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string product_type_exclusion = 14 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### clearProductTypeInclusion()

    public Attributes.Builder clearProductTypeInclusion()

Optional. Product filter by product type for the promotion. The product
filter attributes only applies when the products eligible for promotion
product applicability `product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string product_type_inclusion = 10 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### clearPromotionDestinations()

    public Attributes.Builder clearPromotionDestinations()

Required. The list of destinations (also known as [Marketing
methods](https://support.google.com/merchants/answer/15130232)) where the
promotion applies to. If you don't specify a destination by including a
supported value in your data source, your promotion will display in
Shopping ads and free listings by default.

You may have previously submitted the following values as destinations for
your products: Shopping Actions, Surfaces across Google, Local surfaces
across Google. To represent these values use `FREE_LISTINGS`,
`FREE_LOCAL_LISTINGS`, `LOCAL_INVENTORY_ADS`. For more details see
[Promotion
destination](https://support.google.com/merchants/answer/13837465?sjid=5155774230887277618-NC)

`
repeated .google.shopping.type.Destination.DestinationEnum promotion_destinations = 6 [(.google.api.field_behavior) = REQUIRED];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### clearPromotionDisplayTimePeriod()

    public Attributes.Builder clearPromotionDisplayTimePeriod()

Optional. `TimePeriod` representation of the promotion's display dates.
This attribute specifies the date and time frame when the promotion will be
live on Google.com and Shopping ads. If the display time period for
promotion `promotion_display_time_period` attribute is not specified, the
promotion effective time period `promotion_effective_time_period`
determines the date and time frame when the promotion will be live on
Google.com and Shopping ads.

`
.google.type.Interval promotion_display_time_period = 26 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` |   |

### clearPromotionEffectiveTimePeriod()

    public Attributes.Builder clearPromotionEffectiveTimePeriod()

Required. `TimePeriod` representation of the promotion's effective dates.
This attribute specifies that the promotion can be tested on your online
store during this time period.

`
.google.type.Interval promotion_effective_time_period = 25 [(.google.api.field_behavior) = REQUIRED];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` |   |

### clearPromotionUrl()

    public Attributes.Builder clearPromotionUrl()

Optional. URL to the page on the merchant's site where the promotion shows.
Local Inventory ads promotions throw an error if no `promotion_url` is
included. URL is used to confirm that the promotion is valid and can be
redeemed.

`string promotion_url = 31 [(.google.api.field_behavior) = OPTIONAL];`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### clearStoreApplicability()

    public Attributes.Builder clearStoreApplicability()

Optional. Whether the promotion applies to [all stores, or only specified
stores](https://support.google.com/merchants/answer/13857563?sjid=17642868584668136159-NC).
Local Inventory ads promotions throw an error if no store applicability is
included. An `INVALID_ARGUMENT` error is thrown if `store_applicability` is
set to `ALL_STORES` and `store_codes_inclusion` or `score_code_exclusion`
is set to a value.

`
.google.shopping.merchant.promotions.v1.StoreApplicability store_applicability = 28 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### clearStoreCodesExclusion()

    public Attributes.Builder clearStoreCodesExclusion()

Optional. [Store codes to
exclude](https://support.google.com/merchants/answer/13859586?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion. The store filter attributes only applies when the
`store_applicability` attribute is set to
[specific_stores](https://support.google.com/merchants/answer/13857563?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string store_codes_exclusion = 30 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### clearStoreCodesInclusion()

    public Attributes.Builder clearStoreCodesInclusion()

Optional. [Store codes to
include](https://support.google.com/merchants/answer/13857470?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion. The store filter attributes only applies when the
`store_applicability` attribute is set to
[specific_stores](https://support.google.com/merchants/answer/13857563?ref_topic=13773355&sjid=17642868584668136159-NC).

Store code (the store ID from
your Business Profile) of the physical store the product is sold in. See
the [Local product inventory data
specification](https://support.google.com/merchants/answer/3061342) for
more information.

`repeated string store_codes_inclusion = 29 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### getBrandExclusion(int index)

    public String getBrandExclusion(int index)

Optional. Product filter by [brand
exclusion](https://support.google.com/merchants/answer/13861679?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion. The product filter attributes only applies when the
products eligible for promotion product applicability
`product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string brand_exclusion = 12 [(.google.api.field_behavior) = OPTIONAL];`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `index` | `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` The index of the element to return. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/8/docs/api/java/lang/String.html` | The brandExclusion at the given index. |

### getBrandExclusionBytes(int index)

    public ByteString getBrandExclusionBytes(int index)

Optional. Product filter by [brand
exclusion](https://support.google.com/merchants/answer/13861679?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion. The product filter attributes only applies when the
products eligible for promotion product applicability
`product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string brand_exclusion = 12 [(.google.api.field_behavior) = OPTIONAL];`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `index` | `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` The index of the value to return. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.ByteString.html` | The bytes of the brandExclusion at the given index. |

### getBrandExclusionCount()

    public int getBrandExclusionCount()

Optional. Product filter by [brand
exclusion](https://support.google.com/merchants/answer/13861679?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion. The product filter attributes only applies when the
products eligible for promotion product applicability
`product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string brand_exclusion = 12 [(.google.api.field_behavior) = OPTIONAL];`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` | The count of brandExclusion. |

### getBrandExclusionList()

    public ProtocolStringList getBrandExclusionList()

Optional. Product filter by [brand
exclusion](https://support.google.com/merchants/answer/13861679?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion. The product filter attributes only applies when the
products eligible for promotion product applicability
`product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string brand_exclusion = 12 [(.google.api.field_behavior) = OPTIONAL];`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.ProtocolStringList.html` | A list containing the brandExclusion. |

### getBrandInclusion(int index)

    public String getBrandInclusion(int index)

Optional. Product filter by brand for the promotion. The product filter
attributes only applies when the products eligible for promotion product
applicability `product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string brand_inclusion = 8 [(.google.api.field_behavior) = OPTIONAL];`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `index` | `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` The index of the element to return. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/8/docs/api/java/lang/String.html` | The brandInclusion at the given index. |

### getBrandInclusionBytes(int index)

    public ByteString getBrandInclusionBytes(int index)

Optional. Product filter by brand for the promotion. The product filter
attributes only applies when the products eligible for promotion product
applicability `product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string brand_inclusion = 8 [(.google.api.field_behavior) = OPTIONAL];`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `index` | `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` The index of the value to return. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.ByteString.html` | The bytes of the brandInclusion at the given index. |

### getBrandInclusionCount()

    public int getBrandInclusionCount()

Optional. Product filter by brand for the promotion. The product filter
attributes only applies when the products eligible for promotion product
applicability `product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string brand_inclusion = 8 [(.google.api.field_behavior) = OPTIONAL];`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` | The count of brandInclusion. |

### getBrandInclusionList()

    public ProtocolStringList getBrandInclusionList()

Optional. Product filter by brand for the promotion. The product filter
attributes only applies when the products eligible for promotion product
applicability `product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string brand_inclusion = 8 [(.google.api.field_behavior) = OPTIONAL];`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.ProtocolStringList.html` | A list containing the brandInclusion. |

### getCouponValueType()

    public CouponValueType getCouponValueType()

Required. The [coupon value type](https://support.google.com/merchants/answer/13861986?ref_topic=13773355&sjid=17642868584668136159-NC)
attribute to signal the type of promotion that you are running. Depending
on type of the selected coupon value [some attributes are
required](https://support.google.com/merchants/answer/6393006?ref_topic=7322920).

`
.google.shopping.merchant.promotions.v1.CouponValueType coupon_value_type = 5 [(.google.api.field_behavior) = REQUIRED];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.CouponValueType` | The couponValueType. |

### getCouponValueTypeValue()

    public int getCouponValueTypeValue()

Required. The [coupon value type](https://support.google.com/merchants/answer/13861986?ref_topic=13773355&sjid=17642868584668136159-NC)
attribute to signal the type of promotion that you are running. Depending
on type of the selected coupon value [some attributes are
required](https://support.google.com/merchants/answer/6393006?ref_topic=7322920).

`
.google.shopping.merchant.promotions.v1.CouponValueType coupon_value_type = 5 [(.google.api.field_behavior) = REQUIRED];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` | The enum numeric value on the wire for couponValueType. |

### getDefaultInstanceForType()

    public Attributes getDefaultInstanceForType()

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes` |   |

### getDescriptorForType()

    public Descriptors.Descriptor getDescriptorForType()

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.Descriptors.Descriptor.html` |   |

**Overrides** [GeneratedMessage.Builder\<BuilderType\>.getDescriptorForType()](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.GeneratedMessage.Builder.html#com_google_protobuf_GeneratedMessage_Builder_getDescriptorForType__)

### getFreeGiftDescription()

    public String getFreeGiftDescription()

Optional. [Free gift
description](https://support.google.com/merchants/answer/13847245?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion.

`string free_gift_description = 23 [(.google.api.field_behavior) = OPTIONAL];`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/8/docs/api/java/lang/String.html` | The freeGiftDescription. |

### getFreeGiftDescriptionBytes()

    public ByteString getFreeGiftDescriptionBytes()

Optional. [Free gift
description](https://support.google.com/merchants/answer/13847245?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion.

`string free_gift_description = 23 [(.google.api.field_behavior) = OPTIONAL];`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.ByteString.html` | The bytes for freeGiftDescription. |

### getFreeGiftItemId()

    public String getFreeGiftItemId()

Optional. [Free gift item
ID](https://support.google.com/merchants/answer/13857152?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion.

`string free_gift_item_id = 24 [(.google.api.field_behavior) = OPTIONAL];`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/8/docs/api/java/lang/String.html` | The freeGiftItemId. |

### getFreeGiftItemIdBytes()

    public ByteString getFreeGiftItemIdBytes()

Optional. [Free gift item
ID](https://support.google.com/merchants/answer/13857152?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion.

`string free_gift_item_id = 24 [(.google.api.field_behavior) = OPTIONAL];`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.ByteString.html` | The bytes for freeGiftItemId. |

### getFreeGiftValue()

    public Price getFreeGiftValue()

Optional. [Free gift
value](https://support.google.com/merchants/answer/13844477?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion.

`
.google.shopping.type.Price free_gift_value = 22 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `com.google.shopping.type.Price` | The freeGiftValue. |

### getFreeGiftValueBuilder()

    public Price.Builder getFreeGiftValueBuilder()

Optional. [Free gift
value](https://support.google.com/merchants/answer/13844477?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion.

`
.google.shopping.type.Price free_gift_value = 22 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `com.google.shopping.type.Price.Builder` |   |

### getFreeGiftValueOrBuilder()

    public PriceOrBuilder getFreeGiftValueOrBuilder()

Optional. [Free gift
value](https://support.google.com/merchants/answer/13844477?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion.

`
.google.shopping.type.Price free_gift_value = 22 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `com.google.shopping.type.PriceOrBuilder` |   |

### getGenericRedemptionCode()

    public String getGenericRedemptionCode()

Optional. Generic redemption code for the promotion. To be used with the
`offerType` field and must meet the [minimum
requirements](https://support.google.com/merchants/answer/13837405?ref_topic=13773355&sjid=17642868584668136159-NC).

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

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/8/docs/api/java/lang/String.html` | The genericRedemptionCode. |

### getGenericRedemptionCodeBytes()

    public ByteString getGenericRedemptionCodeBytes()

Optional. Generic redemption code for the promotion. To be used with the
`offerType` field and must meet the [minimum
requirements](https://support.google.com/merchants/answer/13837405?ref_topic=13773355&sjid=17642868584668136159-NC).

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

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.ByteString.html` | The bytes for genericRedemptionCode. |

### getGetThisQuantityDiscounted()

    public long getGetThisQuantityDiscounted()

Optional. The number of items discounted in the promotion. The attribute is
set when `couponValueType` is equal to `buy_m_get_n_money_off` or
`buy_m_get_n_percent_off`.

`int64 get_this_quantity_discounted = 21 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` | The getThisQuantityDiscounted. |

### getItemGroupIdExclusion(int index)

    public String getItemGroupIdExclusion(int index)

Optional. Product filter by [item group
ID](https://support.google.com/merchants/answer/13837298?ref_topic=13773355&sjid=17642868584668136159-NC).
The product filter attributes only applies when the products eligible for
promotion product applicability `product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).
exclusion for the promotion.

`repeated string item_group_id_exclusion = 13 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `index` | `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` The index of the element to return. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/8/docs/api/java/lang/String.html` | The itemGroupIdExclusion at the given index. |

### getItemGroupIdExclusionBytes(int index)

    public ByteString getItemGroupIdExclusionBytes(int index)

Optional. Product filter by [item group
ID](https://support.google.com/merchants/answer/13837298?ref_topic=13773355&sjid=17642868584668136159-NC).
The product filter attributes only applies when the products eligible for
promotion product applicability `product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).
exclusion for the promotion.

`repeated string item_group_id_exclusion = 13 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `index` | `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` The index of the value to return. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.ByteString.html` | The bytes of the itemGroupIdExclusion at the given index. |

### getItemGroupIdExclusionCount()

    public int getItemGroupIdExclusionCount()

Optional. Product filter by [item group
ID](https://support.google.com/merchants/answer/13837298?ref_topic=13773355&sjid=17642868584668136159-NC).
The product filter attributes only applies when the products eligible for
promotion product applicability `product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).
exclusion for the promotion.

`repeated string item_group_id_exclusion = 13 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` | The count of itemGroupIdExclusion. |

### getItemGroupIdExclusionList()

    public ProtocolStringList getItemGroupIdExclusionList()

Optional. Product filter by [item group
ID](https://support.google.com/merchants/answer/13837298?ref_topic=13773355&sjid=17642868584668136159-NC).
The product filter attributes only applies when the products eligible for
promotion product applicability `product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).
exclusion for the promotion.

`repeated string item_group_id_exclusion = 13 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.ProtocolStringList.html` | A list containing the itemGroupIdExclusion. |

### getItemGroupIdInclusion(int index)

    public String getItemGroupIdInclusion(int index)

Optional. Product filter by item group ID for the promotion. The product
filter attributes only applies when the products eligible for promotion
product applicability \[product_applicability\] attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string item_group_id_inclusion = 9 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `index` | `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` The index of the element to return. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/8/docs/api/java/lang/String.html` | The itemGroupIdInclusion at the given index. |

### getItemGroupIdInclusionBytes(int index)

    public ByteString getItemGroupIdInclusionBytes(int index)

Optional. Product filter by item group ID for the promotion. The product
filter attributes only applies when the products eligible for promotion
product applicability \[product_applicability\] attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string item_group_id_inclusion = 9 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `index` | `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` The index of the value to return. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.ByteString.html` | The bytes of the itemGroupIdInclusion at the given index. |

### getItemGroupIdInclusionCount()

    public int getItemGroupIdInclusionCount()

Optional. Product filter by item group ID for the promotion. The product
filter attributes only applies when the products eligible for promotion
product applicability \[product_applicability\] attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string item_group_id_inclusion = 9 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` | The count of itemGroupIdInclusion. |

### getItemGroupIdInclusionList()

    public ProtocolStringList getItemGroupIdInclusionList()

Optional. Product filter by item group ID for the promotion. The product
filter attributes only applies when the products eligible for promotion
product applicability \[product_applicability\] attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string item_group_id_inclusion = 9 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.ProtocolStringList.html` | A list containing the itemGroupIdInclusion. |

### getItemIdExclusion(int index)

    public String getItemIdExclusion(int index)

Optional. Product filter by [item ID
exclusion](https://support.google.com/merchants/answer/13863524?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion. The product filter attributes only applies when the
products eligible for promotion product applicability
`product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string item_id_exclusion = 11 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `index` | `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` The index of the element to return. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/8/docs/api/java/lang/String.html` | The itemIdExclusion at the given index. |

### getItemIdExclusionBytes(int index)

    public ByteString getItemIdExclusionBytes(int index)

Optional. Product filter by [item ID
exclusion](https://support.google.com/merchants/answer/13863524?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion. The product filter attributes only applies when the
products eligible for promotion product applicability
`product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string item_id_exclusion = 11 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `index` | `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` The index of the value to return. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.ByteString.html` | The bytes of the itemIdExclusion at the given index. |

### getItemIdExclusionCount()

    public int getItemIdExclusionCount()

Optional. Product filter by [item ID
exclusion](https://support.google.com/merchants/answer/13863524?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion. The product filter attributes only applies when the
products eligible for promotion product applicability
`product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string item_id_exclusion = 11 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` | The count of itemIdExclusion. |

### getItemIdExclusionList()

    public ProtocolStringList getItemIdExclusionList()

Optional. Product filter by [item ID
exclusion](https://support.google.com/merchants/answer/13863524?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion. The product filter attributes only applies when the
products eligible for promotion product applicability
`product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string item_id_exclusion = 11 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.ProtocolStringList.html` | A list containing the itemIdExclusion. |

### getItemIdInclusion(int index)

    public String getItemIdInclusion(int index)

Optional. Product filter by [item
ID](https://support.google.com/merchants/answer/13861565?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion. The product filter attributes only applies when the
products eligible for promotion product applicability
`product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string item_id_inclusion = 7 [(.google.api.field_behavior) = OPTIONAL];`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `index` | `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` The index of the element to return. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/8/docs/api/java/lang/String.html` | The itemIdInclusion at the given index. |

### getItemIdInclusionBytes(int index)

    public ByteString getItemIdInclusionBytes(int index)

Optional. Product filter by [item
ID](https://support.google.com/merchants/answer/13861565?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion. The product filter attributes only applies when the
products eligible for promotion product applicability
`product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string item_id_inclusion = 7 [(.google.api.field_behavior) = OPTIONAL];`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `index` | `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` The index of the value to return. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.ByteString.html` | The bytes of the itemIdInclusion at the given index. |

### getItemIdInclusionCount()

    public int getItemIdInclusionCount()

Optional. Product filter by [item
ID](https://support.google.com/merchants/answer/13861565?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion. The product filter attributes only applies when the
products eligible for promotion product applicability
`product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string item_id_inclusion = 7 [(.google.api.field_behavior) = OPTIONAL];`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` | The count of itemIdInclusion. |

### getItemIdInclusionList()

    public ProtocolStringList getItemIdInclusionList()

Optional. Product filter by [item
ID](https://support.google.com/merchants/answer/13861565?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion. The product filter attributes only applies when the
products eligible for promotion product applicability
`product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string item_id_inclusion = 7 [(.google.api.field_behavior) = OPTIONAL];`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.ProtocolStringList.html` | A list containing the itemIdInclusion. |

### getLimitQuantity()

    public long getLimitQuantity()

Optional. [Maximum purchase
quantity](https://support.google.com/merchants/answer/13861564?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion.

`int64 limit_quantity = 17 [(.google.api.field_behavior) = OPTIONAL];`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` | The limitQuantity. |

### getLimitValue()

    public Price getLimitValue()

Optional. [Maximum product
price](https://support.google.com/merchants/answer/2906014) for
promotion.

`.google.shopping.type.Price limit_value = 18 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `com.google.shopping.type.Price` | The limitValue. |

### getLimitValueBuilder()

    public Price.Builder getLimitValueBuilder()

Optional. [Maximum product
price](https://support.google.com/merchants/answer/2906014) for
promotion.

`.google.shopping.type.Price limit_value = 18 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `com.google.shopping.type.Price.Builder` |   |

### getLimitValueOrBuilder()

    public PriceOrBuilder getLimitValueOrBuilder()

Optional. [Maximum product
price](https://support.google.com/merchants/answer/2906014) for
promotion.

`.google.shopping.type.Price limit_value = 18 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `com.google.shopping.type.PriceOrBuilder` |   |

### getLongTitle()

    public String getLongTitle()

Required. [Long
title](https://support.google.com/merchants/answer/13838102?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion.

`string long_title = 4 [(.google.api.field_behavior) = REQUIRED];`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/8/docs/api/java/lang/String.html` | The longTitle. |

### getLongTitleBytes()

    public ByteString getLongTitleBytes()

Required. [Long
title](https://support.google.com/merchants/answer/13838102?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion.

`string long_title = 4 [(.google.api.field_behavior) = REQUIRED];`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.ByteString.html` | The bytes for longTitle. |

### getMinimumPurchaseAmount()

    public Price getMinimumPurchaseAmount()

Optional. [Minimum purchase
amount](https://support.google.com/merchants/answer/13837705?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion.

`
.google.shopping.type.Price minimum_purchase_amount = 15 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `com.google.shopping.type.Price` | The minimumPurchaseAmount. |

### getMinimumPurchaseAmountBuilder()

    public Price.Builder getMinimumPurchaseAmountBuilder()

Optional. [Minimum purchase
amount](https://support.google.com/merchants/answer/13837705?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion.

`
.google.shopping.type.Price minimum_purchase_amount = 15 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `com.google.shopping.type.Price.Builder` |   |

### getMinimumPurchaseAmountOrBuilder()

    public PriceOrBuilder getMinimumPurchaseAmountOrBuilder()

Optional. [Minimum purchase
amount](https://support.google.com/merchants/answer/13837705?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion.

`
.google.shopping.type.Price minimum_purchase_amount = 15 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `com.google.shopping.type.PriceOrBuilder` |   |

### getMinimumPurchaseQuantity()

    public long getMinimumPurchaseQuantity()

`int64 minimum_purchase_quantity = 16 [(.google.api.field_behavior) = OPTIONAL];`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` | The minimumPurchaseQuantity. |

### getMoneyOffAmount()

    public Price getMoneyOffAmount()

Optional. The [money off
amount](https://support.google.com/merchants/answer/13838101?ref_topic=13773355&sjid=17642868584668136159-NC)
offered in the promotion.

`
.google.shopping.type.Price money_off_amount = 20 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `com.google.shopping.type.Price` | The moneyOffAmount. |

### getMoneyOffAmountBuilder()

    public Price.Builder getMoneyOffAmountBuilder()

Optional. The [money off
amount](https://support.google.com/merchants/answer/13838101?ref_topic=13773355&sjid=17642868584668136159-NC)
offered in the promotion.

`
.google.shopping.type.Price money_off_amount = 20 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `com.google.shopping.type.Price.Builder` |   |

### getMoneyOffAmountOrBuilder()

    public PriceOrBuilder getMoneyOffAmountOrBuilder()

Optional. The [money off
amount](https://support.google.com/merchants/answer/13838101?ref_topic=13773355&sjid=17642868584668136159-NC)
offered in the promotion.

`
.google.shopping.type.Price money_off_amount = 20 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `com.google.shopping.type.PriceOrBuilder` |   |

### getOfferType()

    public OfferType getOfferType()

Required.
[Type](https://support.google.com/merchants/answer/13837405?ref_topic=13773355&sjid=17642868584668136159-NC)
of the promotion. Use this attribute to indicate whether or not customers
need a coupon code to redeem your promotion.

`
.google.shopping.merchant.promotions.v1.OfferType offer_type = 2 [(.google.api.field_behavior) = REQUIRED];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.OfferType` | The offerType. |

### getOfferTypeValue()

    public int getOfferTypeValue()

Required.
[Type](https://support.google.com/merchants/answer/13837405?ref_topic=13773355&sjid=17642868584668136159-NC)
of the promotion. Use this attribute to indicate whether or not customers
need a coupon code to redeem your promotion.

`
.google.shopping.merchant.promotions.v1.OfferType offer_type = 2 [(.google.api.field_behavior) = REQUIRED];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` | The enum numeric value on the wire for offerType. |

### getPercentOff()

    public long getPercentOff()

Optional. The [percentage
discount](https://support.google.com/merchants/answer/13837404?sjid=17642868584668136159-NC)
offered in the promotion.

`int64 percent_off = 19 [(.google.api.field_behavior) = OPTIONAL];`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` | The percentOff. |

### getProductApplicability()

    public ProductApplicability getProductApplicability()

Required. Applicability of the promotion to either all products or
[only specific
products](https://support.google.com/merchants/answer/6396257?ref_topic=6396150&sjid=17642868584668136159-NC).

`
.google.shopping.merchant.promotions.v1.ProductApplicability product_applicability = 1 [(.google.api.field_behavior) = REQUIRED];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.ProductApplicability` | The productApplicability. |

### getProductApplicabilityValue()

    public int getProductApplicabilityValue()

Required. Applicability of the promotion to either all products or
[only specific
products](https://support.google.com/merchants/answer/6396257?ref_topic=6396150&sjid=17642868584668136159-NC).

`
.google.shopping.merchant.promotions.v1.ProductApplicability product_applicability = 1 [(.google.api.field_behavior) = REQUIRED];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` | The enum numeric value on the wire for productApplicability. |

### getProductTypeExclusion(int index)

    public String getProductTypeExclusion(int index)

Optional. Product filter by [product type
exclusion](https://support.google.com/merchants/answer/13863746?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion. The product filter attributes only applies when the
products eligible for promotion product applicability
`product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string product_type_exclusion = 14 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `index` | `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` The index of the element to return. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/8/docs/api/java/lang/String.html` | The productTypeExclusion at the given index. |

### getProductTypeExclusionBytes(int index)

    public ByteString getProductTypeExclusionBytes(int index)

Optional. Product filter by [product type
exclusion](https://support.google.com/merchants/answer/13863746?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion. The product filter attributes only applies when the
products eligible for promotion product applicability
`product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string product_type_exclusion = 14 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `index` | `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` The index of the value to return. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.ByteString.html` | The bytes of the productTypeExclusion at the given index. |

### getProductTypeExclusionCount()

    public int getProductTypeExclusionCount()

Optional. Product filter by [product type
exclusion](https://support.google.com/merchants/answer/13863746?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion. The product filter attributes only applies when the
products eligible for promotion product applicability
`product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string product_type_exclusion = 14 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` | The count of productTypeExclusion. |

### getProductTypeExclusionList()

    public ProtocolStringList getProductTypeExclusionList()

Optional. Product filter by [product type
exclusion](https://support.google.com/merchants/answer/13863746?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion. The product filter attributes only applies when the
products eligible for promotion product applicability
`product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string product_type_exclusion = 14 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.ProtocolStringList.html` | A list containing the productTypeExclusion. |

### getProductTypeInclusion(int index)

    public String getProductTypeInclusion(int index)

Optional. Product filter by product type for the promotion. The product
filter attributes only applies when the products eligible for promotion
product applicability `product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string product_type_inclusion = 10 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `index` | `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` The index of the element to return. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/8/docs/api/java/lang/String.html` | The productTypeInclusion at the given index. |

### getProductTypeInclusionBytes(int index)

    public ByteString getProductTypeInclusionBytes(int index)

Optional. Product filter by product type for the promotion. The product
filter attributes only applies when the products eligible for promotion
product applicability `product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string product_type_inclusion = 10 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `index` | `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` The index of the value to return. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.ByteString.html` | The bytes of the productTypeInclusion at the given index. |

### getProductTypeInclusionCount()

    public int getProductTypeInclusionCount()

Optional. Product filter by product type for the promotion. The product
filter attributes only applies when the products eligible for promotion
product applicability `product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string product_type_inclusion = 10 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` | The count of productTypeInclusion. |

### getProductTypeInclusionList()

    public ProtocolStringList getProductTypeInclusionList()

Optional. Product filter by product type for the promotion. The product
filter attributes only applies when the products eligible for promotion
product applicability `product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string product_type_inclusion = 10 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.ProtocolStringList.html` | A list containing the productTypeInclusion. |

### getPromotionDestinations(int index)

    public Destination.DestinationEnum getPromotionDestinations(int index)

Required. The list of destinations (also known as [Marketing
methods](https://support.google.com/merchants/answer/15130232)) where the
promotion applies to. If you don't specify a destination by including a
supported value in your data source, your promotion will display in
Shopping ads and free listings by default.

You may have previously submitted the following values as destinations for
your products: Shopping Actions, Surfaces across Google, Local surfaces
across Google. To represent these values use `FREE_LISTINGS`,
`FREE_LOCAL_LISTINGS`, `LOCAL_INVENTORY_ADS`. For more details see
[Promotion
destination](https://support.google.com/merchants/answer/13837465?sjid=5155774230887277618-NC)

`
repeated .google.shopping.type.Destination.DestinationEnum promotion_destinations = 6 [(.google.api.field_behavior) = REQUIRED];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `index` | `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` The index of the element to return. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `com.google.shopping.type.Destination.DestinationEnum` | The promotionDestinations at the given index. |

### getPromotionDestinationsCount()

    public int getPromotionDestinationsCount()

Required. The list of destinations (also known as [Marketing
methods](https://support.google.com/merchants/answer/15130232)) where the
promotion applies to. If you don't specify a destination by including a
supported value in your data source, your promotion will display in
Shopping ads and free listings by default.

You may have previously submitted the following values as destinations for
your products: Shopping Actions, Surfaces across Google, Local surfaces
across Google. To represent these values use `FREE_LISTINGS`,
`FREE_LOCAL_LISTINGS`, `LOCAL_INVENTORY_ADS`. For more details see
[Promotion
destination](https://support.google.com/merchants/answer/13837465?sjid=5155774230887277618-NC)

`
repeated .google.shopping.type.Destination.DestinationEnum promotion_destinations = 6 [(.google.api.field_behavior) = REQUIRED];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` | The count of promotionDestinations. |

### getPromotionDestinationsList()

    public List<Destination.DestinationEnum> getPromotionDestinationsList()

Required. The list of destinations (also known as [Marketing
methods](https://support.google.com/merchants/answer/15130232)) where the
promotion applies to. If you don't specify a destination by including a
supported value in your data source, your promotion will display in
Shopping ads and free listings by default.

You may have previously submitted the following values as destinations for
your products: Shopping Actions, Surfaces across Google, Local surfaces
across Google. To represent these values use `FREE_LISTINGS`,
`FREE_LOCAL_LISTINGS`, `LOCAL_INVENTORY_ADS`. For more details see
[Promotion
destination](https://support.google.com/merchants/answer/13837465?sjid=5155774230887277618-NC)

`
repeated .google.shopping.type.Destination.DestinationEnum promotion_destinations = 6 [(.google.api.field_behavior) = REQUIRED];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/8/docs/api/java/util/List.html<com.google.shopping.type.Destination.DestinationEnum>` | A list containing the promotionDestinations. |

### getPromotionDestinationsValue(int index)

    public int getPromotionDestinationsValue(int index)

Required. The list of destinations (also known as [Marketing
methods](https://support.google.com/merchants/answer/15130232)) where the
promotion applies to. If you don't specify a destination by including a
supported value in your data source, your promotion will display in
Shopping ads and free listings by default.

You may have previously submitted the following values as destinations for
your products: Shopping Actions, Surfaces across Google, Local surfaces
across Google. To represent these values use `FREE_LISTINGS`,
`FREE_LOCAL_LISTINGS`, `LOCAL_INVENTORY_ADS`. For more details see
[Promotion
destination](https://support.google.com/merchants/answer/13837465?sjid=5155774230887277618-NC)

`
repeated .google.shopping.type.Destination.DestinationEnum promotion_destinations = 6 [(.google.api.field_behavior) = REQUIRED];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `index` | `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` The index of the value to return. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` | The enum numeric value on the wire of promotionDestinations at the given index. |

### getPromotionDestinationsValueList()

    public List<Integer> getPromotionDestinationsValueList()

Required. The list of destinations (also known as [Marketing
methods](https://support.google.com/merchants/answer/15130232)) where the
promotion applies to. If you don't specify a destination by including a
supported value in your data source, your promotion will display in
Shopping ads and free listings by default.

You may have previously submitted the following values as destinations for
your products: Shopping Actions, Surfaces across Google, Local surfaces
across Google. To represent these values use `FREE_LISTINGS`,
`FREE_LOCAL_LISTINGS`, `LOCAL_INVENTORY_ADS`. For more details see
[Promotion
destination](https://support.google.com/merchants/answer/13837465?sjid=5155774230887277618-NC)

`
repeated .google.shopping.type.Destination.DestinationEnum promotion_destinations = 6 [(.google.api.field_behavior) = REQUIRED];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/8/docs/api/java/util/List.html<https://docs.oracle.com/javase/8/docs/api/java/lang/Integer.html>` | A list containing the enum numeric values on the wire for promotionDestinations. |

### getPromotionDisplayTimePeriod()

    public Interval getPromotionDisplayTimePeriod()

Optional. `TimePeriod` representation of the promotion's display dates.
This attribute specifies the date and time frame when the promotion will be
live on Google.com and Shopping ads. If the display time period for
promotion `promotion_display_time_period` attribute is not specified, the
promotion effective time period `promotion_effective_time_period`
determines the date and time frame when the promotion will be live on
Google.com and Shopping ads.

`
.google.type.Interval promotion_display_time_period = 26 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `com.google.type.Interval` | The promotionDisplayTimePeriod. |

### getPromotionDisplayTimePeriodBuilder()

    public Interval.Builder getPromotionDisplayTimePeriodBuilder()

Optional. `TimePeriod` representation of the promotion's display dates.
This attribute specifies the date and time frame when the promotion will be
live on Google.com and Shopping ads. If the display time period for
promotion `promotion_display_time_period` attribute is not specified, the
promotion effective time period `promotion_effective_time_period`
determines the date and time frame when the promotion will be live on
Google.com and Shopping ads.

`
.google.type.Interval promotion_display_time_period = 26 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `com.google.type.Interval.Builder` |   |

### getPromotionDisplayTimePeriodOrBuilder()

    public IntervalOrBuilder getPromotionDisplayTimePeriodOrBuilder()

Optional. `TimePeriod` representation of the promotion's display dates.
This attribute specifies the date and time frame when the promotion will be
live on Google.com and Shopping ads. If the display time period for
promotion `promotion_display_time_period` attribute is not specified, the
promotion effective time period `promotion_effective_time_period`
determines the date and time frame when the promotion will be live on
Google.com and Shopping ads.

`
.google.type.Interval promotion_display_time_period = 26 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `com.google.type.IntervalOrBuilder` |   |

### getPromotionEffectiveTimePeriod()

    public Interval getPromotionEffectiveTimePeriod()

Required. `TimePeriod` representation of the promotion's effective dates.
This attribute specifies that the promotion can be tested on your online
store during this time period.

`
.google.type.Interval promotion_effective_time_period = 25 [(.google.api.field_behavior) = REQUIRED];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `com.google.type.Interval` | The promotionEffectiveTimePeriod. |

### getPromotionEffectiveTimePeriodBuilder()

    public Interval.Builder getPromotionEffectiveTimePeriodBuilder()

Required. `TimePeriod` representation of the promotion's effective dates.
This attribute specifies that the promotion can be tested on your online
store during this time period.

`
.google.type.Interval promotion_effective_time_period = 25 [(.google.api.field_behavior) = REQUIRED];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `com.google.type.Interval.Builder` |   |

### getPromotionEffectiveTimePeriodOrBuilder()

    public IntervalOrBuilder getPromotionEffectiveTimePeriodOrBuilder()

Required. `TimePeriod` representation of the promotion's effective dates.
This attribute specifies that the promotion can be tested on your online
store during this time period.

`
.google.type.Interval promotion_effective_time_period = 25 [(.google.api.field_behavior) = REQUIRED];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `com.google.type.IntervalOrBuilder` |   |

### getPromotionUrl()

    public String getPromotionUrl()

Optional. URL to the page on the merchant's site where the promotion shows.
Local Inventory ads promotions throw an error if no `promotion_url` is
included. URL is used to confirm that the promotion is valid and can be
redeemed.

`string promotion_url = 31 [(.google.api.field_behavior) = OPTIONAL];`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/8/docs/api/java/lang/String.html` | The promotionUrl. |

### getPromotionUrlBytes()

    public ByteString getPromotionUrlBytes()

Optional. URL to the page on the merchant's site where the promotion shows.
Local Inventory ads promotions throw an error if no `promotion_url` is
included. URL is used to confirm that the promotion is valid and can be
redeemed.

`string promotion_url = 31 [(.google.api.field_behavior) = OPTIONAL];`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.ByteString.html` | The bytes for promotionUrl. |

### getStoreApplicability()

    public StoreApplicability getStoreApplicability()

Optional. Whether the promotion applies to [all stores, or only specified
stores](https://support.google.com/merchants/answer/13857563?sjid=17642868584668136159-NC).
Local Inventory ads promotions throw an error if no store applicability is
included. An `INVALID_ARGUMENT` error is thrown if `store_applicability` is
set to `ALL_STORES` and `store_codes_inclusion` or `score_code_exclusion`
is set to a value.

`
.google.shopping.merchant.promotions.v1.StoreApplicability store_applicability = 28 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.StoreApplicability` | The storeApplicability. |

### getStoreApplicabilityValue()

    public int getStoreApplicabilityValue()

Optional. Whether the promotion applies to [all stores, or only specified
stores](https://support.google.com/merchants/answer/13857563?sjid=17642868584668136159-NC).
Local Inventory ads promotions throw an error if no store applicability is
included. An `INVALID_ARGUMENT` error is thrown if `store_applicability` is
set to `ALL_STORES` and `store_codes_inclusion` or `score_code_exclusion`
is set to a value.

`
.google.shopping.merchant.promotions.v1.StoreApplicability store_applicability = 28 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` | The enum numeric value on the wire for storeApplicability. |

### getStoreCodesExclusion(int index)

    public String getStoreCodesExclusion(int index)

Optional. [Store codes to
exclude](https://support.google.com/merchants/answer/13859586?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion. The store filter attributes only applies when the
`store_applicability` attribute is set to
[specific_stores](https://support.google.com/merchants/answer/13857563?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string store_codes_exclusion = 30 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `index` | `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` The index of the element to return. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/8/docs/api/java/lang/String.html` | The storeCodesExclusion at the given index. |

### getStoreCodesExclusionBytes(int index)

    public ByteString getStoreCodesExclusionBytes(int index)

Optional. [Store codes to
exclude](https://support.google.com/merchants/answer/13859586?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion. The store filter attributes only applies when the
`store_applicability` attribute is set to
[specific_stores](https://support.google.com/merchants/answer/13857563?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string store_codes_exclusion = 30 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `index` | `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` The index of the value to return. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.ByteString.html` | The bytes of the storeCodesExclusion at the given index. |

### getStoreCodesExclusionCount()

    public int getStoreCodesExclusionCount()

Optional. [Store codes to
exclude](https://support.google.com/merchants/answer/13859586?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion. The store filter attributes only applies when the
`store_applicability` attribute is set to
[specific_stores](https://support.google.com/merchants/answer/13857563?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string store_codes_exclusion = 30 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` | The count of storeCodesExclusion. |

### getStoreCodesExclusionList()

    public ProtocolStringList getStoreCodesExclusionList()

Optional. [Store codes to
exclude](https://support.google.com/merchants/answer/13859586?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion. The store filter attributes only applies when the
`store_applicability` attribute is set to
[specific_stores](https://support.google.com/merchants/answer/13857563?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string store_codes_exclusion = 30 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.ProtocolStringList.html` | A list containing the storeCodesExclusion. |

### getStoreCodesInclusion(int index)

    public String getStoreCodesInclusion(int index)

Optional. [Store codes to
include](https://support.google.com/merchants/answer/13857470?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion. The store filter attributes only applies when the
`store_applicability` attribute is set to
[specific_stores](https://support.google.com/merchants/answer/13857563?ref_topic=13773355&sjid=17642868584668136159-NC).

Store code (the store ID from
your Business Profile) of the physical store the product is sold in. See
the [Local product inventory data
specification](https://support.google.com/merchants/answer/3061342) for
more information.

`repeated string store_codes_inclusion = 29 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `index` | `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` The index of the element to return. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/8/docs/api/java/lang/String.html` | The storeCodesInclusion at the given index. |

### getStoreCodesInclusionBytes(int index)

    public ByteString getStoreCodesInclusionBytes(int index)

Optional. [Store codes to
include](https://support.google.com/merchants/answer/13857470?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion. The store filter attributes only applies when the
`store_applicability` attribute is set to
[specific_stores](https://support.google.com/merchants/answer/13857563?ref_topic=13773355&sjid=17642868584668136159-NC).

Store code (the store ID from
your Business Profile) of the physical store the product is sold in. See
the [Local product inventory data
specification](https://support.google.com/merchants/answer/3061342) for
more information.

`repeated string store_codes_inclusion = 29 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `index` | `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` The index of the value to return. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.ByteString.html` | The bytes of the storeCodesInclusion at the given index. |

### getStoreCodesInclusionCount()

    public int getStoreCodesInclusionCount()

Optional. [Store codes to
include](https://support.google.com/merchants/answer/13857470?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion. The store filter attributes only applies when the
`store_applicability` attribute is set to
[specific_stores](https://support.google.com/merchants/answer/13857563?ref_topic=13773355&sjid=17642868584668136159-NC).

Store code (the store ID from
your Business Profile) of the physical store the product is sold in. See
the [Local product inventory data
specification](https://support.google.com/merchants/answer/3061342) for
more information.

`repeated string store_codes_inclusion = 29 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` | The count of storeCodesInclusion. |

### getStoreCodesInclusionList()

    public ProtocolStringList getStoreCodesInclusionList()

Optional. [Store codes to
include](https://support.google.com/merchants/answer/13857470?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion. The store filter attributes only applies when the
`store_applicability` attribute is set to
[specific_stores](https://support.google.com/merchants/answer/13857563?ref_topic=13773355&sjid=17642868584668136159-NC).

Store code (the store ID from
your Business Profile) of the physical store the product is sold in. See
the [Local product inventory data
specification](https://support.google.com/merchants/answer/3061342) for
more information.

`repeated string store_codes_inclusion = 29 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.ProtocolStringList.html` | A list containing the storeCodesInclusion. |

### hasFreeGiftValue()

    public boolean hasFreeGiftValue()

Optional. [Free gift
value](https://support.google.com/merchants/answer/13844477?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion.

`
.google.shopping.type.Price free_gift_value = 22 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` | Whether the freeGiftValue field is set. |

### hasLimitValue()

    public boolean hasLimitValue()

Optional. [Maximum product
price](https://support.google.com/merchants/answer/2906014) for
promotion.

`.google.shopping.type.Price limit_value = 18 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` | Whether the limitValue field is set. |

### hasMinimumPurchaseAmount()

    public boolean hasMinimumPurchaseAmount()

Optional. [Minimum purchase
amount](https://support.google.com/merchants/answer/13837705?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion.

`
.google.shopping.type.Price minimum_purchase_amount = 15 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` | Whether the minimumPurchaseAmount field is set. |

### hasMoneyOffAmount()

    public boolean hasMoneyOffAmount()

Optional. The [money off
amount](https://support.google.com/merchants/answer/13838101?ref_topic=13773355&sjid=17642868584668136159-NC)
offered in the promotion.

`
.google.shopping.type.Price money_off_amount = 20 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` | Whether the moneyOffAmount field is set. |

### hasPromotionDisplayTimePeriod()

    public boolean hasPromotionDisplayTimePeriod()

Optional. `TimePeriod` representation of the promotion's display dates.
This attribute specifies the date and time frame when the promotion will be
live on Google.com and Shopping ads. If the display time period for
promotion `promotion_display_time_period` attribute is not specified, the
promotion effective time period `promotion_effective_time_period`
determines the date and time frame when the promotion will be live on
Google.com and Shopping ads.

`
.google.type.Interval promotion_display_time_period = 26 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` | Whether the promotionDisplayTimePeriod field is set. |

### hasPromotionEffectiveTimePeriod()

    public boolean hasPromotionEffectiveTimePeriod()

Required. `TimePeriod` representation of the promotion's effective dates.
This attribute specifies that the promotion can be tested on your online
store during this time period.

`
.google.type.Interval promotion_effective_time_period = 25 [(.google.api.field_behavior) = REQUIRED];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` | Whether the promotionEffectiveTimePeriod field is set. |

### internalGetFieldAccessorTable()

    protected GeneratedMessage.FieldAccessorTable internalGetFieldAccessorTable()

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.GeneratedMessage.FieldAccessorTable.html` |   |

**Overrides** [GeneratedMessage.Builder\<BuilderType\>.internalGetFieldAccessorTable()](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.GeneratedMessage.Builder.html#com_google_protobuf_GeneratedMessage_Builder_internalGetFieldAccessorTable__)

### isInitialized()

    public final boolean isInitialized()

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` |   |

**Overrides** [GeneratedMessage.Builder\<BuilderType\>.isInitialized()](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.GeneratedMessage.Builder.html#com_google_protobuf_GeneratedMessage_Builder_isInitialized__)

### mergeFreeGiftValue(Price value)

    public Attributes.Builder mergeFreeGiftValue(Price value)

Optional. [Free gift
value](https://support.google.com/merchants/answer/13844477?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion.

`
.google.shopping.type.Price free_gift_value = 22 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `value` | `com.google.shopping.type.Price` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` |   |

### mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)

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

| **Parameters** ||
|---|---|
| **Name** | **Description** |
| `input` | `https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.CodedInputStream.html` |
| `extensionRegistry` | `https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.ExtensionRegistryLite.html` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` |   |

**Overrides** [AbstractMessage.Builder\<BuilderType\>.mergeFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.AbstractMessage.Builder.html#com_google_protobuf_AbstractMessage_Builder_mergeFrom_com_google_protobuf_CodedInputStream_com_google_protobuf_ExtensionRegistryLite_)

| **Exceptions** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/8/docs/api/java/io/IOException.html` |   |

### mergeFrom(Message other)

    public Attributes.Builder mergeFrom(Message other)

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `other` | `https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.Message.html` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` |   |

**Overrides** [AbstractMessage.Builder\<BuilderType\>.mergeFrom(Message other)](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.AbstractMessage.Builder.html#com_google_protobuf_AbstractMessage_Builder_mergeFrom_com_google_protobuf_Message_)

### mergeFrom(Attributes other)

    public Attributes.Builder mergeFrom(Attributes other)

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `other` | `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` |   |

### mergeLimitValue(Price value)

    public Attributes.Builder mergeLimitValue(Price value)

Optional. [Maximum product
price](https://support.google.com/merchants/answer/2906014) for
promotion.

`.google.shopping.type.Price limit_value = 18 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `value` | `com.google.shopping.type.Price` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` |   |

### mergeMinimumPurchaseAmount(Price value)

    public Attributes.Builder mergeMinimumPurchaseAmount(Price value)

Optional. [Minimum purchase
amount](https://support.google.com/merchants/answer/13837705?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion.

`
.google.shopping.type.Price minimum_purchase_amount = 15 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `value` | `com.google.shopping.type.Price` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` |   |

### mergeMoneyOffAmount(Price value)

    public Attributes.Builder mergeMoneyOffAmount(Price value)

Optional. The [money off
amount](https://support.google.com/merchants/answer/13838101?ref_topic=13773355&sjid=17642868584668136159-NC)
offered in the promotion.

`
.google.shopping.type.Price money_off_amount = 20 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `value` | `com.google.shopping.type.Price` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` |   |

### mergePromotionDisplayTimePeriod(Interval value)

    public Attributes.Builder mergePromotionDisplayTimePeriod(Interval value)

Optional. `TimePeriod` representation of the promotion's display dates.
This attribute specifies the date and time frame when the promotion will be
live on Google.com and Shopping ads. If the display time period for
promotion `promotion_display_time_period` attribute is not specified, the
promotion effective time period `promotion_effective_time_period`
determines the date and time frame when the promotion will be live on
Google.com and Shopping ads.

`
.google.type.Interval promotion_display_time_period = 26 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `value` | `com.google.type.Interval` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` |   |

### mergePromotionEffectiveTimePeriod(Interval value)

    public Attributes.Builder mergePromotionEffectiveTimePeriod(Interval value)

Required. `TimePeriod` representation of the promotion's effective dates.
This attribute specifies that the promotion can be tested on your online
store during this time period.

`
.google.type.Interval promotion_effective_time_period = 25 [(.google.api.field_behavior) = REQUIRED];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `value` | `com.google.type.Interval` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` |   |

### setBrandExclusion(int index, String value)

    public Attributes.Builder setBrandExclusion(int index, String value)

Optional. Product filter by [brand
exclusion](https://support.google.com/merchants/answer/13861679?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion. The product filter attributes only applies when the
products eligible for promotion product applicability
`product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string brand_exclusion = 12 [(.google.api.field_behavior) = OPTIONAL];`

| **Parameters** ||
|---|---|
| **Name** | **Description** |
| `index` | `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` The index to set the value at. |
| `value` | `https://docs.oracle.com/javase/8/docs/api/java/lang/String.html` The brandExclusion to set. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### setBrandInclusion(int index, String value)

    public Attributes.Builder setBrandInclusion(int index, String value)

Optional. Product filter by brand for the promotion. The product filter
attributes only applies when the products eligible for promotion product
applicability `product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string brand_inclusion = 8 [(.google.api.field_behavior) = OPTIONAL];`

| **Parameters** ||
|---|---|
| **Name** | **Description** |
| `index` | `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` The index to set the value at. |
| `value` | `https://docs.oracle.com/javase/8/docs/api/java/lang/String.html` The brandInclusion to set. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### setCouponValueType(CouponValueType value)

    public Attributes.Builder setCouponValueType(CouponValueType value)

Required. The [coupon value type](https://support.google.com/merchants/answer/13861986?ref_topic=13773355&sjid=17642868584668136159-NC)
attribute to signal the type of promotion that you are running. Depending
on type of the selected coupon value [some attributes are
required](https://support.google.com/merchants/answer/6393006?ref_topic=7322920).

`
.google.shopping.merchant.promotions.v1.CouponValueType coupon_value_type = 5 [(.google.api.field_behavior) = REQUIRED];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `value` | `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.CouponValueType` The couponValueType to set. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### setCouponValueTypeValue(int value)

    public Attributes.Builder setCouponValueTypeValue(int value)

Required. The [coupon value type](https://support.google.com/merchants/answer/13861986?ref_topic=13773355&sjid=17642868584668136159-NC)
attribute to signal the type of promotion that you are running. Depending
on type of the selected coupon value [some attributes are
required](https://support.google.com/merchants/answer/6393006?ref_topic=7322920).

`
.google.shopping.merchant.promotions.v1.CouponValueType coupon_value_type = 5 [(.google.api.field_behavior) = REQUIRED];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `value` | `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` The enum numeric value on the wire for couponValueType to set. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### setFreeGiftDescription(String value)

    public Attributes.Builder setFreeGiftDescription(String value)

Optional. [Free gift
description](https://support.google.com/merchants/answer/13847245?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion.

`string free_gift_description = 23 [(.google.api.field_behavior) = OPTIONAL];`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `value` | `https://docs.oracle.com/javase/8/docs/api/java/lang/String.html` The freeGiftDescription to set. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### setFreeGiftDescriptionBytes(ByteString value)

    public Attributes.Builder setFreeGiftDescriptionBytes(ByteString value)

Optional. [Free gift
description](https://support.google.com/merchants/answer/13847245?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion.

`string free_gift_description = 23 [(.google.api.field_behavior) = OPTIONAL];`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `value` | `https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.ByteString.html` The bytes for freeGiftDescription to set. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### setFreeGiftItemId(String value)

    public Attributes.Builder setFreeGiftItemId(String value)

Optional. [Free gift item
ID](https://support.google.com/merchants/answer/13857152?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion.

`string free_gift_item_id = 24 [(.google.api.field_behavior) = OPTIONAL];`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `value` | `https://docs.oracle.com/javase/8/docs/api/java/lang/String.html` The freeGiftItemId to set. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### setFreeGiftItemIdBytes(ByteString value)

    public Attributes.Builder setFreeGiftItemIdBytes(ByteString value)

Optional. [Free gift item
ID](https://support.google.com/merchants/answer/13857152?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion.

`string free_gift_item_id = 24 [(.google.api.field_behavior) = OPTIONAL];`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `value` | `https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.ByteString.html` The bytes for freeGiftItemId to set. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### setFreeGiftValue(Price value)

    public Attributes.Builder setFreeGiftValue(Price value)

Optional. [Free gift
value](https://support.google.com/merchants/answer/13844477?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion.

`
.google.shopping.type.Price free_gift_value = 22 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `value` | `com.google.shopping.type.Price` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` |   |

### setFreeGiftValue(Price.Builder builderForValue)

    public Attributes.Builder setFreeGiftValue(Price.Builder builderForValue)

Optional. [Free gift
value](https://support.google.com/merchants/answer/13844477?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion.

`
.google.shopping.type.Price free_gift_value = 22 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `builderForValue` | `com.google.shopping.type.Price.Builder` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` |   |

### setGenericRedemptionCode(String value)

    public Attributes.Builder setGenericRedemptionCode(String value)

Optional. Generic redemption code for the promotion. To be used with the
`offerType` field and must meet the [minimum
requirements](https://support.google.com/merchants/answer/13837405?ref_topic=13773355&sjid=17642868584668136159-NC).

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

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `value` | `https://docs.oracle.com/javase/8/docs/api/java/lang/String.html` The genericRedemptionCode to set. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### setGenericRedemptionCodeBytes(ByteString value)

    public Attributes.Builder setGenericRedemptionCodeBytes(ByteString value)

Optional. Generic redemption code for the promotion. To be used with the
`offerType` field and must meet the [minimum
requirements](https://support.google.com/merchants/answer/13837405?ref_topic=13773355&sjid=17642868584668136159-NC).

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

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `value` | `https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.ByteString.html` The bytes for genericRedemptionCode to set. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### setGetThisQuantityDiscounted(long value)

    public Attributes.Builder setGetThisQuantityDiscounted(long value)

Optional. The number of items discounted in the promotion. The attribute is
set when `couponValueType` is equal to `buy_m_get_n_money_off` or
`buy_m_get_n_percent_off`.

`int64 get_this_quantity_discounted = 21 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `value` | `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` The getThisQuantityDiscounted to set. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### setItemGroupIdExclusion(int index, String value)

    public Attributes.Builder setItemGroupIdExclusion(int index, String value)

Optional. Product filter by [item group
ID](https://support.google.com/merchants/answer/13837298?ref_topic=13773355&sjid=17642868584668136159-NC).
The product filter attributes only applies when the products eligible for
promotion product applicability `product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).
exclusion for the promotion.

`repeated string item_group_id_exclusion = 13 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameters** ||
|---|---|
| **Name** | **Description** |
| `index` | `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` The index to set the value at. |
| `value` | `https://docs.oracle.com/javase/8/docs/api/java/lang/String.html` The itemGroupIdExclusion to set. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### setItemGroupIdInclusion(int index, String value)

    public Attributes.Builder setItemGroupIdInclusion(int index, String value)

Optional. Product filter by item group ID for the promotion. The product
filter attributes only applies when the products eligible for promotion
product applicability \[product_applicability\] attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string item_group_id_inclusion = 9 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameters** ||
|---|---|
| **Name** | **Description** |
| `index` | `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` The index to set the value at. |
| `value` | `https://docs.oracle.com/javase/8/docs/api/java/lang/String.html` The itemGroupIdInclusion to set. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### setItemIdExclusion(int index, String value)

    public Attributes.Builder setItemIdExclusion(int index, String value)

Optional. Product filter by [item ID
exclusion](https://support.google.com/merchants/answer/13863524?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion. The product filter attributes only applies when the
products eligible for promotion product applicability
`product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string item_id_exclusion = 11 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameters** ||
|---|---|
| **Name** | **Description** |
| `index` | `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` The index to set the value at. |
| `value` | `https://docs.oracle.com/javase/8/docs/api/java/lang/String.html` The itemIdExclusion to set. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### setItemIdInclusion(int index, String value)

    public Attributes.Builder setItemIdInclusion(int index, String value)

Optional. Product filter by [item
ID](https://support.google.com/merchants/answer/13861565?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion. The product filter attributes only applies when the
products eligible for promotion product applicability
`product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string item_id_inclusion = 7 [(.google.api.field_behavior) = OPTIONAL];`

| **Parameters** ||
|---|---|
| **Name** | **Description** |
| `index` | `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` The index to set the value at. |
| `value` | `https://docs.oracle.com/javase/8/docs/api/java/lang/String.html` The itemIdInclusion to set. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### setLimitQuantity(long value)

    public Attributes.Builder setLimitQuantity(long value)

Optional. [Maximum purchase
quantity](https://support.google.com/merchants/answer/13861564?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion.

`int64 limit_quantity = 17 [(.google.api.field_behavior) = OPTIONAL];`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `value` | `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` The limitQuantity to set. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### setLimitValue(Price value)

    public Attributes.Builder setLimitValue(Price value)

Optional. [Maximum product
price](https://support.google.com/merchants/answer/2906014) for
promotion.

`.google.shopping.type.Price limit_value = 18 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `value` | `com.google.shopping.type.Price` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` |   |

### setLimitValue(Price.Builder builderForValue)

    public Attributes.Builder setLimitValue(Price.Builder builderForValue)

Optional. [Maximum product
price](https://support.google.com/merchants/answer/2906014) for
promotion.

`.google.shopping.type.Price limit_value = 18 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `builderForValue` | `com.google.shopping.type.Price.Builder` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` |   |

### setLongTitle(String value)

    public Attributes.Builder setLongTitle(String value)

Required. [Long
title](https://support.google.com/merchants/answer/13838102?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion.

`string long_title = 4 [(.google.api.field_behavior) = REQUIRED];`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `value` | `https://docs.oracle.com/javase/8/docs/api/java/lang/String.html` The longTitle to set. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### setLongTitleBytes(ByteString value)

    public Attributes.Builder setLongTitleBytes(ByteString value)

Required. [Long
title](https://support.google.com/merchants/answer/13838102?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion.

`string long_title = 4 [(.google.api.field_behavior) = REQUIRED];`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `value` | `https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.ByteString.html` The bytes for longTitle to set. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### setMinimumPurchaseAmount(Price value)

    public Attributes.Builder setMinimumPurchaseAmount(Price value)

Optional. [Minimum purchase
amount](https://support.google.com/merchants/answer/13837705?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion.

`
.google.shopping.type.Price minimum_purchase_amount = 15 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `value` | `com.google.shopping.type.Price` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` |   |

### setMinimumPurchaseAmount(Price.Builder builderForValue)

    public Attributes.Builder setMinimumPurchaseAmount(Price.Builder builderForValue)

Optional. [Minimum purchase
amount](https://support.google.com/merchants/answer/13837705?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion.

`
.google.shopping.type.Price minimum_purchase_amount = 15 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `builderForValue` | `com.google.shopping.type.Price.Builder` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` |   |

### setMinimumPurchaseQuantity(long value)

    public Attributes.Builder setMinimumPurchaseQuantity(long value)

`int64 minimum_purchase_quantity = 16 [(.google.api.field_behavior) = OPTIONAL];`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `value` | `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` The minimumPurchaseQuantity to set. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### setMoneyOffAmount(Price value)

    public Attributes.Builder setMoneyOffAmount(Price value)

Optional. The [money off
amount](https://support.google.com/merchants/answer/13838101?ref_topic=13773355&sjid=17642868584668136159-NC)
offered in the promotion.

`
.google.shopping.type.Price money_off_amount = 20 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `value` | `com.google.shopping.type.Price` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` |   |

### setMoneyOffAmount(Price.Builder builderForValue)

    public Attributes.Builder setMoneyOffAmount(Price.Builder builderForValue)

Optional. The [money off
amount](https://support.google.com/merchants/answer/13838101?ref_topic=13773355&sjid=17642868584668136159-NC)
offered in the promotion.

`
.google.shopping.type.Price money_off_amount = 20 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `builderForValue` | `com.google.shopping.type.Price.Builder` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` |   |

### setOfferType(OfferType value)

    public Attributes.Builder setOfferType(OfferType value)

Required.
[Type](https://support.google.com/merchants/answer/13837405?ref_topic=13773355&sjid=17642868584668136159-NC)
of the promotion. Use this attribute to indicate whether or not customers
need a coupon code to redeem your promotion.

`
.google.shopping.merchant.promotions.v1.OfferType offer_type = 2 [(.google.api.field_behavior) = REQUIRED];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `value` | `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.OfferType` The offerType to set. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### setOfferTypeValue(int value)

    public Attributes.Builder setOfferTypeValue(int value)

Required.
[Type](https://support.google.com/merchants/answer/13837405?ref_topic=13773355&sjid=17642868584668136159-NC)
of the promotion. Use this attribute to indicate whether or not customers
need a coupon code to redeem your promotion.

`
.google.shopping.merchant.promotions.v1.OfferType offer_type = 2 [(.google.api.field_behavior) = REQUIRED];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `value` | `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` The enum numeric value on the wire for offerType to set. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### setPercentOff(long value)

    public Attributes.Builder setPercentOff(long value)

Optional. The [percentage
discount](https://support.google.com/merchants/answer/13837404?sjid=17642868584668136159-NC)
offered in the promotion.

`int64 percent_off = 19 [(.google.api.field_behavior) = OPTIONAL];`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `value` | `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` The percentOff to set. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### setProductApplicability(ProductApplicability value)

    public Attributes.Builder setProductApplicability(ProductApplicability value)

Required. Applicability of the promotion to either all products or
[only specific
products](https://support.google.com/merchants/answer/6396257?ref_topic=6396150&sjid=17642868584668136159-NC).

`
.google.shopping.merchant.promotions.v1.ProductApplicability product_applicability = 1 [(.google.api.field_behavior) = REQUIRED];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `value` | `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.ProductApplicability` The productApplicability to set. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### setProductApplicabilityValue(int value)

    public Attributes.Builder setProductApplicabilityValue(int value)

Required. Applicability of the promotion to either all products or
[only specific
products](https://support.google.com/merchants/answer/6396257?ref_topic=6396150&sjid=17642868584668136159-NC).

`
.google.shopping.merchant.promotions.v1.ProductApplicability product_applicability = 1 [(.google.api.field_behavior) = REQUIRED];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `value` | `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` The enum numeric value on the wire for productApplicability to set. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### setProductTypeExclusion(int index, String value)

    public Attributes.Builder setProductTypeExclusion(int index, String value)

Optional. Product filter by [product type
exclusion](https://support.google.com/merchants/answer/13863746?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion. The product filter attributes only applies when the
products eligible for promotion product applicability
`product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string product_type_exclusion = 14 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameters** ||
|---|---|
| **Name** | **Description** |
| `index` | `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` The index to set the value at. |
| `value` | `https://docs.oracle.com/javase/8/docs/api/java/lang/String.html` The productTypeExclusion to set. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### setProductTypeInclusion(int index, String value)

    public Attributes.Builder setProductTypeInclusion(int index, String value)

Optional. Product filter by product type for the promotion. The product
filter attributes only applies when the products eligible for promotion
product applicability `product_applicability` attribute is set to
[specific_products](https://support.google.com/merchants/answer/13837299?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string product_type_inclusion = 10 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameters** ||
|---|---|
| **Name** | **Description** |
| `index` | `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` The index to set the value at. |
| `value` | `https://docs.oracle.com/javase/8/docs/api/java/lang/String.html` The productTypeInclusion to set. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### setPromotionDestinations(int index, Destination.DestinationEnum value)

    public Attributes.Builder setPromotionDestinations(int index, Destination.DestinationEnum value)

Required. The list of destinations (also known as [Marketing
methods](https://support.google.com/merchants/answer/15130232)) where the
promotion applies to. If you don't specify a destination by including a
supported value in your data source, your promotion will display in
Shopping ads and free listings by default.

You may have previously submitted the following values as destinations for
your products: Shopping Actions, Surfaces across Google, Local surfaces
across Google. To represent these values use `FREE_LISTINGS`,
`FREE_LOCAL_LISTINGS`, `LOCAL_INVENTORY_ADS`. For more details see
[Promotion
destination](https://support.google.com/merchants/answer/13837465?sjid=5155774230887277618-NC)

`
repeated .google.shopping.type.Destination.DestinationEnum promotion_destinations = 6 [(.google.api.field_behavior) = REQUIRED];
`

| **Parameters** ||
|---|---|
| **Name** | **Description** |
| `index` | `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` The index to set the value at. |
| `value` | `com.google.shopping.type.Destination.DestinationEnum` The promotionDestinations to set. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### setPromotionDestinationsValue(int index, int value)

    public Attributes.Builder setPromotionDestinationsValue(int index, int value)

Required. The list of destinations (also known as [Marketing
methods](https://support.google.com/merchants/answer/15130232)) where the
promotion applies to. If you don't specify a destination by including a
supported value in your data source, your promotion will display in
Shopping ads and free listings by default.

You may have previously submitted the following values as destinations for
your products: Shopping Actions, Surfaces across Google, Local surfaces
across Google. To represent these values use `FREE_LISTINGS`,
`FREE_LOCAL_LISTINGS`, `LOCAL_INVENTORY_ADS`. For more details see
[Promotion
destination](https://support.google.com/merchants/answer/13837465?sjid=5155774230887277618-NC)

`
repeated .google.shopping.type.Destination.DestinationEnum promotion_destinations = 6 [(.google.api.field_behavior) = REQUIRED];
`

| **Parameters** ||
|---|---|
| **Name** | **Description** |
| `index` | `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` The index to set the value at. |
| `value` | `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` The enum numeric value on the wire for promotionDestinations to set. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### setPromotionDisplayTimePeriod(Interval value)

    public Attributes.Builder setPromotionDisplayTimePeriod(Interval value)

Optional. `TimePeriod` representation of the promotion's display dates.
This attribute specifies the date and time frame when the promotion will be
live on Google.com and Shopping ads. If the display time period for
promotion `promotion_display_time_period` attribute is not specified, the
promotion effective time period `promotion_effective_time_period`
determines the date and time frame when the promotion will be live on
Google.com and Shopping ads.

`
.google.type.Interval promotion_display_time_period = 26 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `value` | `com.google.type.Interval` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` |   |

### setPromotionDisplayTimePeriod(Interval.Builder builderForValue)

    public Attributes.Builder setPromotionDisplayTimePeriod(Interval.Builder builderForValue)

Optional. `TimePeriod` representation of the promotion's display dates.
This attribute specifies the date and time frame when the promotion will be
live on Google.com and Shopping ads. If the display time period for
promotion `promotion_display_time_period` attribute is not specified, the
promotion effective time period `promotion_effective_time_period`
determines the date and time frame when the promotion will be live on
Google.com and Shopping ads.

`
.google.type.Interval promotion_display_time_period = 26 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `builderForValue` | `com.google.type.Interval.Builder` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` |   |

### setPromotionEffectiveTimePeriod(Interval value)

    public Attributes.Builder setPromotionEffectiveTimePeriod(Interval value)

Required. `TimePeriod` representation of the promotion's effective dates.
This attribute specifies that the promotion can be tested on your online
store during this time period.

`
.google.type.Interval promotion_effective_time_period = 25 [(.google.api.field_behavior) = REQUIRED];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `value` | `com.google.type.Interval` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` |   |

### setPromotionEffectiveTimePeriod(Interval.Builder builderForValue)

    public Attributes.Builder setPromotionEffectiveTimePeriod(Interval.Builder builderForValue)

Required. `TimePeriod` representation of the promotion's effective dates.
This attribute specifies that the promotion can be tested on your online
store during this time period.

`
.google.type.Interval promotion_effective_time_period = 25 [(.google.api.field_behavior) = REQUIRED];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `builderForValue` | `com.google.type.Interval.Builder` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` |   |

### setPromotionUrl(String value)

    public Attributes.Builder setPromotionUrl(String value)

Optional. URL to the page on the merchant's site where the promotion shows.
Local Inventory ads promotions throw an error if no `promotion_url` is
included. URL is used to confirm that the promotion is valid and can be
redeemed.

`string promotion_url = 31 [(.google.api.field_behavior) = OPTIONAL];`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `value` | `https://docs.oracle.com/javase/8/docs/api/java/lang/String.html` The promotionUrl to set. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### setPromotionUrlBytes(ByteString value)

    public Attributes.Builder setPromotionUrlBytes(ByteString value)

Optional. URL to the page on the merchant's site where the promotion shows.
Local Inventory ads promotions throw an error if no `promotion_url` is
included. URL is used to confirm that the promotion is valid and can be
redeemed.

`string promotion_url = 31 [(.google.api.field_behavior) = OPTIONAL];`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `value` | `https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.ByteString.html` The bytes for promotionUrl to set. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### setStoreApplicability(StoreApplicability value)

    public Attributes.Builder setStoreApplicability(StoreApplicability value)

Optional. Whether the promotion applies to [all stores, or only specified
stores](https://support.google.com/merchants/answer/13857563?sjid=17642868584668136159-NC).
Local Inventory ads promotions throw an error if no store applicability is
included. An `INVALID_ARGUMENT` error is thrown if `store_applicability` is
set to `ALL_STORES` and `store_codes_inclusion` or `score_code_exclusion`
is set to a value.

`
.google.shopping.merchant.promotions.v1.StoreApplicability store_applicability = 28 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `value` | `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.StoreApplicability` The storeApplicability to set. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### setStoreApplicabilityValue(int value)

    public Attributes.Builder setStoreApplicabilityValue(int value)

Optional. Whether the promotion applies to [all stores, or only specified
stores](https://support.google.com/merchants/answer/13857563?sjid=17642868584668136159-NC).
Local Inventory ads promotions throw an error if no store applicability is
included. An `INVALID_ARGUMENT` error is thrown if `store_applicability` is
set to `ALL_STORES` and `store_codes_inclusion` or `score_code_exclusion`
is set to a value.

`
.google.shopping.merchant.promotions.v1.StoreApplicability store_applicability = 28 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `value` | `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` The enum numeric value on the wire for storeApplicability to set. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### setStoreCodesExclusion(int index, String value)

    public Attributes.Builder setStoreCodesExclusion(int index, String value)

Optional. [Store codes to
exclude](https://support.google.com/merchants/answer/13859586?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion. The store filter attributes only applies when the
`store_applicability` attribute is set to
[specific_stores](https://support.google.com/merchants/answer/13857563?ref_topic=13773355&sjid=17642868584668136159-NC).

`repeated string store_codes_exclusion = 30 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameters** ||
|---|---|
| **Name** | **Description** |
| `index` | `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` The index to set the value at. |
| `value` | `https://docs.oracle.com/javase/8/docs/api/java/lang/String.html` The storeCodesExclusion to set. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |

### setStoreCodesInclusion(int index, String value)

    public Attributes.Builder setStoreCodesInclusion(int index, String value)

Optional. [Store codes to
include](https://support.google.com/merchants/answer/13857470?ref_topic=13773355&sjid=17642868584668136159-NC)
for the promotion. The store filter attributes only applies when the
`store_applicability` attribute is set to
[specific_stores](https://support.google.com/merchants/answer/13857563?ref_topic=13773355&sjid=17642868584668136159-NC).

Store code (the store ID from
your Business Profile) of the physical store the product is sold in. See
the [Local product inventory data
specification](https://support.google.com/merchants/answer/3061342) for
more information.

`repeated string store_codes_inclusion = 29 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameters** ||
|---|---|
| **Name** | **Description** |
| `index` | `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` The index to set the value at. |
| `value` | `https://docs.oracle.com/javase/8/docs/api/java/lang/String.html` The storeCodesInclusion to set. |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-promotions/latest/com.google.shopping.merchant.promotions.v1.Attributes.Builder` | This builder for chaining. |