# Interface ShippingSettingsOrBuilder (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 interface ShippingSettingsOrBuilder extends MessageOrBuilder

## Implements

[MessageOrBuilder](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.MessageOrBuilder.html)

## Methods

### getEtag()

    public abstract String getEtag()

Required. This field helps avoid async issues. It ensures that the shipping
setting
data doesn't change between the `get` call and the `insert` call. The user
should follow these steps:

1. Set the etag field as an empty string for the initial shipping setting
   creation.

2. After the initial creation, call the `get` method to obtain an etag and
   the current shipping setting data before calling `insert`.

3. Modify the shipping setting information.

4. Call the `insert` method with the shipping setting information
   and the etag obtained in step 2.

5. If the shipping setting data changes between step 2 and step 4, the
   insert request will fail because the etag changes every time the shipping
   setting data changes. In this case, the user should repeat steps 2-4 with
   the new etag.

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

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

### getEtagBytes()

    public abstract ByteString getEtagBytes()

Required. This field helps avoid async issues. It ensures that the shipping
setting
data doesn't change between the `get` call and the `insert` call. The user
should follow these steps:

1. Set the etag field as an empty string for the initial shipping setting
   creation.

2. After the initial creation, call the `get` method to obtain an etag and
   the current shipping setting data before calling `insert`.

3. Modify the shipping setting information.

4. Call the `insert` method with the shipping setting information
   and the etag obtained in step 2.

5. If the shipping setting data changes between step 2 and step 4, the
   insert request will fail because the etag changes every time the shipping
   setting data changes. In this case, the user should repeat steps 2-4 with
   the new etag.

`string etag = 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 etag. |

### getName()

    public abstract String getName()

Identifier. The resource name of the shipping settings.
Format: `accounts/{account}/shippingSettings`. For example,
`accounts/123456/shippingSettings`.

`string name = 1 [(.google.api.field_behavior) = IDENTIFIER];`

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

### getNameBytes()

    public abstract ByteString getNameBytes()

Identifier. The resource name of the shipping settings.
Format: `accounts/{account}/shippingSettings`. For example,
`accounts/123456/shippingSettings`.

`string name = 1 [(.google.api.field_behavior) = IDENTIFIER];`

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

### getServices(int index)

    public abstract Service getServices(int index)

Optional. The target account's list of services.

`
repeated .google.shopping.merchant.accounts.v1.Service services = 2 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `index` | `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` |

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

### getServicesCount()

    public abstract int getServicesCount()

Optional. The target account's list of services.

`
repeated .google.shopping.merchant.accounts.v1.Service services = 2 [(.google.api.field_behavior) = OPTIONAL];
`

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

### getServicesList()

    public abstract List<Service> getServicesList()

Optional. The target account's list of services.

`
repeated .google.shopping.merchant.accounts.v1.Service services = 2 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/8/docs/api/java/util/List.html<https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-accounts/latest/com.google.shopping.merchant.accounts.v1.Service>` |   |

### getServicesOrBuilder(int index)

    public abstract ServiceOrBuilder getServicesOrBuilder(int index)

Optional. The target account's list of services.

`
repeated .google.shopping.merchant.accounts.v1.Service services = 2 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `index` | `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` |

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

### getServicesOrBuilderList()

    public abstract List<? extends ServiceOrBuilder> getServicesOrBuilderList()

Optional. The target account's list of services.

`
repeated .google.shopping.merchant.accounts.v1.Service services = 2 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/8/docs/api/java/util/List.html<? extends com.google.shopping.merchant.accounts.v1.ServiceOrBuilder>` |   |

### getWarehouses(int index)

    public abstract Warehouse getWarehouses(int index)

Optional. A list of warehouses which can be referred to in `services`.

`
repeated .google.shopping.merchant.accounts.v1.Warehouse warehouses = 3 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `index` | `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` |

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

### getWarehousesCount()

    public abstract int getWarehousesCount()

Optional. A list of warehouses which can be referred to in `services`.

`
repeated .google.shopping.merchant.accounts.v1.Warehouse warehouses = 3 [(.google.api.field_behavior) = OPTIONAL];
`

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

### getWarehousesList()

    public abstract List<Warehouse> getWarehousesList()

Optional. A list of warehouses which can be referred to in `services`.

`
repeated .google.shopping.merchant.accounts.v1.Warehouse warehouses = 3 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/8/docs/api/java/util/List.html<https://docs.cloud.google.com/java/docs/reference/google-shopping-merchant-accounts/latest/com.google.shopping.merchant.accounts.v1.Warehouse>` |   |

### getWarehousesOrBuilder(int index)

    public abstract WarehouseOrBuilder getWarehousesOrBuilder(int index)

Optional. A list of warehouses which can be referred to in `services`.

`
repeated .google.shopping.merchant.accounts.v1.Warehouse warehouses = 3 [(.google.api.field_behavior) = OPTIONAL];
`

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `index` | `https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html` |

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

### getWarehousesOrBuilderList()

    public abstract List<? extends WarehouseOrBuilder> getWarehousesOrBuilderList()

Optional. A list of warehouses which can be referred to in `services`.

`
repeated .google.shopping.merchant.accounts.v1.Warehouse warehouses = 3 [(.google.api.field_behavior) = OPTIONAL];
`

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `https://docs.oracle.com/javase/8/docs/api/java/util/List.html<? extends com.google.shopping.merchant.accounts.v1.WarehouseOrBuilder>` |   |