On August 23, 2022 we will gradually start updating the way country targeting works for shopping products. As a result, the targetCountry
field for newly inserted products and the country
field for new datafeeds may be empty in the Content API for Shopping . While targetCountry
and country
are now deprecated, there are no plans to remove these fields from v2.1 to preserve backward compatibility. We recommend using feedLabel to name new products and feeds, and using the shipping field to specify the countries to target.
If you're accessing accounts whose product data you don’t have total control over and you are unsure whether the products or datafeeds will have ONLY a feedLabel
field beginning in late August, we recommend you update your code to support the feedLabel
field.
This upcoming change might impact or break your API integration if your application cannot handle products without a targetCountry
or datafeeds without a country
.
See Country targeting in Shopping Ads campaigns is changing in August 2022 for how this change will impact Google Ads.
What’s already changed
On August 8, 2022 , the Content API for Shopping added the feedLabel
field to the products resource. As of August 8, 2022, feedLabel
can only accept and return two-letter CLDR territory codes . Products now require either targetCountry
or feedLabel
. As long as the feedLabel
set is a valid two-letter CLDR code, targetCountry
will be backfilled for compatibility.
We have changed the definition of the product identifier (the id , i.e. the REST ID
). feedLabel
now replaces targetCountry
as the third component of the identifier, so it is no longer just a valid two-letter CLDR code. You can find an example shown here .
This change to product identifier is backwards compatible, so existing REST IDs for existing products will continue to work without change.
Important : feedLabel
doesn’t impact targeting. This means if you use feedLabel
instead of targetCountry
, you need to specify all countries you want to target in the shipping attribute.
What’s coming next
We’re starting a gradual rollout to all users on August 23, 2022 . When the upcoming change reaches you, you’ll be able to create a product or datafeed with any string (not just a two-letter CLDR code) as the feedLabel
via the API or the Merchant Center. You’ll still be able to use a two-letter country code in targetCountry
for backwards compatibility.
After the upcoming change, if you submit a feedLabel
that isn’t a CLDR territory code, the API will return those products without a targetCountry
or those datafeeds without a country
. Instead, only their feedLabel
will be populated. This may break your codebase if your implementation expects a value in targetCountry
for products or a value in country
for datafeeds.
How you’re impacted
Products
If you continue inserting your products with a targetCountry
, you are not required to make any changes at this time, as the feedLabel
value in the products
REST ID will be identical to the targetCountry
you inserted.
However, if you use a feedLabel
in Merchant Center or the API that is not a CLDR territory code, we highly recommend you update your codebase to use feedLabels
on all product insertions instead of targetCountry
to avoid issues with your API integration.
All products inserted with a feedLabel
instead of targetCountry
, even if the feedLabel
is a CLDR territory code, will not automatically target that country. You must explicitly set the countries you want to target via the shipping
field.
Datafeeds
Note that starting August 23, 2022, feed label will replace the current country of sale value in the Merchant Center UI. The Content API will be expected to support this change via the datafeeds service starting mid-September. These new datafeeds will only have the feedLabel
field set, not the country
field, unless you explicitly set the feedLabel
to a CLDR territory code.
To support new users, we highly recommend you update your codebase to use feedLabels
on all datafeeds instead of country
to avoid issues with your API integration.
Recommendation for third party integrations
If you’re a third party or agency that manages your customers' accounts for them, we highly recommend you check your codebase is able handle products without a targetCountry
and datafeeds without a country
before August 23, 2022.
After the gradual rollout starting in late August, your merchants will be able to modify products directly in Merchant Center to create a product with a feedLabel
that is not a valid two-letter CLDR territory code. When this product is returned via products.list
, you could encounter issues if your implementation expects a value in targetCountry
.
As well, after the gradual rollout in late August, new users will create datafeeds that by default have a feedLabel
and no country
field. When this datafeed is returned via datafeeds.list
, you could encounter issues if your implementation expects a value in country
.
How to detect if you have offers without a country in your Merchant Center account
Make a request to products.list
.
Filter your products to search for products where the targetCountry
field does not exist on the product.
If any products appear, you have offers without a country in your Merchant Center.
Detailed Changes
To view a detailed breakdown of the changes to the Content API by this feature launch, see the guide here .
Datafeeds Service
Starting mid-September the datafeeds
service will begin to return feedLabel
on all datafeeds, which will be the country
value if that is how the datafeed
was created. The datafeeds
service will also return the country
field if the feedLabel
is a valid country code for backwards compatibility.
Opt out of receiving products and datafeeds without a country
If you’re concerned your codebase cannot handle products and datafeeds without a country, and you want to opt out of receiving them via the Content API after August 23, then please fill out the following form: Feed label replaces target country in the Content API for Shopping - temporary exemption . Once you have fully supported feedLabel, you will be able to opt back in to receiving these offers.
If you have any questions or concerns, please don't hesitate to contact us via the forum .
Benji Rothman, Content API for Shopping Team