## Week of October 5th, 2026

Added `duration_unit` field to the [`Warranty`](https://developers.google.com/merchant/api/reference/rest/products_v1/Attributes#FIELDS.warranty) attribute.

Learn more about [Warranty](https://support.google.com/merchants/answer/18562485).

## Week of September 8th, 2026

Added `mileage_allowance` in the [`installment`](https://developers.google.com/merchant/api/reference/rest/products_v1/ProductAttributes#ProductInstallment).

## Week of September 2nd, 2026

Added `certification_document_link` and `certification_label_link` fields to the [`Certification`](https://developers.google.com/merchant/api/reference/rest/products_v1/Attributes#FIELDS.certification) attribute.

Learn more about [Certification](https://support.google.com/merchants/answer/13528839).

## Week of July 27th, 2026

### Products Service

Added the following real estate rental-related attribute to the
[`ProductAttributes`](https://developers.google.com/merchant/api/reference/rest/products_v1/ProductAttributes) resource:

- [`lease_term`](https://developers.google.com/merchant/api/reference/rest/products_v1/ProductAttributes#FIELDS.lease_term)

## Week of July 20th, 2026

### Products Service

Added the [`returns`](https://developers.google.com/merchant/api/reference/rest/products_v1/ProductAttributes#FIELDS.returns)
field to enable [offer-level return policy
overrides](https://support.google.com/merchants/answer/17081382). This field lets
you specify granular return rules (such as country, window days, item
conditions, return methods, outcomes, fees, and policy URL) directly in the
product feed and API.

## Week of June 15th, 2026

### Products Service

Added the following real estate rental-related attributes to the
[`ProductAttributes`](https://developers.google.com/merchant/api/reference/rest/products_v1/ProductAttributes) resource:

- [`display_address`](https://developers.google.com/merchant/api/reference/rest/products_v1/ProductAttributes#FIELDS.display_address)
- [`latitude`](https://developers.google.com/merchant/api/reference/rest/products_v1/ProductAttributes#FIELDS.latitude)
- [`longitude`](https://developers.google.com/merchant/api/reference/rest/products_v1/ProductAttributes#FIELDS.longitude)
- [`neighborhood`](https://developers.google.com/merchant/api/reference/rest/products_v1/ProductAttributes#FIELDS.neighborhood)
- [`unit_area`](https://developers.google.com/merchant/api/reference/rest/products_v1/ProductAttributes#FIELDS.unit_area)
- [`number_of_units`](https://developers.google.com/merchant/api/reference/rest/products_v1/ProductAttributes#FIELDS.number_of_units)
- [`property_name`](https://developers.google.com/merchant/api/reference/rest/products_v1/ProductAttributes#FIELDS.property_name)
- [`number_of_bedrooms`](https://developers.google.com/merchant/api/reference/rest/products_v1/ProductAttributes#FIELDS.number_of_bedrooms)
- [`number_of_bathrooms`](https://developers.google.com/merchant/api/reference/rest/products_v1/ProductAttributes#FIELDS.number_of_bathrooms)
- [`property_type`](https://developers.google.com/merchant/api/reference/rest/products_v1/ProductAttributes#FIELDS.property_type)
- [`amenity_feature`](https://developers.google.com/merchant/api/reference/rest/products_v1/ProductAttributes#FIELDS.amenity_feature)
- [`utilities_included`](https://developers.google.com/merchant/api/reference/rest/products_v1/ProductAttributes#FIELDS.utilities_included)
- [`pet_policy`](https://developers.google.com/merchant/api/reference/rest/products_v1/ProductAttributes#FIELDS.pet_policy)
- [`specialty_housing_type`](https://developers.google.com/merchant/api/reference/rest/products_v1/ProductAttributes#FIELDS.specialty_housing_type)
- [`product_fee`](https://developers.google.com/merchant/api/reference/rest/products_v1/ProductAttributes#FIELDS.product_fee)
- [`short_title`](https://developers.google.com/merchant/api/reference/rest/products_v1/ProductAttributes#FIELDS.short_title)

These attributes are only available to merchants participating in the closed
beta. If you are interested in participating, reach out to your Google sales
representative.

## Week of May 18th, 2026

### Products Service

Added the following [conversational attributes](https://support.google.com/merchants/answer/17085370) to the [`ProductAttributes`](https://developers.google.com/merchant/api/reference/rest/products_v1/ProductAttributes) resource:

- [`questions_and_answers`](https://developers.google.com/merchant/api/reference/rest/products_v1/ProductAttributes#FIELDS.questions_and_answers)
- [`popularity_rank`](https://developers.google.com/merchant/api/reference/rest/products_v1/ProductAttributes#FIELDS.popularity_rank)
- [`item_group_title`](https://developers.google.com/merchant/api/reference/rest/products_v1/ProductAttributes#FIELDS.item_group_title)
- [`document_links`](https://developers.google.com/merchant/api/reference/rest/products_v1/ProductAttributes#FIELDS.document_links)
- [`variant_options`](https://developers.google.com/merchant/api/reference/rest/products_v1/ProductAttributes#FIELDS.variant_options)
- [`related_products`](https://developers.google.com/merchant/api/reference/rest/products_v1/ProductAttributes#FIELDS.related_products)

These attributes are not yet available in client libraries and will be rolled
out soon. In the interim, they can be specified using custom attributes.

## Week of May 11, 2026

### Products Service

Added the `archived` field to the `Product` resource to indicate whether a
product is archived. Learn more about
[offer visibility](https://support.google.com/merchants/answer/12488713).

## Week of April 27, 2026

Added `total_amount` in the [`installment`](https://developers.google.com/merchant/api/release-notes/merchant/api/reference/rest/products_v1/ProductAttributes#ProductInstallment).

### Products Service

Added the following vehicle-related attributes to the [`ProductAttributes`](https://developers.google.com/merchant/api/reference/rest/products_v1/ProductAttributes) resource:

- [`vin`](https://developers.google.com/merchant/api/reference/rest/products_v1/ProductAttributes#FIELDS.vin)
- [`model`](https://developers.google.com/merchant/api/reference/rest/products_v1/ProductAttributes#FIELDS.model)
- [`trim`](https://developers.google.com/merchant/api/reference/rest/products_v1/ProductAttributes#FIELDS.trim)
- [`body_style`](https://developers.google.com/merchant/api/reference/rest/products_v1/ProductAttributes#FIELDS.body_style)
- [`year`](https://developers.google.com/merchant/api/reference/rest/products_v1/ProductAttributes#FIELDS.year)
- [`mileage`](https://developers.google.com/merchant/api/reference/rest/products_v1/ProductAttributes#FIELDS.mileage)
- [`electric_range`](https://developers.google.com/merchant/api/reference/rest/products_v1/ProductAttributes#FIELDS.electric_range)
- [`fuel_consumption`](https://developers.google.com/merchant/api/reference/rest/products_v1/ProductAttributes#FIELDS.fuel_consumption)
- [`fuel_consumption_discharged_battery`](https://developers.google.com/merchant/api/reference/rest/products_v1/ProductAttributes#FIELDS.fuel_consumption_discharged_battery)
- [`energy_consumption`](https://developers.google.com/merchant/api/reference/rest/products_v1/ProductAttributes#FIELDS.energy_consumption)
- [`co2_emissions`](https://developers.google.com/merchant/api/reference/rest/products_v1/ProductAttributes#FIELDS.co2_emissions)
- [`date_first_registered`](https://developers.google.com/merchant/api/reference/rest/products_v1/ProductAttributes#FIELDS.date_first_registered)
- [`engine`](https://developers.google.com/merchant/api/reference/rest/products_v1/ProductAttributes#FIELDS.engine)
- [`emissions_standard`](https://developers.google.com/merchant/api/reference/rest/products_v1/ProductAttributes#FIELDS.emissions_standard)
- [`certified_pre_owned`](https://developers.google.com/merchant/api/reference/rest/products_v1/ProductAttributes#FIELDS.certified_pre_owned)
- [`vehicle_msrp`](https://developers.google.com/merchant/api/reference/rest/products_v1/ProductAttributes#FIELDS.vehicle_msrp)
- [`vehicle_all_in_price`](https://developers.google.com/merchant/api/reference/rest/products_v1/ProductAttributes#FIELDS.vehicle_all_in_price)
- [`vehicle_price_type`](https://developers.google.com/merchant/api/reference/rest/products_v1/ProductAttributes#FIELDS.vehicle_price_type)
- [`vehicle_mandatory_inspection_included`](https://developers.google.com/merchant/api/reference/rest/products_v1/ProductAttributes#FIELDS.vehicle_mandatory_inspection_included)
- [`vehicle_expenses`](https://developers.google.com/merchant/api/reference/rest/products_v1/ProductAttributes#FIELDS.vehicle_expenses)
- [`warranty`](https://developers.google.com/merchant/api/reference/rest/products_v1/ProductAttributes#FIELDS.warranty)
- [`pickup_cost`](https://developers.google.com/merchant/api/reference/rest/products_v1/ProductAttributes#FIELDS.pickup_cost)

## Week of April 13, 2026

Added the
[`loyalty_program_label`](https://developers.google.com/merchant/api/reference/rest/products_v1/Attributes#FIELDS.loyalty_program_label)
and
[`loyalty_tier_label`](https://developers.google.com/merchant/api/reference/rest/products_v1/Attributes#FIELDS.loyalty_tier_label)
fields to Shipping attributes to enable configuring shipping options for
specific loyalty programs and tiers.

Added the
[`minimum_order_values`](https://developers.google.com/merchant/api/reference/rest/products_v1/Attributes#FIELDS.minimum_order_values)
field to specify the minimum order value required in the shopping cart before
a user can initiate checkout.

Added "annual_percentage_rate" in the [`installment`](https://developers.google.com/merchant/api/release-notes/merchant/api/reference/rest/products_v1/ProductAttributes#ProductInstallment).

### Products Service

Added the
[`video_links`](https://developers.google.com/merchant/api/reference/rest/products_v1/ProductAttributes#FIELDS.video_links)
field. This field lets you provide video URLs for products.

## Week of Apr 6, 2026

Added the `base64_encoded_name` field to the `Product` and `ProductInput` proto
messages to enable using output names directly as input in cases where the name
contains special characters.

## Week of March 16, 2026

### Products Service

Added the [`return_policy_label`](https://developers.google.com/merchant/api/reference/rest/products_v1/Attributes#FIELDS.return_policy_label) field.

## Week of December 1, 2025

Added "WEEK" as a possible subscription period in [`period`](https://developers.google.com/merchant/api/release-notes/merchant/api/reference/rest/products_v1/Attributes#SubscriptionCost).

## Week of November 17, 2025

Product identifiers within request paths now support unpadded base64url encoding
in addition to un-encoded/plain values. This enhancement ensures that products
with special characters (such as forward slashes) in their identifiers can be
successfully retrieved and processed.

## Week of November 3, 2025

### Products Service

Added the [`shipping_handling_business_days`](https://developers.google.com/merchant/api/reference/rest/products_v1/Attributes#FIELDS.shipping_handling_business_days)
and the [`shipping_transit_business_days`](https://developers.google.com/merchant/api/reference/rest/products_v1/Attributes#FIELDS.shipping_transit_business_days)
fields to enable specifying days of the week which should be considered for the
delivery time calculation.

## Week of September 29, 2025

### Products Service

Added the [`carrier_shipping`](https://developers.google.com/merchant/api/reference/rest/products_v1/Attributes#FIELDS.carrier_shipping)
field to enable specifying shipping configuration using carriers for both
shipping cost and shipping speed.

## Week of July 7, 2025

### Products Service

Added a plural version of GTINs field and deprecated a singular one.
For now both fields will be populated when reading and values from both fields
will be used during insertion.

## Week of June 16, 2025

### Products Service

Added the [`maximum_retail_price`](https://developers.google.com/merchant/api/reference/rest/products_v1/Attributes#FIELDS.maximum_retail_price) field to enable the specification of maximum retail price (MRP) in India.

## Week of May 19, 2025

### Products Service

Increased the maximum value of page size from 250 to 1000.

## Week of May 12, 2025

### ProductInputs Service

Reduced the delay between data source creation and when the data source is ready
to be used. Previously, the `Data source not found` error was returned when
trying to insert items within 5 minutes of the data source being created. This
applies to data sources used for inserting products, promotions, product
reviews, and merchant reviews.

## Week of Apr 14, 2025

The fields `taxes` and `tax_category` in the `Product` resource have been
deprecated due to the deprecation of `accounttax` in the Content API.

## Week of Apr 03, 2025

### Products Service

Launch of the
[`automated_discounts`](https://developers.google.com/merchant/api/reference/rest/products_v1/accounts.products#AutomatedDiscounts)
field. Automated discounts are designed to dynamically adjust product price
discounts such that they help you effectively maximize gross profit performance
across your entire inventory.

The `automated_discounts` field contains information about the prior prices,
price prior to the application of consecutive price reductions, and the
Automated Discount price.

## Week of Mar 24, 2025

### ProductInputs Service

Launch
of [`accounts.productInputs.patch`](https://developers.google.com/merchant/api/reference/rest/products_v1/accounts.productInputs/patch)
method that lets you update individual product inputs through update mask and
without providing all the fields of the `accounts.productInputs` resource.

## Week of Jan 6, 2025

The `domain` field in returned errors is now populated with
`merchantapi.googleapis.com` instead of `global`

## Week of Dec 12, 2024

### Products Service

Added
the [`sustainability_incentives`](https://developers.google.com/merchant/api/reference/rest/products_v1/Attributes#FIELDS.sustainability_incentives)
field to specify sustainability incentives such as tax credit or price discount
for your products. If the field value isn't provided, the item is not eligible
for any sustainability incentives.

## Week of Nov 15, 2024

### Products Service

For `LoyaltyProgram`, added
the [`shipping_label`](https://developers.google.com/merchant/api/reference/rest/products_v1/Attributes#FIELDS.shipping_label)
field to specify eligibility. If the field has value, this offer has loyalty
shipping benefit. If the field value isn't provided, the item is not eligible
for loyalty shipping for the given loyalty tier.

## Week of July 15, 2024

### Products Service

Added
the [`member_price_effective_date`](https://developers.google.com/merchant/api/reference/rest/products_v1/Attributes#LoyaltyProgram.FIELDS.member_price_effective_date)
field. This update lets you specify, if applicable, the date range during which
the loyalty
member price is effective. If the field value isn't provided, the member price
is always
effective.

## Week of May 27, 2024

Beta launch of Products sub-API