[[["わかりやすい","easyToUnderstand","thumb-up"],["問題の解決に役立った","solvedMyProblem","thumb-up"],["その他","otherUp","thumb-up"]],[["必要な情報がない","missingTheInformationINeed","thumb-down"],["複雑すぎる / 手順が多すぎる","tooComplicatedTooManySteps","thumb-down"],["最新ではない","outOfDate","thumb-down"],["翻訳に関する問題","translationIssue","thumb-down"],["サンプル / コードに問題がある","samplesCodeIssue","thumb-down"],["その他","otherDown","thumb-down"]],["最終更新日 2025-08-13 UTC。"],[[["\u003cp\u003eThe Merchant API beta is now available, replacing the Content API for Shopping.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003efeedLabel\u003c/code\u003e field is introduced for products and datafeeds, replacing \u003ccode\u003etargetCountry\u003c/code\u003e in REST IDs for new products.\u003c/p\u003e\n"],["\u003cp\u003eCountry targeting is now primarily managed through the \u003ccode\u003eshipping\u003c/code\u003e field for products and the \u003ccode\u003etargetCountries\u003c/code\u003e field for datafeeds.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003etargetCountry\u003c/code\u003e is deprecated for products; existing products retain their REST IDs.\u003c/p\u003e\n"],["\u003cp\u003eWhile 'UK' is converted to 'GB' for \u003ccode\u003etargetCountry\u003c/code\u003e, this conversion does not apply to the \u003ccode\u003efeedLabel\u003c/code\u003e field.\u003c/p\u003e\n"]]],["The Merchant API beta, a new version of the Content API for Shopping, is introduced. The `feedLabel` field, replacing `targetCountry` in REST IDs for new products, is available for products and datafeeds, formatted with uppercase letters, numbers, and dashes, up to 20 characters. `feedLabel` must be provided when inserting products. The `shipping` field now defines product target countries; `targetCountry` is deprecated. Using `feedLabel`, the `datafeeds` resource includes a `targetCountries` field for targeting. `UK` in `targetCountry` is converted to `GB`.\n"],null,["# Migrate to feed labels\n\nYou can use the\n[`feedLabel`](/shopping-content/reference/rest/v2.1/products#Product.FIELDS.feed_label)\nfield to add a label to your products and datafeeds.\n\nFeed labels can have the following format:\n\n- Type string\n- Less than or equal to 20 characters\n- Uppercase letters (A-Z)\n- Numbers (0-9)\n- Dashes (-)\n\n`feedLabel` is available in the following resources:\n\n- [`products`](/shopping-content/reference/rest/v2.1/products)\n- [`datafeeds`](/shopping-content/reference/rest/v2.1/datafeeds)\n- [`datafeedstatuses`](//shopping-content/reference/rest/v2.1/datafeedstatuses)\n\nREST ID\n-------\n\n`feedLabel` replaces\n[`targetCountry`](/shopping-content/reference/rest/v2.1/products#Product.FIELDS.target_country)\nin [REST IDs](/shopping-content/guides/products/product-id) for new products.\n\nInstead of `online:language:targetCountry:offerId`, the REST ID is now formed as\n`online:language:feedLabel:offerId` for new products. This doesn't change the\nREST ID of your existing products.\n\nGet and list products\n---------------------\n\nThe `feedLabel` field is always populated for all returned products.\n\nIf `feedLabel` is a valid CLDR territory code, we automatically backfill the\n`targetCountry` field for compatibility. If the `feedLabel` isn't a valid CLDR\nterritory code, we leave `targetCountry` empty.\n| **Warning:** Backfilled `targetCountry` values don't enable your products to serve in the provided country. Make sure all countries you want to target are included in the `shipping` field.\n\nThe same changes apply for `productstatuses` endpoints.\n\nCountry-specific fields are empty for offers with a `feedLabel` that isn't a\nCLDR territory code.\n\nInsert and update products\n--------------------------\n\nEither `feedLabel` or `targetCountry` is required to insert new products. If you\ninsert or update products with a `feedLabel` and `targetCountry`, their values\nmust match.\n\nYou receive an error from the API if the fields are both empty, or if their\nvalues don't match.\n\nSee [Use feed labels to advertise products from specific\nfeeds](//support.google.com/merchants/answer/12453549) for more details.\n\nCountry targeting\n-----------------\n\nUse one of the following to ensure your products target the right countries:\n\n- [`shipping`](/shopping-content/reference/rest/v2.1/products#Product.FIELDS.shipping) field of the `products` resource\n- [`targetCountries`](/shopping-content/reference/rest/v2.1/datafeeds#DatafeedTarget.FIELDS.target_countries) field of the `datafeeds` resource\n\n### Products\n\nThe `targetCountry` field for `products` is deprecated. Instead, use the\n`shipping` field to specify your target countries.\n\nIf you want to [target multiple\ncountries](/shopping-content/guides/targeting-ads-in-multiple-countries), you\ncan continue to use `shipping` to add additional countries.\n\nSee [Targeting ads in multiple\ncountries](/shopping-content/guides/targeting-ads-in-multiple-countries) for\nmore information.\n\n### Datafeeds\n\nYou can now see which countries a `datafeed` explicitly targets in\n[`targets`](/shopping-content/reference/rest/v2.1/datafeeds#resource:-datafeed).\nThis applies when you use `feedLabel` instead of `country` in the\n`datafeedtarget` configuration.\n\nWe've also added the `targetCountries` field for `datafeeds`, so you can\nconfigure targeting for `datafeeds` directly. You can still configure targeting\noutside the feed, for example, by setting the `shipping` attribute of the\nproducts resource.\n\nUK to GB conversion\n-------------------\n\nWe currently allow the `UK` value for the `targetCountry` field even though it's\nnot a valid country code. We automatically convert `UK` to `GB`. Products with\n`UK` as their `targetCountry` are stored with `GB` in their REST ID and\n`offerId`.\n\nIf you set `UK` as the value for `feedLabel`, it is not automatically converted\nto `GB`. `UK` and `GB` are different strings for `feedLabel` and will create\ndifferent offers.\n\nIf you insert a `targetCountry` of `UK`, and we convert it to `GB`, you must\nupdate the REST ID of the product to include `GB` instead of `UK` to retrieve\nthe product with the `get` method."]]
