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:
Set the etag field as an empty string for the initial shipping setting
creation.
After the initial creation, call the get method to obtain an etag and
the current shipping setting data before calling insert.
Modify the shipping setting information.
Call the insert method with the shipping setting information
and the etag obtained in step 2.
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.
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:
Set the etag field as an empty string for the initial shipping setting
creation.
After the initial creation, call the get method to obtain an etag and
the current shipping setting data before calling insert.
Modify the shipping setting information.
Call the insert method with the shipping setting information
and the etag obtained in step 2.
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.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-16 UTC."],[],[],null,["# Interface ShippingSettingsOrBuilder (1.0.0)\n\nVersion latestkeyboard_arrow_down\n\n- [1.0.0 (latest)](/java/docs/reference/google-shopping-merchant-accounts/latest/com.google.shopping.merchant.accounts.v1.ShippingSettingsOrBuilder)\n- [0.26.0](/java/docs/reference/google-shopping-merchant-accounts/0.26.0/com.google.shopping.merchant.accounts.v1.ShippingSettingsOrBuilder)\n- [0.24.0](/java/docs/reference/google-shopping-merchant-accounts/0.24.0/com.google.shopping.merchant.accounts.v1.ShippingSettingsOrBuilder)\n- [0.23.0](/java/docs/reference/google-shopping-merchant-accounts/0.23.0/com.google.shopping.merchant.accounts.v1.ShippingSettingsOrBuilder)\n- [0.20.0](/java/docs/reference/google-shopping-merchant-accounts/0.20.0/com.google.shopping.merchant.accounts.v1.ShippingSettingsOrBuilder)\n- [0.19.0](/java/docs/reference/google-shopping-merchant-accounts/0.19.0/com.google.shopping.merchant.accounts.v1.ShippingSettingsOrBuilder)\n- [0.18.0](/java/docs/reference/google-shopping-merchant-accounts/0.18.0/com.google.shopping.merchant.accounts.v1.ShippingSettingsOrBuilder)\n- [0.16.0](/java/docs/reference/google-shopping-merchant-accounts/0.16.0/com.google.shopping.merchant.accounts.v1.ShippingSettingsOrBuilder)\n- [0.15.0](/java/docs/reference/google-shopping-merchant-accounts/0.15.0/com.google.shopping.merchant.accounts.v1.ShippingSettingsOrBuilder)\n- [0.14.0](/java/docs/reference/google-shopping-merchant-accounts/0.14.0/com.google.shopping.merchant.accounts.v1.ShippingSettingsOrBuilder)\n- [0.13.0](/java/docs/reference/google-shopping-merchant-accounts/0.13.0/com.google.shopping.merchant.accounts.v1.ShippingSettingsOrBuilder)\n- [0.12.0](/java/docs/reference/google-shopping-merchant-accounts/0.12.0/com.google.shopping.merchant.accounts.v1.ShippingSettingsOrBuilder)\n- [0.11.0](/java/docs/reference/google-shopping-merchant-accounts/0.11.0/com.google.shopping.merchant.accounts.v1.ShippingSettingsOrBuilder)\n- [0.10.0](/java/docs/reference/google-shopping-merchant-accounts/0.10.0/com.google.shopping.merchant.accounts.v1.ShippingSettingsOrBuilder)\n- [0.9.0](/java/docs/reference/google-shopping-merchant-accounts/0.9.0/com.google.shopping.merchant.accounts.v1.ShippingSettingsOrBuilder)\n- [0.8.0](/java/docs/reference/google-shopping-merchant-accounts/0.8.0/com.google.shopping.merchant.accounts.v1.ShippingSettingsOrBuilder)\n- [0.7.0](/java/docs/reference/google-shopping-merchant-accounts/0.7.0/com.google.shopping.merchant.accounts.v1.ShippingSettingsOrBuilder)\n- [0.5.0](/java/docs/reference/google-shopping-merchant-accounts/0.5.0/com.google.shopping.merchant.accounts.v1.ShippingSettingsOrBuilder)\n- [0.4.0](/java/docs/reference/google-shopping-merchant-accounts/0.4.0/com.google.shopping.merchant.accounts.v1.ShippingSettingsOrBuilder)\n- [0.3.0](/java/docs/reference/google-shopping-merchant-accounts/0.3.0/com.google.shopping.merchant.accounts.v1.ShippingSettingsOrBuilder)\n- [0.2.0](/java/docs/reference/google-shopping-merchant-accounts/0.2.0/com.google.shopping.merchant.accounts.v1.ShippingSettingsOrBuilder)\n- [0.1.0](/java/docs/reference/google-shopping-merchant-accounts/0.1.0/com.google.shopping.merchant.accounts.v1.ShippingSettingsOrBuilder) \n\n public interface ShippingSettingsOrBuilder extends MessageOrBuilder\n\nImplements\n----------\n\n[MessageOrBuilder](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.MessageOrBuilder.html)\n\nMethods\n-------\n\n### getEtag()\n\n public abstract String getEtag()\n\nRequired. This field helps avoid async issues. It ensures that the shipping\nsetting\ndata doesn't change between the `get` call and the `insert` call. The user\nshould follow these steps:\n\n1. Set the etag field as an empty string for the initial shipping setting\n creation.\n\n2. After the initial creation, call the `get` method to obtain an etag and\n the current shipping setting data before calling `insert`.\n\n3. Modify the shipping setting information.\n\n4. Call the `insert` method with the shipping setting information\n and the etag obtained in step 2.\n\n5. If the shipping setting data changes between step 2 and step 4, the\n insert request will fail because the etag changes every time the shipping\n setting data changes. In this case, the user should repeat steps 2-4 with\n the new etag.\n\n`string etag = 4 [(.google.api.field_behavior) = REQUIRED];`\n\n### getEtagBytes()\n\n public abstract ByteString getEtagBytes()\n\nRequired. This field helps avoid async issues. It ensures that the shipping\nsetting\ndata doesn't change between the `get` call and the `insert` call. The user\nshould follow these steps:\n\n1. Set the etag field as an empty string for the initial shipping setting\n creation.\n\n2. After the initial creation, call the `get` method to obtain an etag and\n the current shipping setting data before calling `insert`.\n\n3. Modify the shipping setting information.\n\n4. Call the `insert` method with the shipping setting information\n and the etag obtained in step 2.\n\n5. If the shipping setting data changes between step 2 and step 4, the\n insert request will fail because the etag changes every time the shipping\n setting data changes. In this case, the user should repeat steps 2-4 with\n the new etag.\n\n`string etag = 4 [(.google.api.field_behavior) = REQUIRED];`\n\n### getName()\n\n public abstract String getName()\n\nIdentifier. The resource name of the shipping settings.\nFormat: `accounts/{account}/shippingSettings`. For example,\n`accounts/123456/shippingSettings`.\n\n`string name = 1 [(.google.api.field_behavior) = IDENTIFIER];`\n\n### getNameBytes()\n\n public abstract ByteString getNameBytes()\n\nIdentifier. The resource name of the shipping settings.\nFormat: `accounts/{account}/shippingSettings`. For example,\n`accounts/123456/shippingSettings`.\n\n`string name = 1 [(.google.api.field_behavior) = IDENTIFIER];`\n\n### getServices(int index)\n\n public abstract Service getServices(int index)\n\nOptional. The target account's list of services.\n\n`\nrepeated .google.shopping.merchant.accounts.v1.Service services = 2 [(.google.api.field_behavior) = OPTIONAL];\n`\n\n### getServicesCount()\n\n public abstract int getServicesCount()\n\nOptional. The target account's list of services.\n\n`\nrepeated .google.shopping.merchant.accounts.v1.Service services = 2 [(.google.api.field_behavior) = OPTIONAL];\n`\n\n### getServicesList()\n\n public abstract List\u003cService\u003e getServicesList()\n\nOptional. The target account's list of services.\n\n`\nrepeated .google.shopping.merchant.accounts.v1.Service services = 2 [(.google.api.field_behavior) = OPTIONAL];\n`\n\n### getServicesOrBuilder(int index)\n\n public abstract ServiceOrBuilder getServicesOrBuilder(int index)\n\nOptional. The target account's list of services.\n\n`\nrepeated .google.shopping.merchant.accounts.v1.Service services = 2 [(.google.api.field_behavior) = OPTIONAL];\n`\n\n### getServicesOrBuilderList()\n\n public abstract List\u003c? extends ServiceOrBuilder\u003e getServicesOrBuilderList()\n\nOptional. The target account's list of services.\n\n`\nrepeated .google.shopping.merchant.accounts.v1.Service services = 2 [(.google.api.field_behavior) = OPTIONAL];\n`\n\n### getWarehouses(int index)\n\n public abstract Warehouse getWarehouses(int index)\n\nOptional. A list of warehouses which can be referred to in `services`.\n\n`\nrepeated .google.shopping.merchant.accounts.v1.Warehouse warehouses = 3 [(.google.api.field_behavior) = OPTIONAL];\n`\n\n### getWarehousesCount()\n\n public abstract int getWarehousesCount()\n\nOptional. A list of warehouses which can be referred to in `services`.\n\n`\nrepeated .google.shopping.merchant.accounts.v1.Warehouse warehouses = 3 [(.google.api.field_behavior) = OPTIONAL];\n`\n\n### getWarehousesList()\n\n public abstract List\u003cWarehouse\u003e getWarehousesList()\n\nOptional. A list of warehouses which can be referred to in `services`.\n\n`\nrepeated .google.shopping.merchant.accounts.v1.Warehouse warehouses = 3 [(.google.api.field_behavior) = OPTIONAL];\n`\n\n### getWarehousesOrBuilder(int index)\n\n public abstract WarehouseOrBuilder getWarehousesOrBuilder(int index)\n\nOptional. A list of warehouses which can be referred to in `services`.\n\n`\nrepeated .google.shopping.merchant.accounts.v1.Warehouse warehouses = 3 [(.google.api.field_behavior) = OPTIONAL];\n`\n\n### getWarehousesOrBuilderList()\n\n public abstract List\u003c? extends WarehouseOrBuilder\u003e getWarehousesOrBuilderList()\n\nOptional. A list of warehouses which can be referred to in `services`.\n\n`\nrepeated .google.shopping.merchant.accounts.v1.Warehouse warehouses = 3 [(.google.api.field_behavior) = OPTIONAL];\n`"]]
