{"components":{"callbacks":{},"examples":{},"headers":{},"links":{},"parameters":{},"requestBodies":{},"responses":{},"schemas":{"LocalizationCurrency":{"description":"A currency to be localized.","properties":{"amount":{"type":"number"}},"required":["amount"],"type":"object"},"LocalizationCurrencyRequest":{"description":"LocalizationCurrencyRequest Object.","properties":{"currency":{"$ref":"#/components/schemas/LocalizationCurrency"},"currencyCode":{"description":"A three-letter currency code with enum value corresponding to ISO-4217 code.","enum":["USD"],"type":"string"}},"required":["currency"],"type":"object"},"LocalizationCurrencyResponse":{"description":"LocalizationCurrencyResponse Object.","properties":{"errorCode":{"description":"If status is ERROR, the error code.","type":"string"},"localizedCurrencies":{"additionalProperties":{"$ref":"#/components/schemas/LocalizationCurrency"},"description":"A map from target marketplace ID (string) to localized monetary amount.","type":"object"},"status":{"description":"If SUCCESS, do not retry. If ERROR, may retry.","enum":["ERROR","SUCCESS"],"type":"string"}},"required":["localizedCurrencies","status"],"type":"object"},"LocalizationCurrencyResponseV2":{"description":"LocalizationCurrencyResponse Object.","properties":{"errorCode":{"description":"If status is ERROR, the error code. Not present if status is SUCCESS.","type":"string"},"localizedCurrencyResults":{"additionalProperties":{"$ref":"#/components/schemas/LocalizationCurrencyResult"},"description":"A map from target marketplace ID (country code) (string) to details regarding the localization status and messages.","type":"object"},"sourceCurrency":{"$ref":"#/components/schemas/LocalizationCurrency"},"status":{"description":"If SUCCESS, PARTIAL_SUCCESS, or FAILURE, do not retry. If ERROR, may retry.","enum":["ERROR","FAILURE","PARTIAL_SUCCESS","SUCCESS"],"type":"string"}},"required":["localizedCurrencyResults","sourceCurrency","status"],"type":"object"},"LocalizationCurrencyResult":{"description":"LocalizationCurrencyResult Object.","properties":{"errorCode":{"description":"If status is ERROR, the error code. Not present if status is SUCCESS.","type":"string"},"localizedCurrency":{"$ref":"#/components/schemas/LocalizationCurrency"},"messages":{"description":"If present, contains one or more strings describing why products could not be localized. For manual diagnostic use.","items":{"type":"string"},"maxItems":100,"minItems":1,"type":"array"},"status":{"description":"If SUCCESS, FAILURE, do not retry. If ERROR, may retry.","enum":["ERROR","FAILURE","SUCCESS"],"type":"string"}},"required":["localizedCurrency","status"],"type":"object"},"LocalizationKeyword":{"description":"An object containing information about a keyword.","properties":{"keyword":{"description":"The keyword string.","type":"string"}},"required":["keyword"],"type":"object"},"LocalizationKeywordRequest":{"description":"A LocalizationKeywordRequest object. Contains information needed about the keyword to be localized.","properties":{"localizationKeyword":{"additionalProperties":{"$ref":"#/components/schemas/LocalizationKeyword"},"description":"A keyword to be localized.","type":"object"}},"required":["localizationKeyword"],"type":"object"},"LocalizationKeywordResponse":{"description":"A LocalizationKeywordResponse object. Contains localized keywords in the various target marketplaces/locales.","properties":{"errorCode":{"description":"If status is ERROR, the error code. Not present if status is SUCCESS.","type":"string"},"localizedKeywords":{"additionalProperties":{"$ref":"#/components/schemas/LocalizationKeyword"},"description":"Key (string): target marketplace ID. Value (LocalizationKeyword): localized keyword. If the source keyword cannot be translated into the language associated with a given target marketplace, it will be unchanged for that marketplace.","type":"object"},"status":{"description":"If SUCCESS, do not retry. If ERROR, may retry.","enum":["ERROR","SUCCESS"],"type":"string"}},"required":["localizedProducts","status"],"type":"object"},"LocalizationKeywordResponseV2":{"description":"A LocalizationKeywordResponse object. Contains localized keywords in the various target marketplaces/locales.","properties":{"errorCode":{"description":"If status is ERROR, the error code. Not present if status is SUCCESS.","type":"string"},"localizedKeywordResults":{"additionalProperties":{"$ref":"#/components/schemas/LocalizationKeywordResult"},"description":"A map from target marketplace ID / locale / countryCode to details regarding the localization status and messages.","type":"object"},"sourceKeyword":{"additionalProperties":{"$ref":"#/components/schemas/LocalizationKeyword"},"description":"Source keyword that was localized."},"status":{"description":"If SUCCESS, PARTIAL_SUCCESS or FAILURE, do not retry. If ERROR, may retry.","enum":["ERROR","FAILURE","PARTIAL_SUCCESS","SUCCESS"],"type":"string"}},"required":["localizedKeywordResults","status"],"type":"object"},"LocalizationKeywordResult":{"description":"LocalizationKeywordResult Object.","properties":{"errorCode":{"description":"If status is ERROR or FAILURE, the error code.","type":"string"},"localizedKeyword":{"$ref":"#/components/schemas/LocalizationKeyword"},"messages":{"description":"If present, contains one or more strings describing why products could not be localized. For manual diagnostic use.","items":{"type":"string"},"maxItems":100,"minItems":0,"type":"array"},"status":{"description":"If SUCCESS, FAILURE, do not retry. If ERROR, may retry.","enum":["ERROR","FAILURE","SUCCESS"],"type":"string"}},"required":["localizedKeyword","status"],"type":"object"},"LocalizationKeywordSourceDetails":{"description":"The source details for the LocalizationKeywordRequests. One of locale, marketplaceId, or countryCode has to be present. If locale is present, the content of marketplaceIds or countryCode is ignored.","properties":{"countryCode":{"description":"A two-letter country code. When locale or marketplaceId is present, countryCode is ignored. Please refer to the table above for a list of supported country codes.","type":"string"},"locale":{"description":"The source locale. For example, if the caller is localizing keywords from British English (en_GB) to Simplified Chinese (zh_CN), the source locale is en_GB. Please see the table within the description of the targetDetails object for supported source to target Locale values.","type":"string"},"marketplaceId":{"description":"The ID of the source marketplace. For example, if the caller is an advertiser based in the UK (marketplace ID A1F83G8C2ARO7P) and wishes to localize keywords to Germany (marketplace ID A1PA6795UKMFR9), the source marketplace ID is that of the UK, i.e., A1F83G8C2ARO7P. This marketplace ID is converted into a default locale for that marketplace. The supported locale arcs are outlined in the targetDetails documentation. The following marketplaces are supported for conversion to default locales:\n|Region|Country Code|Default Locale|Name|Marketplace ID|\n|-|-|-|-|-|\n|EU|AE|en_AE|United Arab Emirates|A2VIGQ35RCS4UG|\n|EU|DE|de_DE|Germany|A1PA6795UKMFR9|\n|EU|EG|ar_EG|Egypt|ARBP9OOSHTCHU|\n|EU|ES|es_ES|Spain|A1RKKUPIHCS9HS|\n|EU|FR|fr_FR|France|A13V1IB3VIYZZH|\n|EU|GB|en_GB|United Kingdom|A1F83G8C2ARO7P|\n|EU|IT|it_IT|Italy|APJ6JRA9NG5V4|\n|EU|NL|nl_NL|Netherlands|A1805IZSGTT6HS|\n|EU|PL|pl_PL|Poland|A1C3SOZRARQ6R3|\n|EU|SA|en_SA|Saudi Arabia|A17E79C6D8DWNP|\n|EU|SE|sv_SE|Sweden|A2NODRKZP88ZB9|\n|EU|TR|tr_TR|Turkey|A33AVAJ2PDY3EV|\n|EU|BE|fr_BE|Belgium|AMEN7PMS3EDWL|\n|EU|ZA|en_ZA|South Africa|AE08WJ6YKNBMC|\n|EU|NG|en_NG|Nigeria|A3OCL2LJ6GDH9T|\n|FE|AU|en_AU|Australia|A39IBJ37TRP1C6|\n|FE|IN|en_IN|India|A21TJRUUN4KGV|\n|FE|JP|ja_JP|Japan|A1VC38T7YXB528|\n|FE|SG|en_SG|Singapore|A19VAU5U5O7RUS|\n|FE|CN|zh_CN|China|AAHKV2X7AFYLW|\n|NA|CL|es_CL|Chile|A2WDZJZ5TCRMLH|\n|NA|CO|es_CO|Colombia|A1ZXRLSQW2V54D|\n|NA|BR|pt_BR|Brazil|A2Q3Y263D00KWC|\n|NA|CA|en_CA|Canada|A2EUQ1WTGCTBG2|\n|NA|MX|es_MX|Mexico|A1AM78C64UM0Y8|\n|NA|US|en_US|United States|ATVPDKIKX0DER|.","type":"string"}},"type":"object"},"LocalizationKeywordTargetDetails":{"description":"The target details for the LocalizationKeywordRequests. One of locales, countryCode, or marketplaceIds must be present. If locale is present, the content of marketplaceIds and countryCodes is ignored. Each locale / marketplace ID / countryCode across the array must be unique. The following locale pairs are supported. ?? signifies wildcard. For example if en_?? is specified, locales that are supported would include but not be limited to en_US or en_GB:\n* ar_?? to en_??\n* ar_?? to fr_??\n* ar_?? to it_??\n* ar_?? to nl_??\n* ar_?? to pt_??\n* ar_?? to tr_??\n* de_?? to en_??\n* de_?? to es_??\n* de_?? to fr_??\n* de_?? to it_??\n* de_?? to ja_??\n* de_?? to nl_??\n* de_?? to pt_??\n* de_?? to sv_??\n* de_?? to zh_??\n* en_?? to ar_??\n* en_?? to de_??\n* en_?? to es_??\n* en_?? to es_MX\n* en_?? to fr_??\n* en_?? to it_??\n* en_?? to ja_??\n* en_?? to nl_??\n* en_?? to pl_??\n* en_?? to pt_??\n* en_?? to sv_??\n* en_?? to tr_??\n* en_?? to zh_??\n* es_?? to de_??\n* es_?? to en_??\n* es_?? to fr_??\n* es_?? to it_??\n* es_?? to ja_??\n* es_?? to nl_??\n* es_?? to pl_??\n* es_?? to sv_??\n* es_?? to zh_??\n* es_MX to en_??\n* es_MX to fr_??\n* es_MX to it_??\n* es_MX to ja_??\n* es_MX to nl_??\n* es_MX to pl_??\n* es_MX to sv_??\n* es_MX to zh_??\n* fr_?? to de_??\n* fr_?? to en_??\n* fr_?? to es_??\n* fr_?? to es_MX\n* fr_?? to it_??\n* fr_?? to nl_??\n* fr_?? to sv_??\n* fr_?? to tr_??\n* fr_?? to zh_??\n* it_?? to de_??\n* it_?? to en_??\n* it_?? to es_??\n* it_?? to es_MX\n* it_?? to fr_??\n* it_?? to ja_??\n* it_?? to nl_??\n* it_?? to pl_??\n* it_?? to pt_??\n* it_?? to sv_??\n* it_?? to tr_??\n* it_?? to zh_??\n* ja_?? to en_??\n* ja_?? to es_??\n* ja_?? to fr_??\n* ja_?? to it_??\n* ja_?? to nl_??\n* ja_?? to pl_??\n* ja_?? to pt_??\n* ja_?? to tr_??\n* ja_?? to zh_??\n* nl_?? to de_??\n* nl_?? to en_??\n* nl_?? to es_??\n* nl_?? to fr_??\n* nl_?? to it_??\n* nl_?? to sv_??\n* nl_?? to zh_??\n* pl_?? to de_??\n* pl_?? to en_??\n* pl_?? to es_??\n* pl_?? to es_MX\n* pl_?? to it_??\n* pl_?? to ja_??\n* pl_?? to sv_??\n* pt_?? to de_??\n* pt_?? to en_??\n* pt_?? to fr_??\n* pt_?? to ja_??\n* pt_?? to nl_??\n* pt_?? to tr_??\n* pt_?? to zh_??\n* sv_?? to en_??\n* sv_?? to ja_??\n* sv_?? to pl_??\n* sv_?? to pt_??\n* tr_?? to fr_??\n* tr_?? to es_MX\n* zh_?? to de_??\n* zh_?? to en_??\n* zh_?? to es_??\n* zh_?? to es_MX\n* zh_?? to fr_??\n* zh_?? to it_??\n* zh_?? to ja_??\n* zh_?? to nl_??\n* zh_?? to pl_??\n* zh_?? to pt_??\n* zh_?? to sv_??\n* zh_?? to tr_??","properties":{"countryCodes":{"description":"A list of two-letter country codes. When another form of locale (marketplaceId or locale) is present, countryCode is ignored. Please refer to the table above for a list of supported country codes.","items":{"type":"string"},"maxItems":10,"minItems":0,"type":"array"},"locales":{"description":"The target locales (locales to which the caller wishes to localize the specified keywords). For example, if the caller is localizing keywords from British English (en_GB) to Simplified Chinese (zh_CN), the target locale is zh_CN.","items":{"type":"string"},"maxItems":10,"minItems":0,"type":"array"},"marketplaceIds":{"description":"The IDs of target marketplaces (marketplaces in which the caller wishes to localize the specified keywords). For example, if the caller is an advertiser based in the UK (marketplace ID A1F83G8C2ARO7P) and wishes to localize keywords to Germany (marketplace ID A1PA6795UKMFR9), the target marketplace ID is that of Germany, i.e., A1PA6795UKMFR9. **Please note:** if locales are provided, any provided marketplace IDs will be ignored. The marketplace IDs are converted into default locales. The supported locale arcs are outlined in the targetDetails locales section. The following marketplaces are supported for conversion to default locales:\n|Region|Country Code|Default Locale|Name|Marketplace ID|\n|-|-|-|-|-|\n|EU|AE|en_AE|United Arab Emirates|A2VIGQ35RCS4UG|\n|EU|DE|de_DE|Germany|A1PA6795UKMFR9|\n|EU|EG|ar_EG|Egypt|ARBP9OOSHTCHU|\n|EU|ES|es_ES|Spain|A1RKKUPIHCS9HS|\n|EU|FR|fr_FR|France|A13V1IB3VIYZZH|\n|EU|GB|en_GB|United Kingdom|A1F83G8C2ARO7P|\n|EU|IT|it_IT|Italy|APJ6JRA9NG5V4|\n|EU|NL|nl_NL|Netherlands|A1805IZSGTT6HS|\n|EU|PL|pl_PL|Poland|A1C3SOZRARQ6R3|\n|EU|SA|en_SA|Saudi Arabia|A17E79C6D8DWNP|\n|EU|SE|sv_SE|Sweden|A2NODRKZP88ZB9|\n|EU|TR|tr_TR|Turkey|A33AVAJ2PDY3EV|\n|EU|BE|fr_BE|Belgium|AMEN7PMS3EDWL|\n|EU|ZA|en_ZA|South Africa|AE08WJ6YKNBMC|\n|FE|AU|en_AU|Australia|A39IBJ37TRP1C6|\n|FE|IN|en_IN|India|A21TJRUUN4KGV|\n|FE|JP|ja_JP|Japan|A1VC38T7YXB528|\n|FE|SG|en_SG|Singapore|A19VAU5U5O7RUS|\n|FE|CN|zh_CN|China|AAHKV2X7AFYLW|\n|NA|BR|pt_BR|Brazil|A2Q3Y263D00KWC|\n|NA|CA|en_CA|Canada|A2EUQ1WTGCTBG2|\n|NA|MX|es_MX|Mexico|A1AM78C64UM0Y8|\n|NA|US|en_US|United States|ATVPDKIKX0DER|.","items":{"type":"string"},"maxItems":10,"minItems":0,"type":"array"}},"type":"object"},"LocalizationProduct":{"description":"A product to be localized.","properties":{"asin":{"description":"The product\u0027s Amazon Standard Identification Number. Required for entityType\u003dKDP_AUTHOR and entityType\u003dVENDOR. If caller\u0027s entityType is SELLER, this field is optional and can yield better localization results if included.","type":"string"},"sku":{"description":"The product\u0027s Stock Keeping Unit. Required for entityType\u003dSELLER. If caller\u0027s entityType is KDP_AUTHOR or VENDOR, this field is ignored.","type":"string"}},"type":"object"},"LocalizationProductRequest":{"properties":{"product":{"$ref":"#/components/schemas/LocalizationProduct"}},"required":["product"],"type":"object"},"LocalizationProductResponse":{"properties":{"errorCode":{"description":"If the status is ERROR, the error code. Not present if the status is SUCCESS.","type":"string"},"localizedProducts":{"additionalProperties":{"$ref":"#/components/schemas/LocalizationProduct"},"description":"Key (string): target marketplace ID. Value (LocalizationProduct): localized product. If no localized product is available in a given target marketplace, the map will not contain an entry for that marketplace. An empty map indicates that the source product could not be localized in any of the target marketplaces.","type":"object"},"status":{"description":"If SUCCESS, do not retry. If ERROR, may retry.","enum":["ERROR","SUCCESS"],"type":"string"}},"required":["localizedProducts","status"],"type":"object"},"LocalizationProductResponseV2":{"properties":{"errorCode":{"description":"If the status is ERROR, the error code. Not present if the status is SUCCESS.","type":"string"},"localizedProductResults":{"additionalProperties":{"$ref":"#/components/schemas/LocalizationProductResult"},"description":"Key (string): target marketplace ID. Value (LocalizationProductResult): localized product results. Information regarding how a product was localized, or how a product was not localized in this particular marketplace.","type":"object"},"sourceProduct":{"$ref":"#/components/schemas/LocalizationProduct"},"status":{"description":"If SUCCESS, PARTIAL_SUCCESS or FAILURE, do not retry. If ERROR, may retry.","enum":["ERROR","FAILURE","PARTIAL_SUCCESS","SUCCESS"],"type":"string"}},"required":["localizedProductResults","sourceProduct","status"],"type":"object"},"LocalizationProductResult":{"description":"Information regarding how a product was localized, or how a product was not localized in this particular marketplace.","properties":{"errorCode":{"description":"If the status is ERROR, the error code. Not present if the status is SUCCESS.","type":"string"},"localizedProduct":{"$ref":"#/components/schemas/LocalizationProduct"},"matchType":{"description":"This represents the type of match for a localized product.\nLOCAL: It represents the product selling by an advertiser locally in the marketplace.\nGLOBAL_STORE: It represents the product selling by advertiser via [GlobalStore Program](https://sellercentral.amazon.com/help/hub/reference/external/202139180) in the marketplace.","enum":["GLOBAL_STORE","LOCAL"],"type":"string"},"messages":{"description":"If present, contains one or more strings describing why products could not be localized. For manual diagnostic use.","items":{"type":"string"},"maxItems":100,"minItems":0,"type":"array"},"productMetadata":{"$ref":"#/components/schemas/ProductMetadata"},"status":{"description":"The status of the localization operation. \nSUCCESS: The product was localized successfully for this marketplace.\nFAILURE: The product could not be localized and retrying later will not change the result.\nERROR: The product could not be localized an error occurred. Retry later.","enum":["ERROR","FAILURE","SUCCESS"],"type":"string"}},"required":["localizedProduct","status"],"type":"object"},"LocalizationProductTargetDetails":{"description":"The target details for the LocalizationProductRequests. There must be only one target details object per marketplace ID. The advertiser ID may be repeated across target details objects. The order of target details objects is irrelevant. The following marketplaces are supported for product localization:\n|Region|Country Code|Name|Marketplace ID|\n|-|-|-|-|\n|EU|AE|United Arab Emirates|A2VIGQ35RCS4UG|\n|EU|DE|Germany|A1PA6795UKMFR9|\n|EU|EG|Egypt|ARBP9OOSHTCHU|\n|EU|ES|Spain|A1RKKUPIHCS9HS|\n|EU|FR|France|A13V1IB3VIYZZH|\n|EU|GB|United Kingdom|A1F83G8C2ARO7P|\n|EU|IT|Italy|APJ6JRA9NG5V4|\n|EU|NL|Netherlands|A1805IZSGTT6HS|\n|EU|PL|Poland|A1C3SOZRARQ6R3|\n|EU|SA|Saudi Arabia|A17E79C6D8DWNP|\n|EU|SE|Sweden|A2NODRKZP88ZB9|\n|EU|TR|Turkey|A33AVAJ2PDY3EV|\n|EU|BE|Belgium|AMEN7PMS3EDWL|\n|EU|ZA|South Africa|AE08WJ6YKNBMC|\n|FE|AU|Australia|A39IBJ37TRP1C6|\n|FE|IN|India|A21TJRUUN4KGV|\n|FE|JP|Japan|A1VC38T7YXB528|\n|FE|SG|Singapore|A19VAU5U5O7RUS|\n|NA|BR|Brazil|A2Q3Y263D00KWC|\n|NA|CA|Canada|A2EUQ1WTGCTBG2|\n|NA|MX|Mexico|A1AM78C64UM0Y8|\n|NA|US|United States|ATVPDKIKX0DER|.","properties":{"advertiserId":{"description":"The advertiser ID of the caller in the associated target marketplace. The ID of the source advertiser account. This may be either a marketplace-specific obfuscated ID (AD9EUOBWMS33M), an entity ID (ENTITYYXZDK86N86HG), or a global account ID (amzn1.ads-account.g.e0kbzpoe2gkpai1pqeaca59k8). This is the advertiser ID returned by the Profiles API. An entity ID (one starting with \"ENTITY\"), or a global account advertiser ID may be provided instead.","type":"string"},"countryCode":{"description":"A two-letter country code. When both marketplaceId and countryCode are present, countryCode is ignored. Please refer to the table above for a list of supported country codes.","type":"string"},"marketplaceId":{"description":"The ID of a target marketplace (a marketplace in which the caller wishes to localize the specified products). For example, if the caller is an advertiser based in the UK (marketplace ID A1F83G8C2ARO7P) and wishes to localize a product to Germany (marketplace ID A1PA6795UKMFR9), the target marketplace ID is that of Germany, i.e., A1PA6795UKMFR9. The following marketplaces are supported for product localization:\n|Region|Country Code|Name|Marketplace ID|\n|-|-|-|-|\n|EU|AE|United Arab Emirates|A2VIGQ35RCS4UG|\n|EU|DE|Germany|A1PA6795UKMFR9|\n|EU|EG|Egypt|ARBP9OOSHTCHU|\n|EU|ES|Spain|A1RKKUPIHCS9HS|\n|EU|FR|France|A13V1IB3VIYZZH|\n|EU|GB|United Kingdom|A1F83G8C2ARO7P|\n|EU|IT|Italy|APJ6JRA9NG5V4|\n|EU|NL|Netherlands|A1805IZSGTT6HS|\n|EU|PL|Poland|A1C3SOZRARQ6R3|\n|EU|SA|Saudi Arabia|A17E79C6D8DWNP|\n|EU|SE|Sweden|A2NODRKZP88ZB9|\n|EU|TR|Turkey|A33AVAJ2PDY3EV|\n|EU|BE|Belgium|AMEN7PMS3EDWL|\n|EU|ZA|South Africa|AE08WJ6YKNBMC|\n|FE|AU|Australia|A39IBJ37TRP1C6|\n|FE|IN|India|A21TJRUUN4KGV|\n|FE|JP|Japan|A1VC38T7YXB528|\n|FE|SG|Singapore|A19VAU5U5O7RUS|\n|NA|BR|Brazil|A2Q3Y263D00KWC|\n|NA|CA|Canada|A2EUQ1WTGCTBG2|\n|NA|MX|Mexico|A1AM78C64UM0Y8|\n|NA|US|United States|ATVPDKIKX0DER|.","type":"string"}},"required":["advertiserId"],"type":"object"},"LocalizationTargetingExpression":{"description":"A targeting expression composed of one or more predicates.","properties":{"expression":{"description":"The predicates forming the targeting expression.","items":{"$ref":"#/components/schemas/LocalizationTargetingExpressionPredicate"},"maxItems":100,"minItems":1,"type":"array"},"isForNegativeTargeting":{"description":"Specifies whether the expression is for positive targeting (false) or negative targeting (true).","type":"boolean"}},"required":["expression","isForNegativeTargeting"],"type":"object"},"LocalizationTargetingExpressionPredicate":{"description":"A targeting expression predicate.","properties":{"type":{"$ref":"#/components/schemas/LocalizationTargetingExpressionPredicateType"},"value":{"description":"The value of the predicate. Targeting expression syntax, including examples of predicates and the values they support, is documented [here](https://advertising.amazon.com/API/docs/en-us/bulksheets/sp/sp-general-info/sp-product-attribute-targeting). Only predicates using the following types of data will be localized:\n* Age range ID\n* ASIN\n* Brand ID\n* Category ID\n* Genre ID\n* Price (the currency will be assumed to be the default currency of the source marketplace)\n\nPredicates using other data will be returned unchanged.","type":"string"}},"required":["type","value"],"type":"object"},"LocalizationTargetingExpressionPredicateType":{"description":"Targeting predicate type. The following predicate types are supported:\n| Type | Description | Data in `value` String |\n| --- | --- | --- |\n| `asinCategorySameAs` | Target the specified category. | Integer ID |\n| `asinBrandSameAs` | Target the specified brand. | Integer ID |\n| `asinPriceLessThan` | Target a price less than the specified price. | Real number |\n| `asinPriceBetween` | Target a price between the prices specified. | Two real numbers separated by a hyphen (e.g., `9.99-19.99`) |\n| `asinPriceGreaterThan` | Target a price greater than the specified price. | Real number |\n| `asinReviewRatingLessThan` | Target a review rating less than the specified review rating. | Real number |\n| `asinReviewRatingBetween` | Target a review rating between the specified review ratings. | Two real numbers separated by a hyphen (e.g., `4.5-5`) |\n| `asinReviewRatingGreaterThan` | Target a review rating greater than the specified review rating. | Real number |\n| `asinSameAs` | Target the specified ASIN. | Alphanumeric ASIN |\n| `asinIsPrimeShippingEligible` | Target products that are Prime Shipping Eligible. This refinement can be applied at a category or brand level only. | \"true\" or \"false\" |\n| `asinAgeRangeSameAs` | Target the specified age range. This refinement can be applied to Toys and Games categories only. | Integer ID |\n| `asinGenreSameAs` | Target products related to the specified genre. This refinement can be applied to Books and eBooks categories only. | Integer ID |.","type":"string"},"LocalizationTargetingExpressionRequest":{"description":"A request to localize a targeting expression from a source marketplace to one or more target marketplaces.","properties":{"targetingExpression":{"$ref":"#/components/schemas/LocalizationTargetingExpression"}},"required":["targetingExpression"],"type":"object"},"LocalizationTargetingExpressionResponse":{"description":"A response to a request to localize a targeting expression from a source marketplace to one or more target marketplaces.","properties":{"localizedTargetingExpressionResults":{"additionalProperties":{"$ref":"#/components/schemas/LocalizationTargetingExpressionResult"},"description":"A map from target marketplace ID (string) to the localization result (`LocalizationTargetingExpressionResult`). All target marketplaces present in the request will have an entry in this map.","type":"object"},"localizedTargetingExpressions":{"additionalProperties":{"$ref":"#/components/schemas/LocalizationTargetingExpression"},"description":"A map from target marketplace ID (string) to localized targeting expression (`LocalizationTargetingExpression`). If no entry exists for a given target marketplace, the source targeting expression could not be localized there.","type":"object"}},"type":"object"},"LocalizationTargetingExpressionResponseV2":{"description":"A response to a request to localize a targeting expression from a source marketplace to one or more target marketplaces.","properties":{"errorCode":{"description":"If status is ERROR, the error code. Not present if status is SUCCESS.","type":"string"},"localizedTargetingExpressionResults":{"additionalProperties":{"$ref":"#/components/schemas/LocalizationTargetingExpressionResult"},"description":"A map from target marketplace ID (string) to the localization result (`LocalizationTargetingExpressionResult`). All target marketplaces present in the request will have an entry in this map.","type":"object"},"sourceTargetingExpressions":{"additionalProperties":{"$ref":"#/components/schemas/LocalizationTargetingExpression"},"description":"Source targeting expression for this result set.","type":"object"},"status":{"description":"If SUCCESS, PARTIAL_SUCCESS or FAILURE, do not retry. If ERROR, may retry.","enum":["ERROR","FAILURE","PARTIAL_SUCCESS","SUCCESS"],"type":"string"}},"required":["localizedTargetingExpressionResults","sourceTargetingExpression","status"],"type":"object"},"LocalizationTargetingExpressionResponseV3":{"description":"A response to a request to localize a targeting expression from a source marketplace to one or more target marketplaces.","properties":{"errorCode":{"description":"If status is ERROR, the error code. Not present if status is SUCCESS.","type":"string"},"localizedResolvedTargetingExpressionResults":{"additionalProperties":{"$ref":"#/components/schemas/LocalizationTargetingExpressionResult"},"description":"A map from resolved target locales to the resolved result (`LocalizationTargetingExpressionResult`). All resolved target locales present in the request will have an entry in this map.","type":"object"},"localizedTargetingExpressionResults":{"additionalProperties":{"$ref":"#/components/schemas/LocalizationTargetingExpressionResult"},"description":"A map from target marketplace ID (string) to the localization result (`LocalizationTargetingExpressionResult`). All target marketplaces present in the request will have an entry in this map.","type":"object"},"sourceResolvedTargetingExpressionResults":{"additionalProperties":{"$ref":"#/components/schemas/LocalizationTargetingExpressionResult"},"description":"A map from resolved source locales to the resolved result (`LocalizationTargetingExpressionResult`). All resolved source locales present in the request will have an entry in this map.","type":"object"},"sourceTargetingExpression":{"additionalProperties":{"$ref":"#/components/schemas/LocalizationTargetingExpression"},"description":"Source targeting expression for this result set."},"status":{"description":"If SUCCESS, PARTIAL_SUCCESS or FAILURE, do not retry. If ERROR, may retry.","enum":["ERROR","FAILURE","PARTIAL_SUCCESS","SUCCESS"],"type":"string"}},"required":["localizedTargetingExpressionResults","sourceTargetingExpression","status"],"type":"object"},"LocalizationTargetingExpressionResult":{"description":"Information regarding how and to what extent a targeting expression was localized.","properties":{"errorCode":{"description":"If status is ERROR or FAILURE, the error code.","type":"string"},"localizedTargetingExpression":{"$ref":"#/components/schemas/LocalizationTargetingExpression"},"messages":{"description":"If present, contains one or more strings describing why predicates could not be localized. For manual diagnostic use.","items":{"type":"string"},"maxItems":100,"minItems":0,"type":"array"},"status":{"description":"The status of the localization operation. Note that if the source targeting expression contains an age range predicate that cannot be localized, localization of the entire expression will fail.\nSUCCESS: All predicates within the expression were localized.\nFAILURE: The expression could not be localized.\nERROR: The expression could not be localized because one or more errors occurred.","enum":["ERROR","FAILURE","SUCCESS"],"type":"string"}},"required":["status"],"type":"object"},"LocalizationTargetingSourceDetails":{"description":"A source marketplace. One of the marketplace ID or the two-letter country code must be present. The latter is ignored if the former is present.","properties":{"countryCode":{"description":"A two-letter country code. Please refer to the table above for a list of supported country codes.","type":"string"},"marketplaceId":{"description":"The ID of the source marketplace. For example, when mapping data from the UK (marketplace ID A1F83G8C2ARO7P) to Germany (marketplace ID A1PA6795UKMFR9), the source marketplace ID is that of the UK, i.e., A1F83G8C2ARO7P. Supported marketplaces are:\n|Region|Country Code|Name|Marketplace ID|\n|-|-|-|-|\n|EU|AE|United Arab Emirates|A2VIGQ35RCS4UG|\n|EU|DE|Germany|A1PA6795UKMFR9|\n|EU|EG|Egypt|ARBP9OOSHTCHU|\n|EU|ES|Spain|A1RKKUPIHCS9HS|\n|EU|FR|France|A13V1IB3VIYZZH|\n|EU|GB|United Kingdom|A1F83G8C2ARO7P|\n|EU|IT|Italy|APJ6JRA9NG5V4|\n|EU|NL|Netherlands|A1805IZSGTT6HS|\n|EU|PL|Poland|A1C3SOZRARQ6R3|\n|EU|SA|Saudi Arabia|A17E79C6D8DWNP|\n|EU|SE|Sweden|A2NODRKZP88ZB9|\n|EU|TR|Turkey|A33AVAJ2PDY3EV|\n|EU|BE|Belgium|AMEN7PMS3EDWL|\n|EU|ZA|South Africa|AE08WJ6YKNBMC|\n|FE|AU|Australia|A39IBJ37TRP1C6|\n|FE|IN|India|A21TJRUUN4KGV|\n|FE|JP|Japan|A1VC38T7YXB528|\n|FE|SG|Singapore|A19VAU5U5O7RUS|\n|NA|BR|Brazil|A2Q3Y263D00KWC|\n|NA|CA|Canada|A2EUQ1WTGCTBG2|\n|NA|MX|Mexico|A1AM78C64UM0Y8|\n|NA|US|United States|ATVPDKIKX0DER|.","type":"string"}},"type":"object"},"LocalizationTargetingTargetDetails":{"description":"A target marketplace. One of the marketplace ID or the two-letter country code must be present. The latter is ignored if the former is present.","properties":{"countryCode":{"description":"A two-letter country code. Please refer to the table above for a list of supported country codes.","type":"string"},"marketplaceId":{"description":"The ID of the target marketplace. For example, when mapping data from the UK (marketplace ID A1F83G8C2ARO7P) to Germany (marketplace ID A1PA6795UKMFR9), the target marketplace ID is that of the UK, i.e., A1F83G8C2ARO7P. Supported marketplaces are:\n|Region|Country Code|Name|Marketplace ID|\n|-|-|-|-|\n|EU|AE|United Arab Emirates|A2VIGQ35RCS4UG|\n|EU|DE|Germany|A1PA6795UKMFR9|\n|EU|EG|Egypt|ARBP9OOSHTCHU|\n|EU|ES|Spain|A1RKKUPIHCS9HS|\n|EU|FR|France|A13V1IB3VIYZZH|\n|EU|GB|United Kingdom|A1F83G8C2ARO7P|\n|EU|IT|Italy|APJ6JRA9NG5V4|\n|EU|NL|Netherlands|A1805IZSGTT6HS|\n|EU|PL|Poland|A1C3SOZRARQ6R3|\n|EU|SA|Saudi Arabia|A17E79C6D8DWNP|\n|EU|SE|Sweden|A2NODRKZP88ZB9|\n|EU|TR|Turkey|A33AVAJ2PDY3EV|\n|EU|BE|Belgium|AMEN7PMS3EDWL|\n|EU|ZA|South Africa|AE08WJ6YKNBMC|\n|FE|AU|Australia|A39IBJ37TRP1C6|\n|FE|IN|India|A21TJRUUN4KGV|\n|FE|JP|Japan|A1VC38T7YXB528|\n|FE|SG|Singapore|A19VAU5U5O7RUS|\n|NA|BR|Brazil|A2Q3Y263D00KWC|\n|NA|CA|Canada|A2EUQ1WTGCTBG2|\n|NA|MX|Mexico|A1AM78C64UM0Y8|\n|NA|US|United States|ATVPDKIKX0DER|.","type":"string"}},"type":"object"},"ProductMetadata":{"description":"This represents the metadata associated with the product.","properties":{"catalogSourceCountryCode":{"description":"This field will be present for Global Store business where it represents the country code of source marketplace where seller has listed the product.","enum":["AE","DE","JP","UK","US"],"type":"string"}},"type":"object"},"currencyLocalizationError":{"description":"A CurrencyLocalizationError Object.","properties":{"code":{"description":"Programmatic status code.","type":"integer"},"details":{"description":"A human-readable description of the response.","type":"string"}},"required":["code"],"type":"object"},"currencyLocalizationRequest":{"description":"Currency Localization Request Object.","properties":{"localizeCurrencyRequests":{"description":"An array of LocalizationCurrencyRequest objects. The order will be maintained in the response.","items":{"$ref":"#/components/schemas/LocalizationCurrencyRequest"},"maxItems":1000,"minItems":1,"type":"array"},"sourceCountryCode":{"description":"A two-letter country code. When both marketplaceId and countryCode are present, countryCode is ignored. Please refer to the table above for a list of supported country codes.","type":"string"},"sourceMarketplaceId":{"description":"The source marketplace ID. Please see the table in the description of `targetMarketplaces` for supported values.","type":"string"},"targetCountryCodes":{"description":"A list of two-letter country codes. When both marketplaceId and countryCode are present, countryCode is ignored. Please refer to the table above for a list of supported country codes.","items":{"type":"string"},"maxItems":10,"minItems":0,"type":"array"},"targetMarketplaces":{"description":"A list of target marketplace IDs. Each element must be unique. The order is irrelevant. The following marketplaces are supported:\n|Region|Country Code|Name|Marketplace ID|\n|-|-|-|-|\n|EU|AE|United Arab Emirates|A2VIGQ35RCS4UG|\n|EU|DE|Germany|A1PA6795UKMFR9|\n|EU|EG|Egypt|ARBP9OOSHTCHU|\n|EU|ES|Spain|A1RKKUPIHCS9HS|\n|EU|FR|France|A13V1IB3VIYZZH|\n|EU|GB|United Kingdom|A1F83G8C2ARO7P|\n|EU|IT|Italy|APJ6JRA9NG5V4|\n|EU|NL|Netherlands|A1805IZSGTT6HS|\n|EU|PL|Poland|A1C3SOZRARQ6R3|\n|EU|SA|Saudi Arabia|A17E79C6D8DWNP|\n|EU|SE|Sweden|A2NODRKZP88ZB9|\n|EU|TR|Turkey|A33AVAJ2PDY3EV|\n|EU|BE|Belgium|AMEN7PMS3EDWL|\n|EU|ZA|South Africa|AE08WJ6YKNBMC|\n|FE|AU|Australia|A39IBJ37TRP1C6|\n|FE|IN|India|A21TJRUUN4KGV|\n|FE|JP|Japan|A1VC38T7YXB528|\n|FE|SG|Singapore|A19VAU5U5O7RUS|\n|NA|BR|Brazil|A2Q3Y263D00KWC|\n|NA|CA|Canada|A2EUQ1WTGCTBG2|\n|NA|MX|Mexico|A1AM78C64UM0Y8|\n|NA|US|United States|ATVPDKIKX0DER|.","items":{"type":"string"},"maxItems":10,"minItems":0,"type":"array"}},"required":["localizeCurrencyRequests"],"type":"object"},"currencyLocalizationResponse":{"description":"CurrencyLocalizationResponse Object.","properties":{"localizedCurrencyResponses":{"description":"An array of LocalizationCurrencyResponse objects. The order matches that of the input LocalizationCurrencyRequest object array.","items":{"$ref":"#/components/schemas/LocalizationCurrencyResponse"},"maxItems":1000,"minItems":1,"type":"array"}},"required":["localizedCurrencyResponses"],"type":"object"},"currencyLocalizationResponseV2":{"description":"CurrencyLocalizationResponse Object.","properties":{"localizedCurrencyResponses":{"description":"An array of LocalizationCurrencyResponseV2 objects. The order matches that of the input LocalizationCurrencyRequest object array.","items":{"$ref":"#/components/schemas/LocalizationCurrencyResponseV2"},"maxItems":1000,"minItems":1,"type":"array"}},"required":["localizedCurrencyResponses"],"type":"object"},"keywordsLocalizationError":{"properties":{"code":{"description":"Programmatic status code.","type":"integer"},"details":{"description":"A human-readable description of the response.","type":"string"}},"type":"object"},"keywordsLocalizationRequest":{"properties":{"localizeKeywordRequests":{"description":"List of LocalizationKeywordRequests. The order will be maintained in the response.","items":{"$ref":"#/components/schemas/LocalizationKeywordRequest"},"maxItems":1000,"minItems":1,"type":"array"},"sourceDetails":{"$ref":"#/components/schemas/LocalizationKeywordSourceDetails"},"targetDetails":{"$ref":"#/components/schemas/LocalizationKeywordTargetDetails"}},"required":["localizeKeywordRequests","targetDetails"],"type":"object"},"keywordsLocalizationResponse":{"properties":{"localizedKeywordResponses":{"description":"List of LocalizationKeywordResponses. The order matches that of the LocalizationKeywordRequests list in the request.","items":{"$ref":"#/components/schemas/LocalizationKeywordResponse"},"maxItems":1000,"minItems":1,"type":"array"}},"required":["localizedKeywordResponses"],"type":"object"},"keywordsLocalizationResponseV2":{"properties":{"localizedKeywordResponses":{"description":"List of LocalizationKeywordResponses. The order matches that of the LocalizationKeywordRequests list in the request.","items":{"$ref":"#/components/schemas/LocalizationKeywordResponseV2"},"maxItems":1000,"minItems":1,"type":"array"}},"required":["localizedKeywordResponses"],"type":"object"},"productLocalizationError":{"properties":{"code":{"description":"Programmatic status code.","type":"integer"},"details":{"description":"A human-readable description of the response.","type":"string"}},"type":"object"},"productLocalizationRequest":{"properties":{"adType":{"description":"Used to confirm that the caller is eligible to advertise localized products. Currently, only Sponsored Products advertising is supported.","enum":["SPONSORED_PRODUCTS"],"type":"string"},"entityType":{"description":"The type of the advertiser accounts for which IDs are specified elsewhere in the request.","enum":["KDP_AUTHOR","SELLER","VENDOR"],"type":"string"},"localizeProductRequests":{"description":"The products to be localized. Their order will be maintained in the response.","items":{"$ref":"#/components/schemas/LocalizationProductRequest"},"maxItems":1000,"minItems":1,"type":"array"},"sourceAdvertiserId":{"description":"The ID of the source advertiser account. This may be either a marketplace-specific obfuscated ID (AD9EUOBWMS33M), an entity ID (ENTITYYXZDK86N86HG), or a global account ID (amzn1.ads-account.g.e0kbzpoe2gkpai1pqeaca59k8).","type":"string"},"sourceCountryCode":{"description":"A two-letter country code. When both marketplaceId and countryCode are present, countryCode is ignored. Please refer to the table above for a list of supported country codes.","type":"string"},"sourceMarketplaceId":{"description":"The ID of the source marketplace. Please see the table within the description of the target details object for supported values.","type":"string"},"targetDetails":{"description":"The target details for the LocalizationProductRequests. There must be only one target details object per marketplace ID. The advertiser ID may be repeated across target details objects. The order of target details objects is irrelevant. The following marketplaces are supported for product localization:\n|Region|Country Code|Name|Marketplace ID|\n|-|-|-|-|\n|EU|AE|United Arab Emirates|A2VIGQ35RCS4UG|\n|EU|DE|Germany|A1PA6795UKMFR9|\n|EU|EG|Egypt|ARBP9OOSHTCHU|\n|EU|ES|Spain|A1RKKUPIHCS9HS|\n|EU|FR|France|A13V1IB3VIYZZH|\n|EU|GB|United Kingdom|A1F83G8C2ARO7P|\n|EU|IT|Italy|APJ6JRA9NG5V4|\n|EU|NL|Netherlands|A1805IZSGTT6HS|\n|EU|PL|Poland|A1C3SOZRARQ6R3|\n|EU|SA|Saudi Arabia|A17E79C6D8DWNP|\n|EU|SE|Sweden|A2NODRKZP88ZB9|\n|EU|TR|Turkey|A33AVAJ2PDY3EV|\n|EU|BE|Belgium|AMEN7PMS3EDWL|\n|EU|ZA|South Africa|AE08WJ6YKNBMC|\n|FE|AU|Australia|A39IBJ37TRP1C6|\n|FE|IN|India|A21TJRUUN4KGV|\n|FE|JP|Japan|A1VC38T7YXB528|\n|FE|SG|Singapore|A19VAU5U5O7RUS|\n|NA|BR|Brazil|A2Q3Y263D00KWC|\n|NA|CA|Canada|A2EUQ1WTGCTBG2|\n|NA|MX|Mexico|A1AM78C64UM0Y8|\n|NA|US|United States|ATVPDKIKX0DER|.","items":{"$ref":"#/components/schemas/LocalizationProductTargetDetails"},"maxItems":10,"minItems":1,"type":"array"}},"required":["adType","entityType","localizeProductRequests","sourceAdvertiserId","targetDetails"],"type":"object"},"productLocalizationResponse":{"properties":{"localizedProductResponses":{"description":"List of product localization map objects. The order matches that of the localizeProductRequests field in the request.","items":{"$ref":"#/components/schemas/LocalizationProductResponse"},"maxItems":1000,"minItems":1,"type":"array"}},"required":["localizedProductResponses"],"type":"object"},"productLocalizationResponseV2":{"properties":{"localizedProductResponses":{"description":"List of product localization map objects. The order matches that of the localizeProductRequests field in the request.","items":{"$ref":"#/components/schemas/LocalizationProductResponseV2"},"maxItems":1000,"minItems":1,"type":"array"}},"required":["localizedProductResponses"],"type":"object"},"targetingExpressionLocalizationError":{"properties":{"code":{"description":"Programmatic status code.","type":"integer"},"details":{"description":"A human-readable description of the response.","type":"string"}},"type":"object"},"targetingExpressionLocalizationRequest":{"properties":{"requests":{"description":"A list of requests, each containing a targeting expression to localize. Its order will be maintained in `responses` in the corresponding `targetingExpressionLocalizationResponse` object.","items":{"$ref":"#/components/schemas/LocalizationTargetingExpressionRequest"},"maxItems":100,"minItems":1,"type":"array"},"sourceDetails":{"$ref":"#/components/schemas/LocalizationTargetingSourceDetails"},"sourceResolvedTargetingExpressionLocales":{"description":"The locales to which the caller wishes to retrieve the human readable string (e.g. category name instead of category id) of the source targeting expressions. For example, if the caller wishes to retrieve the category name in Simplified Chinese (zh_CN) and US English (en_US) of the input targeting expression containing a category id, sourceResolvedTargetingExpressionLocales should be set to [\"zh_CN\", \"en_US\"]. If no sourceResolvedTargetingExpressionLocales is provided, the response will not have any resolved targeting expressions for the source targeting expressions. This field can be used to retrieve translations of various targeting expressions. Currently supports the translations of Categories, Genre refinement, and Age Range refinement.","items":{"type":"string"},"maxItems":10,"minItems":0,"type":"array"},"targetDetailsList":{"description":"The targets to which the source targeting expression should be localized.","items":{"$ref":"#/components/schemas/LocalizationTargetingTargetDetails"},"maxItems":10,"minItems":1,"type":"array"},"targetResolvedTargetingExpressionLocale":{"description":"The locale to which the caller wishes to retrieve the human readable string (e.g. category name instead of category id) of the localized targeting expressions. For example, if the caller wishes to retrieve the category name in Simplified Chinese (zh_CN) of a targeting expression containing a category id that has been localized, the targetResolvedTargetingExpressionLocale should be set to zh_CN. If no targetResolvedTargetingExpressionLocale is provided, the response will not have any resolved targeting expressions for the localized targeting expressions.","type":"string"}},"required":["requests","sourceDetails","targetDetailsList"],"type":"object"},"targetingExpressionLocalizationResponse":{"properties":{"responses":{"description":"A list of responses containing localized targeting expressions. Its order matches that of `requests` in the corresponding `targetingExpressionLocalizationRequest` object.","items":{"$ref":"#/components/schemas/LocalizationTargetingExpressionResponse"},"maxItems":100,"minItems":1,"type":"array"}},"required":["responses"],"type":"object"},"targetingExpressionLocalizationResponseV2":{"properties":{"responses":{"description":"A list of responses containing localized targeting expressions. Its order matches that of `requests` in the corresponding `targetingExpressionLocalizationRequest` object.","items":{"$ref":"#/components/schemas/LocalizationTargetingExpressionResponseV2"},"maxItems":100,"minItems":1,"type":"array"}},"required":["responses"],"type":"object"},"targetingExpressionLocalizationResponseV3":{"properties":{"responses":{"description":"A list of responses containing localized targeting expressions. Its order matches that of `requests` in the corresponding `targetingExpressionLocalizationRequest` object.","items":{"$ref":"#/components/schemas/LocalizationTargetingExpressionResponseV3"},"maxItems":100,"minItems":1,"type":"array"}},"required":["responses"],"type":"object"}},"securitySchemes":{}},"info":{"description":"This API provides operations to localize data used when creating advertising campaigns. Depending on the type of data, localization may entail translating text, converting monetary amounts, or mapping an entity in a source marketplace to an analogous entity in one or more target marketplaces.","title":"Localization","version":"3.0"},"openapi":"3.0.1","paths":{"/currencies/localize":{"post":{"description":"Localizes currencies within specified marketplaces.\n\n**Authorized resource type**:\nGlobal Ad Account ID, Profile ID\n\n**Parameter name**:\nAmazon-Ads-AccountId\n\n**Parameter in**:\nheader\n\n**Requires one of these permissions**:\n[\"advertiser_campaign_edit\",\"advertiser_campaign_view\"]","operationId":"getLocalizedCurrencies","parameters":[{"description":"The identifier of a client associated with a \"Login with Amazon\" account.","in":"header","name":"Amazon-Advertising-API-ClientId","required":true,"schema":{"type":"string"}},{"description":"The identifier of a profile associated with the advertiser account. Use `GET` method on Profiles resource to list profiles associated with the access token passed in the HTTP Authorization header and choose profile id `profileId` from the response to pass it as input.","in":"header","name":"Amazon-Advertising-API-Scope","required":true,"schema":{"type":"string"}},{"description":"The identifier of a profile associated with the advertiser account. Used for authentication of Global Account.","in":"header","name":"Amazon-Ads-AccountId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/vnd.currencylocalization.v1+json":{"schema":{"$ref":"#/components/schemas/currencyLocalizationRequest"}},"application/vnd.currencylocalization.v2+json":{"schema":{"$ref":"#/components/schemas/currencyLocalizationRequest"}}},"description":"Contains a list of amounts and a list of target marketplace IDs (via marketplaceId or countryCode), to convert the passed values into the respective marketplace currency.","required":true},"responses":{"200":{"content":{"application/vnd.currencylocalization.v1+json":{"schema":{"$ref":"#/components/schemas/currencyLocalizationResponse"}},"application/vnd.currencylocalization.v2+json":{"example":{"localizedCurrencyResponses":[{"errorCode":"MULTIPLE_REASONS","localizedCurrencyResults":{"CA":{"errorCode":"DEPENDENCY_ERROR","localizedCurrency":{},"messages":["Currency conversion failed due to a dependency error. Please try again later."],"status":"ERROR"},"KR":{"errorCode":"UNSUPPORTED_MARKETPLACE_ARC","localizedCurrency":{},"messages":["Currency conversion failed due to an unsupported marketplace arc. Please consult the documentation for supported marketplace arcs."],"status":"FAILURE"},"MX":{"localizedCurrency":{"amount":"1"},"status":"SUCCESS"}},"sourceCurrency":{"amount":"1"},"status":"PARTIAL_SUCCESS"}]},"schema":{"$ref":"#/components/schemas/currencyLocalizationResponseV2"}}},"description":"Success."},"400":{"content":{"application/vnd.currencylocalization.v1+json":{"schema":{"$ref":"#/components/schemas/currencyLocalizationError"}},"application/vnd.currencylocalization.v2+json":{"schema":{"$ref":"#/components/schemas/currencyLocalizationError"}}},"description":"Bad Request."},"401":{"content":{"application/vnd.currencylocalization.v1+json":{"schema":{"$ref":"#/components/schemas/currencyLocalizationError"}},"application/vnd.currencylocalization.v2+json":{"schema":{"$ref":"#/components/schemas/currencyLocalizationError"}}},"description":"Unauthorized - Request failed because user is not authenticated or is not allowed to invoke the operation."},"429":{"content":{"application/vnd.currencylocalization.v1+json":{"schema":{"$ref":"#/components/schemas/currencyLocalizationError"}},"application/vnd.currencylocalization.v2+json":{"schema":{"$ref":"#/components/schemas/currencyLocalizationError"}}},"description":"Too Many Requests - Request was rate-limited. Retry later."},"500":{"content":{"application/vnd.currencylocalization.v1+json":{"schema":{"$ref":"#/components/schemas/currencyLocalizationError"}},"application/vnd.currencylocalization.v2+json":{"schema":{"$ref":"#/components/schemas/currencyLocalizationError"}}},"description":"Internal Server Error - Something went wrong on the server. Retry later and report an error if unresolved."}},"summary":"Gets an array of localized currencies in their target marketplaces using advertiser identifier in header, and source marketplace ID (via marketplaceId or countryCode) in the body","tags":["Currency Localization"]}},"/keywords/localize":{"post":{"description":"Returns localized keywords within specified marketplaces or locales.\n\n**Authorized resource type**:\nGlobal Ad Account ID, Profile ID\n\n**Parameter name**:\nAmazon-Ads-AccountId\n\n**Parameter in**:\nheader\n\n**Requires one of these permissions**:\n[\"advertiser_campaign_edit\",\"advertiser_campaign_view\"]","operationId":"getLocalizedKeywords","parameters":[{"description":"The identifier of a client associated with a \"Login with Amazon\" account.","in":"header","name":"Amazon-Advertising-API-ClientId","required":true,"schema":{"type":"string"}},{"description":"The identifier of a profile associated with the advertiser account. Use `GET` method on Profiles resource to list profiles associated with the access token passed in the HTTP Authorization header and choose profile id `profileId` from the response to pass it as input.","in":"header","name":"Amazon-Advertising-API-Scope","required":true,"schema":{"type":"string"}},{"description":"The identifier of a profile associated with the advertiser account. Used for authentication of Global Account.","in":"header","name":"Amazon-Ads-AccountId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/vnd.keywordlocalization.v1+json":{"schema":{"$ref":"#/components/schemas/keywordsLocalizationRequest"}},"application/vnd.keywordlocalization.v2+json":{"schema":{"$ref":"#/components/schemas/keywordsLocalizationRequest"}}},"description":"Contains list of target details and keywords to localize.","required":true},"responses":{"200":{"content":{"application/vnd.keywordlocalization.v1+json":{"schema":{"$ref":"#/components/schemas/keywordsLocalizationResponse"}},"application/vnd.keywordlocalization.v2+json":{"example":{"localizedKeywordResponses":[{"errorCode":"MULTIPLE_REASONS","localizedKeywordResults":{"en_UK":{"localizedKeyword":{"keyword":"hello"},"status":"SUCCESS"},"es_MX":{"localizedKeyword":{"keyword":"hola"},"status":"SUCCESS"},"fr_FR":{"localizedKeyword":{"keyword":"bonjour"},"status":"SUCCESS"},"ko_KR":{"errorCode":"UNSUPPORTED_LANGUAGE_ARC","localizedKeyword":{},"messages":["This language arc is not supported. Please consult the documentation for the supported language arcs."],"status":"FAILURE"}},"sourceKeyword":{"keyword":"hello"},"status":"PARTIAL_SUCCESS"}]},"schema":{"$ref":"#/components/schemas/keywordsLocalizationResponseV2"}}},"description":"Success."},"400":{"content":{"application/vnd.keywordlocalization.v1+json":{"schema":{"$ref":"#/components/schemas/keywordsLocalizationError"}},"application/vnd.keywordlocalization.v2+json":{"schema":{"$ref":"#/components/schemas/keywordsLocalizationError"}}},"description":"Bad request."},"401":{"content":{"application/vnd.keywordlocalization.v1+json":{"schema":{"$ref":"#/components/schemas/keywordsLocalizationError"}},"application/vnd.keywordlocalization.v2+json":{"schema":{"$ref":"#/components/schemas/keywordsLocalizationError"}}},"description":"Unauthorized - Request failed because user is not authenticated or is not allowed to invoke the operation."},"429":{"content":{"application/vnd.keywordlocalization.v1+json":{"schema":{"$ref":"#/components/schemas/keywordsLocalizationError"}},"application/vnd.keywordlocalization.v2+json":{"schema":{"$ref":"#/components/schemas/keywordsLocalizationError"}}},"description":"Too Many Requests - Request was rate-limited. Retry later."},"500":{"content":{"application/vnd.keywordlocalization.v1+json":{"schema":{"$ref":"#/components/schemas/keywordsLocalizationError"}},"application/vnd.keywordlocalization.v2+json":{"schema":{"$ref":"#/components/schemas/keywordsLocalizationError"}}},"description":"Internal Server Error - Something went wrong on the server. Retry later and report an error if unresolved."}},"summary":"Returns localized keywords.","tags":["Keyword Localization"]}},"/products/localize":{"post":{"description":"Localizes (maps) products from a source marketplace to one or more target marketplaces. The localization process succeeds for a given target marketplace if a product matching the source product can be found there and the advertiser is eligible to advertise it. Seller requests have an additional condition: the SKU of a localized product must match the SKU of the source product.\n\n**Authorized resource type**:\nGlobal Ad Account ID, Profile ID\n\n**Parameter name**:\nAmazon-Ads-AccountId\n\n**Parameter in**:\nheader\n\n**Requires one of these permissions**:\n[\"advertiser_campaign_edit\",\"advertiser_campaign_view\"]","operationId":"getLocalizedProducts","parameters":[{"description":"The identifier of a client associated with a \"Login with Amazon\" account.","in":"header","name":"Amazon-Advertising-API-ClientId","required":true,"schema":{"type":"string"}},{"description":"The identifier of a profile associated with the advertiser account. Use `GET` method on Profiles resource to list profiles associated with the access token passed in the HTTP Authorization header and choose profile id `profileId` from the response to pass it as input.","in":"header","name":"Amazon-Advertising-API-Scope","required":true,"schema":{"type":"string"}},{"description":"The identifier of a profile associated with the advertiser account. Used for authentication of Global Account.","in":"header","name":"Amazon-Ads-AccountId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/vnd.productlocalization.v1+json":{"schema":{"$ref":"#/components/schemas/productLocalizationRequest"}},"application/vnd.productlocalization.v2+json":{"schema":{"$ref":"#/components/schemas/productLocalizationRequest"}}},"description":"Contains list of target details and products to localize.","required":true},"responses":{"200":{"content":{"application/vnd.productlocalization.v1+json":{"schema":{"$ref":"#/components/schemas/productLocalizationResponse"}},"application/vnd.productlocalization.v2+json":{"example":{"localizedProductResponses":[{"errorCode":"MULTIPLE_REASONS","localizedProductResults":{"EU":{"errorCode":"DEPENDENCY_ERROR","localizedProduct":{},"messages":["Error occurred during localization due to a dependency. Please try again later."],"status":"ERROR"},"KR":{"errorCode":"UNSUPPORTED_MARKETPLACE_ARC","localizedProduct":{},"messages":["A failure occurred due to an unsupported marketplace arc. Please consult the documentation for supported arcs."],"status":"FAILURE"},"US":{"localizedProduct":{"sku":"sku1"},"status":"SUCCESS"}},"sourceProduct":{"sku":"sku1"},"status":"PARTIAL_SUCCESS"}]},"schema":{"$ref":"#/components/schemas/productLocalizationResponseV2"}}},"description":"Success."},"400":{"content":{"application/vnd.productlocalization.v1+json":{"schema":{"$ref":"#/components/schemas/productLocalizationError"}},"application/vnd.productlocalization.v2+json":{"schema":{"$ref":"#/components/schemas/productLocalizationError"}}},"description":"Bad request."},"401":{"content":{"application/vnd.productlocalization.v1+json":{"schema":{"$ref":"#/components/schemas/productLocalizationError"}},"application/vnd.productlocalization.v2+json":{"schema":{"$ref":"#/components/schemas/productLocalizationError"}}},"description":"Unauthorized - The request failed because the user is not authenticated or is not allowed to invoke the operation."},"429":{"content":{"application/vnd.productlocalization.v1+json":{"schema":{"$ref":"#/components/schemas/productLocalizationError"}},"application/vnd.productlocalization.v2+json":{"schema":{"$ref":"#/components/schemas/productLocalizationError"}}},"description":"Too Many Requests - The request was rate-limited. Retry later."},"500":{"content":{"application/vnd.productlocalization.v1+json":{"schema":{"$ref":"#/components/schemas/productLocalizationError"}},"application/vnd.productlocalization.v2+json":{"schema":{"$ref":"#/components/schemas/productLocalizationError"}}},"description":"Internal Server Error - Something went wrong on the server. Retry later and report an error if unresolved."}},"summary":"Returns localized products.","tags":["Product Localization"]}},"/targetingExpression/localize":{"post":{"description":"Localizes (maps) targeting expressions from a source marketplace to one or more target marketplaces. V3: Providing locales in your request\u0027s source details or target details, will now return in \u0026lt;sourceField\u0026gt; and \u0026lt;targetField\u0026gt; respectively the translations of your targeting expressions.\n\n**Authorized resource type**:\nGlobal Ad Account ID, Profile ID\n\n**Parameter name**:\nAmazon-Ads-AccountId\n\n**Parameter in**:\nheader\n\n**Requires one of these permissions**:\n[\"advertiser_campaign_edit\",\"advertiser_campaign_view\"]","operationId":"getLocalizedTargetingExpression","parameters":[{"description":"The identifier of a client associated with a \"Login with Amazon\" account.","in":"header","name":"Amazon-Advertising-API-ClientId","required":true,"schema":{"type":"string"}},{"description":"The identifier of a profile associated with the advertiser account. Use `GET` method on Profiles resource to list profiles associated with the access token passed in the HTTP Authorization header and choose profile id `profileId` from the response to pass it as input.","in":"header","name":"Amazon-Advertising-API-Scope","required":true,"schema":{"type":"string"}},{"description":"The identifier of a profile associated with the advertiser account. Used for authentication of Global Account.","in":"header","name":"Amazon-Ads-AccountId","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/vnd.targetingexpressionlocalization.v1+json":{"schema":{"$ref":"#/components/schemas/targetingExpressionLocalizationRequest"}},"application/vnd.targetingexpressionlocalization.v2+json":{"schema":{"$ref":"#/components/schemas/targetingExpressionLocalizationRequest"}}},"description":"Contains a list of targeting expressions to localize.","required":true},"responses":{"200":{"content":{"application/vnd.targetingexpressionlocalization.v1+json":{"schema":{"$ref":"#/components/schemas/targetingExpressionLocalizationResponse"}},"application/vnd.targetingexpressionlocalization.v2+json":{"example":{"responses":[{"errorCode":"MULTIPLE_REASONS","localizedTargetingExpressionResults":{"CA":{"errorCode":"DEPENDENCY_ERROR","localizedTargetingExpression":{},"messages":["A dependency error occurred. Please try again later."],"status":"ERROR"},"KR":{"errorCode":"UNSUPPORTED_MARKETPLACE_ARC","localizedTargetingExpression":{},"messages":["This marketplace arc is not supported. Please consult the documentation for supported marketplace arcs."],"status":"FAILURE"},"US":{"localizedTargetingExpression":{"expression":[{"type":"asinCategorySameAs","value":"5939473"}],"isForNegativeTargeting":"false"},"status":"SUCCESS"}},"sourceTargetingExpression":{"expression":[{"type":"asinCategorySameAs","value":"3547823"}],"isForNegativeTargeting":"false"},"status":"PARTIAL_SUCCESS"}]},"schema":{"$ref":"#/components/schemas/targetingExpressionLocalizationResponseV2"}},"application/vnd.targetingexpressionlocalization.v3+json":{"example":{"responses":[{"errorCode":"MULTIPLE_REASONS","localizedResolvedTargetingExpressionResults":{"en_CA":{"errorCode":"DEPENDENCY_ERROR","localizedTargetingExpression":{},"messages":["A dependency error occurred. Please try again later."],"status":"ERROR"},"en_US":{"localizedTargetingExpression":{"expression":[{"type":"asinCategorySameAs","value":"socks"}],"isForNegativeTargeting":"false"},"status":"SUCCESS"},"ko_KR":{"errorCode":"UNSUPPORTED_LANGUAGE_ARC","localizedTargetingExpression":{},"messages":["This language arc is not supported. Please consult the documentation for supported marketplace arcs."],"status":"FAILURE"}},"localizedTargetingExpressionResults":{"CA":{"errorCode":"DEPENDENCY_ERROR","localizedTargetingExpression":{},"messages":["A dependency error occurred. Please try again later."],"status":"ERROR"},"KR":{"errorCode":"UNSUPPORTED_MARKETPLACE_ARC","localizedTargetingExpression":{},"messages":["This marketplace arc is not supported. Please consult the documentation for supported marketplace arcs."],"status":"FAILURE"},"US":{"localizedTargetingExpression":{"expression":[{"type":"asinCategorySameAs","value":"5939473"}],"isForNegativeTargeting":"false"},"status":"SUCCESS"}},"sourceResolvedTargetingExpression":{"es_MX":{"localizedTargetingExpression":{"expression":[{"type":"asinCategorySameAs","value":"medias"}],"isForNegativeTargeting":"false"},"status":"SUCCESS"}},"sourceTargetingExpression":{"expression":[{"type":"asinCategorySameAs","value":"3547823"}],"isForNegativeTargeting":"false"},"status":"PARTIAL_SUCCESS"}]},"schema":{"$ref":"#/components/schemas/targetingExpressionLocalizationResponseV3"}}},"description":"Success."},"400":{"content":{"application/vnd.targetingexpressionlocalization.v1+json":{"schema":{"$ref":"#/components/schemas/targetingExpressionLocalizationError"}},"application/vnd.targetingexpressionlocalization.v2+json":{"schema":{"$ref":"#/components/schemas/targetingExpressionLocalizationError"}}},"description":"Bad request."},"401":{"content":{"application/vnd.targetingexpressionlocalization.v1+json":{"schema":{"$ref":"#/components/schemas/targetingExpressionLocalizationError"}},"application/vnd.targetingexpressionlocalization.v2+json":{"schema":{"$ref":"#/components/schemas/targetingExpressionLocalizationError"}}},"description":"Unauthorized: The request failed because the user is not authenticated or is not allowed to invoke the operation."},"429":{"content":{"application/vnd.targetingexpressionlocalization.v1+json":{"schema":{"$ref":"#/components/schemas/targetingExpressionLocalizationError"}},"application/vnd.targetingexpressionlocalization.v2+json":{"schema":{"$ref":"#/components/schemas/targetingExpressionLocalizationError"}}},"description":"Too Many Requests: The request was rate-limited. Retry later."},"500":{"content":{"application/vnd.targetingexpressionlocalization.v1+json":{"schema":{"$ref":"#/components/schemas/targetingExpressionLocalizationError"}},"application/vnd.targetingexpressionlocalization.v2+json":{"schema":{"$ref":"#/components/schemas/targetingExpressionLocalizationError"}}},"description":"Internal Server Error: Something went wrong on the server. Retry later and report an error if the issue persists."}},"summary":"Localizes targeting expressions used for advertising targeting.","tags":["Targeting Expression Localization"]}}}}