{"components":{"callbacks":{},"examples":{},"headers":{},"links":{},"parameters":{"AccountIdHeader":{"description":"The identifier of an Amazon Ads Advertiser Account.","in":"header","name":"Amazon-Ads-AccountId","required":true,"schema":{"type":"string"}},"AccountIdHeaderOptional":{"description":"The identifier of an Amazon Ads Advertiser Account.","in":"header","name":"Amazon-Ads-AccountId","schema":{"type":"string"}},"AdProductQuery":{"description":"\n**AdProduct Enum:**\n| AdProduct | Description |\n| --- | --- |\n| `SPONSORED_PRODUCTS` | Sponsored Products ad product. |\n| `SPONSORED_BRANDS` | Sponsored Brands ad product. |\n| `SPONSORED_DISPLAY` | Sponsored Display ad product. |\n| `SPONSORED_TELEVISION` | Sponsored Television ad product. |\n| `AMAZON_DSP` | Amazon Demand-Side Platform ad product. |\n| `FULL_FUNNEL` | Full funnel ad product combining multiple ad types. |\n| `RMS` | Sponsored ads for external retailers. |\n","in":"query","name":"adProduct","schema":{"$ref":"#/components/schemas/AdProduct"}},"ClientIdHeader":{"description":"The identifier of a client associated with a \u0027Login with Amazon\u0027 account.","in":"header","name":"Amazon-Ads-ClientId","required":true,"schema":{"type":"string"}},"LanguageLocaleIsoQuery":{"description":"A combination of ISO-639 standard for language code and ISO-3166 for country code.\n**LanguageLocaleIso Enum:**\n| LanguageLocaleIso | Description |\n| --- | --- |\n| `ak-GH` | Akan (Ghana). |\n| `am-ET` | Amharic (Ethiopia). |\n| `an-ES` | Aragonese (Spain). |\n| `ar-AE` | Arabic (UAE). |\n| `as-IN` | Assamese (India). |\n| `av-RU` | Avaric (Russia). |\n| `ay-BO` | Aymara (Bolivia). |\n| `ba-RU` | Bashkir (Russia). |\n| `be-BY` | Belarusian (Belarus). |\n| `bg-BG` | Bulgarian (Bulgaria). |\n| `bh-IN` | Bihari (India). |\n| `bi-VU` | Bislama (Vanuatu). |\n| `bm-ML` | Bambara (Mali). |\n| `bo-CN` | Tibetan (China). |\n| `bs-BA` | Bosnian (Bosnia and Herzegovina). |\n| `ca-ES` | Catalan (Spain). |\n| `ce-RU` | Chechen (Russia). |\n| `ch-GU` | Chamorro (Guam). |\n| `de-DE` | German (Germany). |\n| `el-GR` | Greek (Greece). |\n| `en-AE` | English (UAE). |\n| `en-AU` | English (Australia). |\n| `en-CA` | English (Canada). |\n| `en-GB` | English (United Kingdom). |\n| `en-IN` | English (India). |\n| `en-SG` | English (Singapore). |\n| `en-US` | English (United States). |\n| `eo-INT` | Esperanto (International). |\n| `es-CO` | Spanish (Colombia). |\n| `es-ES` | Spanish (Spain). |\n| `es-MX` | Spanish (Mexico). |\n| `et-EE` | Estonian (Estonia). |\n| `eu-ES` | Basque (Spain). |\n| `fa-IR` | Persian (Iran). |\n| `fi-FI` | Finnish (Finland). |\n| `fj-FJ` | Fijian (Fiji). |\n| `fo-FO` | Faroese (Faroe Islands). |\n| `fr-CA` | French (Canada). |\n| `fr-FR` | French (France). |\n| `fy-NL` | Western Frisian (Netherlands). |\n| `ga-IE` | Irish (Ireland). |\n| `gd-GB` | Scottish Gaelic (United Kingdom). |\n| `gl-ES` | Galician (Spain). |\n| `gn-PY` | Guarani (Paraguay). |\n| `gu-IN` | Gujarati (India). |\n| `gv-IM` | Manx (Isle of Man). |\n| `ha-NG` | Hausa (Nigeria). |\n| `he-IL` | Hebrew (Israel). |\n| `hi-IN` | Hindi (India). |\n| `ho-PG` | Hiri Motu (Papua New Guinea). |\n| `hr-HR` | Croatian (Croatia). |\n| `ht-HT` | Haitian Creole (Haiti). |\n| `hu-HU` | Hungarian (Hungary). |\n| `hy-AM` | Armenian (Armenia). |\n| `hz-NA` | Herero (Namibia). |\n| `ia-INT` | Interlingua (International). |\n| `id-ID` | Indonesian (Indonesia). |\n| `ie-INT` | Interlingue (International). |\n| `ig-NG` | Igbo (Nigeria). |\n| `ii-CN` | Sichuan Yi (China). |\n| `ik-US` | Inupiaq (United States). |\n| `io-INT` | Ido (International). |\n| `is-IS` | Icelandic (Iceland). |\n| `it-IT` | Italian (Italy). |\n| `iu-CA` | Inuktitut (Canada). |\n| `ja-JP` | Japanese (Japan). |\n| `jv-ID` | Javanese (Indonesia). |\n| `ka-GE` | Georgian (Georgia). |\n| `kg-CD` | Kongo (Democratic Republic of the Congo). |\n| `ki-KE` | Kikuyu (Kenya). |\n| `kj-NA` | Kwanyama (Namibia). |\n| `kk-KZ` | Kazakh (Kazakhstan). |\n| `kl-GL` | Kalaallisut (Greenland). |\n| `km-KH` | Khmer (Cambodia). |\n| `kn-IN` | Kannada (India). |\n| `ko-KR` | Korean (South Korea). |\n| `kr-NG` | Kanuri (Nigeria). |\n| `ks-IN` | Kashmiri (India). |\n| `ku-TR` | Kurdish (Turkey). |\n| `kv-RU` | Komi (Russia). |\n| `kw-GB` | Cornish (United Kingdom). |\n| `ky-KG` | Kyrgyz (Kyrgyzstan). |\n| `la-VA` | Latin (Vatican City). |\n| `lb-LU` | Luxembourgish (Luxembourg). |\n| `lg-UG` | Ganda (Uganda). |\n| `li-NL` | Limburgish (Netherlands). |\n| `ln-CD` | Lingala (Democratic Republic of the Congo). |\n| `lo-LA` | Lao (Laos). |\n| `lt-LT` | Lithuanian (Lithuania). |\n| `lu-CD` | Luba-Katanga (Democratic Republic of the Congo). |\n| `lv-LV` | Latvian (Latvia). |\n| `mg-MG` | Malagasy (Madagascar). |\n| `mh-MH` | Marshallese (Marshall Islands). |\n| `mi-NZ` | Māori (New Zealand). |\n| `mk-MK` | Macedonian (North Macedonia). |\n| `ml-IN` | Malayalam (India). |\n| `mn-MN` | Mongolian (Mongolia). |\n| `mr-IN` | Marathi (India). |\n| `ms-MY` | Malay (Malaysia). |\n| `mt-MT` | Maltese (Malta). |\n| `my-MM` | Burmese (Myanmar). |\n| `na-NR` | Nauru (Nauru). |\n| `nb-NO` | Norwegian Bokmål (Norway). |\n| `nd-ZW` | North Ndebele (Zimbabwe). |\n| `ne-NP` | Nepali (Nepal). |\n| `ng-NA` | Ndonga (Namibia). |\n| `nl-NL` | Dutch (Netherlands). |\n| `nn-NO` | Norwegian Nynorsk (Norway). |\n| `no-NO` | Norwegian (Norway). |\n| `nr-ZA` | South Ndebele (South Africa). |\n| `nv-US` | Navajo (United States). |\n| `ny-MW` | Chichewa (Malawi). |\n| `oc-FR` | Occitan (France). |\n| `oj-CA` | Ojibwa (Canada). |\n| `om-ET` | Oromo (Ethiopia). |\n| `or-IN` | Oriya (India). |\n| `os-RU` | Ossetian (Russia). |\n| `pa-IN` | Punjabi (India). |\n| `pi-IN` | Pali (India). |\n| `pl-PL` | Polish (Poland). |\n| `ps-AF` | Pashto (Afghanistan). |\n| `pt-BR` | Portuguese (Brazil). |\n| `pt-PT` | Portuguese (Portugal). |\n| `qu-PE` | Quechua (Peru). |\n| `rm-CH` | Romansh (Switzerland). |\n| `rn-BI` | Kirundi (Burundi). |\n| `ro-RO` | Romanian (Romania). |\n| `ru-RU` | Russian (Russia). |\n| `rw-RW` | Kinyarwanda (Rwanda). |\n| `sa-IN` | Sanskrit (India). |\n| `sc-IT` | Sardinian (Italy). |\n| `sd-PK` | Sindhi (Pakistan). |\n| `se-NO` | Northern Sami (Norway). |\n| `sg-CF` | Sango (Central African Republic). |\n| `si-LK` | Sinhala (Sri Lanka). |\n| `sk-SK` | Slovak (Slovakia). |\n| `sl-SI` | Slovenian (Slovenia). |\n| `sm-WS` | Samoan (Samoa). |\n| `sn-ZW` | Shona (Zimbabwe). |\n| `so-SO` | Somali (Somalia). |\n| `sq-AL` | Albanian (Albania). |\n| `sr-RS` | Serbian (Serbia). |\n| `ss-SZ` | Swati (Eswatini). |\n| `st-LS` | Southern Sotho (Lesotho). |\n| `su-ID` | Sundanese (Indonesia). |\n| `sv-SE` | Swedish (Sweden). |\n| `sw-TZ` | Swahili (Tanzania). |\n| `ta-IN` | Tamil (India). |\n| `te-IN` | Telugu (India). |\n| `tg-TJ` | Tajik (Tajikistan). |\n| `th-TH` | Thai (Thailand). |\n| `ti-ET` | Tigrinya (Ethiopia). |\n| `tk-TM` | Turkmen (Turkmenistan). |\n| `tl-PH` | Tagalog (Philippines). |\n| `tn-BW` | Tswana (Botswana). |\n| `to-TO` | Tonga (Tonga). |\n| `tr-TR` | Turkish (Turkey). |\n| `ts-ZA` | Tsonga (South Africa). |\n| `tt-RU` | Tatar (Russia). |\n| `tw-GH` | Twi (Ghana). |\n| `ty-PF` | Tahitian (French Polynesia). |\n| `ug-CN` | Uyghur (China). |\n| `uk-UA` | Ukrainian (Ukraine). |\n| `ur-PK` | Urdu (Pakistan). |\n| `uz-UZ` | Uzbek (Uzbekistan). |\n| `ve-ZA` | Venda (South Africa). |\n| `vi-VN` | Vietnamese (Vietnam). |\n| `vo-INT` | Volapük (International). |\n| `wa-BE` | Walloon (Belgium). |\n| `wo-SN` | Wolof (Senegal). |\n| `xh-ZA` | Xhosa (South Africa). |\n| `yi-IL` | Yiddish (Israel). |\n| `yo-NG` | Yoruba (Nigeria). |\n| `za-CN` | Zhuang (China). |\n| `zh-CN` | Chinese (China). |\n| `zh-TW` | Chinese (Taiwan). |\n| `zu-ZA` | Zulu (South Africa). |\n","in":"query","name":"languageLocaleIso","schema":{"$ref":"#/components/schemas/LanguageLocaleIso"}},"MarketplaceQuery":{"description":"A list of country codes representing Amazon marketplaces","in":"query","name":"marketplace","schema":{"$ref":"#/components/schemas/Marketplace"}},"MaxResultsQuery":{"in":"query","name":"maxResults","schema":{"default":100,"format":"int32","maximum":300,"minimum":1,"type":"integer"}},"NextTokenQuery":{"in":"query","name":"nextToken","schema":{"type":"string"}},"RecommendationTypeEnumQuery":{"description":"The unique identifier of the recommendation type. Used to classify and group similar recommendations (e.g. \u0027BRANDED_KEYWORD\u0027).\n**RecommendationTypeEnum Enum:**\n| RecommendationTypeEnum | Description |\n| --- | --- |\n| `BRAND_PRODUCT_SEGMENT` | Recommends product groups within a brand that shoppers search for as a distinct need. Requires BrandProductSegmentRecommendationTypeDetails to scope by brand. |\n| `BRAND_PRODUCT_KEYWORD` | Recommends keywords and bids for brand product segments. Requires BrandProductKeywordRecommendationTypeDetails to scope by brand and inclusions. |\n| `AUTOMATIC_GLOBAL_ADS_ENROLLMENT` | Surfaces an advertiser\u0027s automatic global ads enrollment status and trial performance. No additional type details are required when querying. |\n| `PAUSED_CAMPAIGN_RESUMPTION` | Recommends resuming campaigns that were automatically paused by the system so the advertiser can recover lost sales. No additional type details are required when querying. |\n| `BUDGETING_INSIGHT_MISSED_SALES` | Surfaces estimated sales missed due to budget constraints for the advertiser. No additional type details are required when querying. |\n| `BUDGET_RULES` | Recommends setting up budget rules that automatically adjust campaign budgets based on performance and schedule. No additional type details are required when querying. |\n| `RULE_BASED_BIDDING` | Recommends rule-based bidding to automatically adjust bids based on advertiser-defined rules. No additional type details are required when querying. |\n| `SCHEDULE_BID_RULE` | Recommends scheduling intraday bid adjustments to change bids by time of day. No additional type details are required when querying. |\n| `CREDIT_AVAILABLE` | Notifies the advertiser of advertising credit available to apply to their campaigns. No additional type details are required when querying. |\n| `CREDIT_EXPIRING` | Notifies the advertiser of advertising credit that is about to expire. No additional type details are required when querying. |\n| `ELIGIBLE_PROMOTION` | Notifies the advertiser of an advertising promotion they are eligible for. No additional type details are required when querying. |\n| `FUNNEL_ANALYSIS` | Surfaces full-funnel performance analysis across the advertiser\u0027s campaigns. No additional type details are required when querying. |\n| `FUNNEL_NEW_TO_BRAND_GROWTH` | Highlights new-to-brand customer growth opportunities across the marketing funnel. No additional type details are required when querying. |\n| `BRAND_METRICS_INSIGHTS` | Surfaces brand-metrics insights such as awareness and consideration for the advertiser. No additional type details are required when querying. |\n| `GLOBAL_TARGETING_INSIGHT_ABOVE_ZERO_SALES` | Surfaces ad targets that have generated sales for the advertiser. No additional type details are required when querying. |\n| `GLOBAL_TARGETING_INSIGHT_OPTIMIZE_CONVERSION` | Surfaces ad targets with low conversion rate for the advertiser. No additional type details are required when querying. |\n| `SP_TARGETING_CONSOLIDATED` | Recommends Sponsored Products keyword recommendations including adding new keywords and pausing under-performing keywords. No additional type details are required when querying. |\n| `SEASONAL_TARGETING_STRATEGY` | Recommends seasonally relevant keywords for the advertiser\u0027s Sponsored Products campaigns. No additional type details are required when querying. |\n| `TAILORED_CAMPAIGNS` | Recommends tailored preset Sponsored Products campaigns for the advertiser. No additional type details are required when querying. |\n| `GLOBAL_TAILORED_CAMPAIGNS` | Recommends tailored Sponsored Products campaigns for global marketplaces. No additional type details are required when querying. |\n| `SB_TAILORED_AUDIENCE_EXISTING` | Recommends a tailored Sponsored Brands campaign for existing SB audiences. No additional type details are required when querying. |\n| `SB_TAILORED_AUDIENCE_NO_STORE` | Recommends a tailored Sponsored Brands campaign for advertisers without a Store. No additional type details are required when querying. |\n| `SB_TAILORED_AUDIENCE_WITH_STORE` | Recommends a tailored Sponsored Brands campaign for advertisers with a Store. No additional type details are required when querying. |\n| `SB_TAILORED_AUDIENCE_NEW_TO_BRAND` | Recommends a tailored Sponsored Brands campaign targeting new-to-brand shoppers. No additional type details are required when querying. |\n| `STORE_PRODUCT_COLLECTION` | Recommends adding a product collection page to the advertiser\u0027s Brand Store. No additional type details are required when querying. |\n| `NEW_USER_SHOPPABLE_IMAGE` | Recommends adding shoppable images to the advertiser\u0027s Brand Store. No additional type details are required when querying. |\n| `NEW_USER_ENGAGEMENT_CODE` | Surfaces an onboarding engagement nudge for non-account managed advertisers. No additional type details are required when querying. |\n| `SP_ONBOARDING_OPTIMIZE_VIDEO` | Recommends targeting approach to boost SP performance on AAC video card. No additional type details are required when querying. |\n| `PARTNER_DIRECTORY` | Recommends top matched SpA advertising partners, providing Partner Directory profile details. No additional type details are required when querying. |\n| `PERFORMANCE_BASED_ADS_TOP_OF_SEARCH` | Recommends performance-based bidding to win top-of-search placements. No additional type details are required when querying. |\n| `SPONSORED_ADS_BOOST` | Recommends advertisers to use Pay in Card Currency. No additional type details are required when querying. |\n| `ADS_PLANNER` | Recommends using Ads Planner to plan upcoming advertising campaigns. No additional type details are required when querying. |\n| `STV_INCREASE_SALES_VIDEO_AI` | Recommends using AI-generated video to increase sales with Sponsored TV. No additional type details are required when querying. |\n| `STV_READY` | Notifies the advertiser that they are ready to begin Sponsored TV advertising. No additional type details are required when querying. |\n| `ENGAGEMENT_ACQUISITION` | Recommends an advertiser to launch a Sponsored Brands campaign in a new country. No additional type details are required when querying. |\n","in":"query","name":"recommendationTypeEnum","schema":{"$ref":"#/components/schemas/RecommendationTypeEnum"}},"ScopeHeaderOptional":{"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","schema":{"type":"string"}}},"requestBodies":{},"responses":{},"schemas":{"AdProduct":{"description":"**AdProduct Enum:**\n\n| AdProduct | Description |\n|------|------|\n| `AMAZON_DSP` | Amazon Demand-Side Platform ad product. |\n| `FULL_FUNNEL` | Full funnel ad product combining multiple ad types. |\n| `RMS` | Sponsored ads for external retailers. |\n| `SPONSORED_BRANDS` | Sponsored Brands ad product. |\n| `SPONSORED_DISPLAY` | Sponsored Display ad product. |\n| `SPONSORED_PRODUCTS` | Sponsored Products ad product. |\n| `SPONSORED_TELEVISION` | Sponsored Television ad product. |\n","enum":["AMAZON_DSP","FULL_FUNNEL","RMS","SPONSORED_BRANDS","SPONSORED_DISPLAY","SPONSORED_PRODUCTS","SPONSORED_TELEVISION"],"type":"string"},"AdvertisedProducts":{"properties":{"productId":{"description":"The identifier of the advertised product.","type":"string"},"productIdType":{"$ref":"#/components/schemas/ProductIdType"}},"required":["productIdType"],"type":"object"},"AutomaticGlobalAdsEnrollmentSettings":{"description":"Enrollment status and observed performance for an advertiser account enrolled in automatic global ads.","properties":{"daysLeftInFreeTrial":{"description":"Days remaining in the trial. Absent or 0 when the trial has ended.","format":"int32","type":"integer"},"daysRemainingToEnrollInFreeTrial":{"description":"Days remaining to enroll for free trial. Absent or 0 when the account is not eligible for free trial enrollment.","format":"int32","type":"integer"},"enrollmentStatus":{"$ref":"#/components/schemas/AutomaticGlobalAdsEnrollmentStatus"},"trialMetrics":{"description":"Performance metrics observed during the trial, one entry per metric.","items":{"$ref":"#/components/schemas/TrialMetric"},"maxItems":50,"minItems":0,"type":"array"}},"required":["enrollmentStatus"],"type":"object"},"AutomaticGlobalAdsEnrollmentStatus":{"description":"**AutomaticGlobalAdsEnrollmentStatus Enum:**\n\n| AutomaticGlobalAdsEnrollmentStatus | Description |\n|------|------|\n| `ELIGIBLE_FOR_ENROLLMENT` | Account is eligible to enroll. |\n| `ELIGIBLE_FOR_FREE_TRIAL_ENROLLMENT` | Account is eligible for enrollment in Free Trial. |\n| `FREE_TRIAL_ENDED` | Free Trial has ended. |\n| `FREE_TRIAL_EXPIRING` | Free Trial is nearing its end. |\n| `FREE_TRIAL_STARTED` | Free Trial has started. |\n","enum":["ELIGIBLE_FOR_ENROLLMENT","ELIGIBLE_FOR_FREE_TRIAL_ENROLLMENT","FREE_TRIAL_ENDED","FREE_TRIAL_EXPIRING","FREE_TRIAL_STARTED"],"type":"string"},"BadGatewayResponseContent":{"properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"type":"object"},"BadRequestResponseContent":{"properties":{"code":{"$ref":"#/components/schemas/ErrorCode"},"message":{"type":"string"}},"required":["code","message"],"type":"object"},"BidValueRange":{"description":"A suggested bid value and range. suggested is the recommended amount; lower and upper provide the low and high bounds.","properties":{"lower":{"description":"Lower bound of the suggested bid range.","format":"double","type":"number"},"suggested":{"description":"The suggested bid amount.","format":"double","type":"number"},"upper":{"description":"Upper bound of the suggested bid range.","format":"double","type":"number"}},"required":["suggested"],"type":"object"},"BrandProductKeywordRecommendationTypeDetails":{"description":"Request details for brand product keyword recommendations.","properties":{"brandId":{"description":"The brand identifier to scope keyword recommendations.","type":"string"},"brandName":{"description":"The brand name to scope keyword recommendations.","type":"string"},"inclusions":{"$ref":"#/components/schemas/ProductScopeInclusions"}},"type":"object"},"BrandProductKeywordSettings":{"description":"A recommended brand product keyword with bid guidance.","properties":{"keywordTarget":{"$ref":"#/components/schemas/KeywordTarget"},"keywordTheme":{"description":"The theme classification of the keyword (e.g. Generic, Branded, Seasonal).","type":"string"},"metrics":{"$ref":"#/components/schemas/TargetingInsightMetrics"},"recommendedBid":{"$ref":"#/components/schemas/BidValueRange"}},"required":["keywordTarget","recommendedBid"],"type":"object"},"BrandProductSegmentRecommendationTypeDetails":{"description":"Request details for brand product segment recommendations.","properties":{"brandId":{"description":"The brand identifier to scope segment recommendations.","type":"string"},"brandName":{"description":"The brand name to scope segment recommendations.","type":"string"}},"type":"object"},"BrandProductSegmentSettings":{"description":"A recommended brand product segment.","properties":{"brandProductSegmentId":{"description":"The identifier of the brand product segment (a ProductCategory type).","type":"string"},"isTopPick":{"description":"Whether this segment is a featured recommendation.","type":"boolean"},"previewProductIds":{"description":"Product identifiers for previewing this segment.","items":{"type":"string"},"maxItems":50,"minItems":0,"type":"array"},"productCount":{"description":"Number of products in this segment for the brand.","format":"int32","type":"integer"},"rationale":{"description":"Reason this segment is recommended.","type":"string"}},"required":["brandProductSegmentId","productCount"],"type":"object"},"ContentTooLargeResponseContent":{"properties":{"code":{"$ref":"#/components/schemas/ErrorCode"},"message":{"type":"string"}},"required":["code","message"],"type":"object"},"Error":{"properties":{"code":{"$ref":"#/components/schemas/ErrorCode"},"fieldLocation":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"type":"object"},"ErrorCode":{"description":"| ErrorCode | Description |\n|------|------|\n| `BAD_REQUEST` | The request is not valid considering the documented schema. |\n| `CONTENT_TOO_LARGE` | The request is too large. Consider splitting it into multiple requests. |\n| `DATE_CANNOT_BE_IN_PAST` | Update the date to be in the future. |\n| `DATE_CANNOT_BE_NULL` | Update the date. |\n| `DATE_TOO_SOON` | Update the date to be further in the future. |\n| `DUPLICATE_FIELD_VALUE_FOUND` | Multiple resources share the non-unique field values. Remove the non-unique field value. |\n| `DUPLICATE_RESOURCE_ID_FOUND` | Multiple resources share the same ID. Remove the duplicate ID. |\n| `DURATION_TOO_SHORT` | Update the length to be within the required range. |\n| `FEATURE_DISCONTINUED` | Feature has been discontinued. |\n| `FIELD_SIZE_IS_ABOVE_MAXIMUM_LIMIT` | Update the value to be within the required range. |\n| `FIELD_SIZE_IS_BELOW_MINIMUM_LIMIT` | Update the value to be within the required range. |\n| `FIELD_SIZE_IS_OUT_OF_RANGE` | Update the value to be within the required range. |\n| `FIELD_VALUE_CANNOT_EDIT` | Field value cannot be edited. |\n| `FIELD_VALUE_CONTAINS_BLOCKLISTED_WORDS` | Update the request with the required information for this resource. |\n| `FIELD_VALUE_CONTAINS_INVALID_CHARACTERS` | Remove the invalid characters and try again. |\n| `FIELD_VALUE_IS_ABOVE_MAXIMUM_LIMIT` | Update the value to be within the required range. |\n| `FIELD_VALUE_IS_BELOW_MINIMUM_LIMIT` | Update the value to be within the required range. |\n| `FIELD_VALUE_IS_EMPTY` | Update the request with the required information for this resource. |\n| `FIELD_VALUE_IS_INVALID` | Update the request with the required information for this resource. |\n| `FIELD_VALUE_IS_NULL` | Update the request with the required information for this resource. |\n| `FIELD_VALUE_IS_OUT_OF_RANGE` | Update the value to be within the required range. |\n| `FIELD_VALUE_MISMATCH` | Mismatch among resource field values. |\n| `FIELD_VALUE_MUST_BE_EMPTY_OR_NULL` | Update the request with the required information for this resource. |\n| `FIELD_VALUE_NOT_FOUND` | Resource specified in the field value not found. Try again with valid value. |\n| `FIELD_VALUE_NOT_UNIQUE` | Resource field value conflicts with existing resource. Try again with an unique field value. |\n| `FORBIDDEN` | The caller is not authorized to make the given request. |\n| `INTERNAL_ERROR` | The server encountered an unexpected condition that prevented it from fulfilling the request. |\n| `INVALID_INPUT` | The request has invalid input parameters. |\n| `NOT_FOUND` | The requested resource does not exist. |\n| `PAYMENT_ISSUE` | Payment failed. |\n| `PRODUCT_INELIGIBLE` | Product is not eligible for advertising. Try again with a valid product. |\n| `RESOURCE_DOES_NOT_BELONG_TO_PARENT` | Resource does not belong to the specified parent. Try again with a valid parent ID. |\n| `RESOURCE_ID_NOT_FOUND` | Resource ID not found. Try again with valid ID. |\n| `RESOURCE_IS_EMPTY` | Update the request with the required information for this resource. |\n| `RESOURCE_IS_IN_TERMINAL_STATE` | Resource is in terminal state. |\n| `RESOURCE_IS_NULL` | Update the request with the required information for this resource. |\n| `TOO_MANY_REQUESTS` | There have been too many requests, please slow down your call rate. |\n| `TOTAL_RESOURCE_LIMIT_EXCEEDED` | Too many resources. Remove resources and try again. |\n| `UNAUTHORIZED` | The request lacks the necessary credentials. |\n| `UNSUPPORTED_MARKETPLACE` | Marketplace not supported. Try again with a supported marketplace. |\n","enum":["BAD_REQUEST","CONTENT_TOO_LARGE","DATE_CANNOT_BE_IN_PAST","DATE_CANNOT_BE_NULL","DATE_TOO_SOON","DUPLICATE_FIELD_VALUE_FOUND","DUPLICATE_RESOURCE_ID_FOUND","DURATION_TOO_SHORT","FEATURE_DISCONTINUED","FIELD_SIZE_IS_ABOVE_MAXIMUM_LIMIT","FIELD_SIZE_IS_BELOW_MINIMUM_LIMIT","FIELD_SIZE_IS_OUT_OF_RANGE","FIELD_VALUE_CANNOT_EDIT","FIELD_VALUE_CONTAINS_BLOCKLISTED_WORDS","FIELD_VALUE_CONTAINS_INVALID_CHARACTERS","FIELD_VALUE_IS_ABOVE_MAXIMUM_LIMIT","FIELD_VALUE_IS_BELOW_MINIMUM_LIMIT","FIELD_VALUE_IS_EMPTY","FIELD_VALUE_IS_INVALID","FIELD_VALUE_IS_NULL","FIELD_VALUE_IS_OUT_OF_RANGE","FIELD_VALUE_MISMATCH","FIELD_VALUE_MUST_BE_EMPTY_OR_NULL","FIELD_VALUE_NOT_FOUND","FIELD_VALUE_NOT_UNIQUE","FORBIDDEN","INTERNAL_ERROR","INVALID_INPUT","NOT_FOUND","PAYMENT_ISSUE","PRODUCT_INELIGIBLE","RESOURCE_DOES_NOT_BELONG_TO_PARENT","RESOURCE_ID_NOT_FOUND","RESOURCE_IS_EMPTY","RESOURCE_IS_IN_TERMINAL_STATE","RESOURCE_IS_NULL","TOO_MANY_REQUESTS","TOTAL_RESOURCE_LIMIT_EXCEEDED","UNAUTHORIZED","UNSUPPORTED_MARKETPLACE"],"type":"string"},"ErrorsIndex":{"properties":{"errors":{"items":{"$ref":"#/components/schemas/Error"},"maxItems":20,"minItems":1,"type":"array"},"index":{"format":"int32","maximum":999,"minimum":0,"type":"integer"}},"required":["errors","index"],"type":"object"},"EstimatedRange":{"description":"A range estimate with lower bound, upper bound, and optional average.","properties":{"average":{"description":"Average of the estimate","format":"int32","type":"integer"},"lower":{"description":"Lower bound of the estimate","format":"int32","type":"integer"},"upper":{"description":"Upper bound of the estimate","format":"int32","type":"integer"}},"required":["lower","upper"],"type":"object"},"ForbiddenResponseContent":{"properties":{"code":{"$ref":"#/components/schemas/ErrorCode"},"message":{"type":"string"}},"required":["code","message"],"type":"object"},"GatewayTimeoutResponseContent":{"properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"type":"object"},"HttpVerb":{"enum":["DELETE","GET","PATCH","POST"],"type":"string"},"InternalServerErrorResponseContent":{"properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"type":"object"},"KeywordMatchType":{"description":"**KeywordMatchType Enum:**\n\n| KeywordMatchType | Description |\n|------|------|\n| `BROAD` | Broad match search terms. This expands matching on user intent beyond PHRASE. |\n| `EXACT` | Exact match search terms. |\n| `PHRASE` | Phrase match search terms. This expands matching on user intent beyond EXACT. |\n","enum":["BROAD","EXACT","PHRASE"],"type":"string"},"KeywordTarget":{"description":"Targets a specific customer search term.","properties":{"keyword":{"description":"The customer search term or text to target. For valid characters and constraints, [see keyword character constraints](https://advertising.amazon.com/API/docs/en-us/reference/concepts/limits#keyword-character-constraints).","type":"string"},"matchType":{"$ref":"#/components/schemas/KeywordMatchType"}},"required":["keyword","matchType"],"type":"object"},"LanguageLocaleIso":{"description":"A combination of ISO-639 standard for language code and ISO-3166 for country code.\n**LanguageLocaleIso Enum:**\n\n| LanguageLocaleIso | Description |\n|------|------|\n| `ak-GH` | Akan (Ghana). |\n| `am-ET` | Amharic (Ethiopia). |\n| `an-ES` | Aragonese (Spain). |\n| `ar-AE` | Arabic (UAE). |\n| `as-IN` | Assamese (India). |\n| `av-RU` | Avaric (Russia). |\n| `ay-BO` | Aymara (Bolivia). |\n| `ba-RU` | Bashkir (Russia). |\n| `be-BY` | Belarusian (Belarus). |\n| `bg-BG` | Bulgarian (Bulgaria). |\n| `bh-IN` | Bihari (India). |\n| `bi-VU` | Bislama (Vanuatu). |\n| `bm-ML` | Bambara (Mali). |\n| `bo-CN` | Tibetan (China). |\n| `bs-BA` | Bosnian (Bosnia and Herzegovina). |\n| `ca-ES` | Catalan (Spain). |\n| `ce-RU` | Chechen (Russia). |\n| `ch-GU` | Chamorro (Guam). |\n| `de-DE` | German (Germany). |\n| `el-GR` | Greek (Greece). |\n| `en-AE` | English (UAE). |\n| `en-AU` | English (Australia). |\n| `en-CA` | English (Canada). |\n| `en-GB` | English (United Kingdom). |\n| `en-IN` | English (India). |\n| `en-SG` | English (Singapore). |\n| `en-US` | English (United States). |\n| `eo-INT` | Esperanto (International). |\n| `es-CO` | Spanish (Colombia). |\n| `es-ES` | Spanish (Spain). |\n| `es-MX` | Spanish (Mexico). |\n| `et-EE` | Estonian (Estonia). |\n| `eu-ES` | Basque (Spain). |\n| `fa-IR` | Persian (Iran). |\n| `fi-FI` | Finnish (Finland). |\n| `fj-FJ` | Fijian (Fiji). |\n| `fo-FO` | Faroese (Faroe Islands). |\n| `fr-CA` | French (Canada). |\n| `fr-FR` | French (France). |\n| `fy-NL` | Western Frisian (Netherlands). |\n| `ga-IE` | Irish (Ireland). |\n| `gd-GB` | Scottish Gaelic (United Kingdom). |\n| `gl-ES` | Galician (Spain). |\n| `gn-PY` | Guarani (Paraguay). |\n| `gu-IN` | Gujarati (India). |\n| `gv-IM` | Manx (Isle of Man). |\n| `ha-NG` | Hausa (Nigeria). |\n| `he-IL` | Hebrew (Israel). |\n| `hi-IN` | Hindi (India). |\n| `ho-PG` | Hiri Motu (Papua New Guinea). |\n| `hr-HR` | Croatian (Croatia). |\n| `ht-HT` | Haitian Creole (Haiti). |\n| `hu-HU` | Hungarian (Hungary). |\n| `hy-AM` | Armenian (Armenia). |\n| `hz-NA` | Herero (Namibia). |\n| `ia-INT` | Interlingua (International). |\n| `id-ID` | Indonesian (Indonesia). |\n| `ie-INT` | Interlingue (International). |\n| `ig-NG` | Igbo (Nigeria). |\n| `ii-CN` | Sichuan Yi (China). |\n| `ik-US` | Inupiaq (United States). |\n| `io-INT` | Ido (International). |\n| `is-IS` | Icelandic (Iceland). |\n| `it-IT` | Italian (Italy). |\n| `iu-CA` | Inuktitut (Canada). |\n| `ja-JP` | Japanese (Japan). |\n| `jv-ID` | Javanese (Indonesia). |\n| `ka-GE` | Georgian (Georgia). |\n| `kg-CD` | Kongo (Democratic Republic of the Congo). |\n| `ki-KE` | Kikuyu (Kenya). |\n| `kj-NA` | Kwanyama (Namibia). |\n| `kk-KZ` | Kazakh (Kazakhstan). |\n| `kl-GL` | Kalaallisut (Greenland). |\n| `km-KH` | Khmer (Cambodia). |\n| `kn-IN` | Kannada (India). |\n| `ko-KR` | Korean (South Korea). |\n| `kr-NG` | Kanuri (Nigeria). |\n| `ks-IN` | Kashmiri (India). |\n| `ku-TR` | Kurdish (Turkey). |\n| `kv-RU` | Komi (Russia). |\n| `kw-GB` | Cornish (United Kingdom). |\n| `ky-KG` | Kyrgyz (Kyrgyzstan). |\n| `la-VA` | Latin (Vatican City). |\n| `lb-LU` | Luxembourgish (Luxembourg). |\n| `lg-UG` | Ganda (Uganda). |\n| `li-NL` | Limburgish (Netherlands). |\n| `ln-CD` | Lingala (Democratic Republic of the Congo). |\n| `lo-LA` | Lao (Laos). |\n| `lt-LT` | Lithuanian (Lithuania). |\n| `lu-CD` | Luba-Katanga (Democratic Republic of the Congo). |\n| `lv-LV` | Latvian (Latvia). |\n| `mg-MG` | Malagasy (Madagascar). |\n| `mh-MH` | Marshallese (Marshall Islands). |\n| `mi-NZ` | Māori (New Zealand). |\n| `mk-MK` | Macedonian (North Macedonia). |\n| `ml-IN` | Malayalam (India). |\n| `mn-MN` | Mongolian (Mongolia). |\n| `mr-IN` | Marathi (India). |\n| `ms-MY` | Malay (Malaysia). |\n| `mt-MT` | Maltese (Malta). |\n| `my-MM` | Burmese (Myanmar). |\n| `na-NR` | Nauru (Nauru). |\n| `nb-NO` | Norwegian Bokmål (Norway). |\n| `nd-ZW` | North Ndebele (Zimbabwe). |\n| `ne-NP` | Nepali (Nepal). |\n| `ng-NA` | Ndonga (Namibia). |\n| `nl-NL` | Dutch (Netherlands). |\n| `nn-NO` | Norwegian Nynorsk (Norway). |\n| `no-NO` | Norwegian (Norway). |\n| `nr-ZA` | South Ndebele (South Africa). |\n| `nv-US` | Navajo (United States). |\n| `ny-MW` | Chichewa (Malawi). |\n| `oc-FR` | Occitan (France). |\n| `oj-CA` | Ojibwa (Canada). |\n| `om-ET` | Oromo (Ethiopia). |\n| `or-IN` | Oriya (India). |\n| `os-RU` | Ossetian (Russia). |\n| `pa-IN` | Punjabi (India). |\n| `pi-IN` | Pali (India). |\n| `pl-PL` | Polish (Poland). |\n| `ps-AF` | Pashto (Afghanistan). |\n| `pt-BR` | Portuguese (Brazil). |\n| `pt-PT` | Portuguese (Portugal). |\n| `qu-PE` | Quechua (Peru). |\n| `rm-CH` | Romansh (Switzerland). |\n| `rn-BI` | Kirundi (Burundi). |\n| `ro-RO` | Romanian (Romania). |\n| `ru-RU` | Russian (Russia). |\n| `rw-RW` | Kinyarwanda (Rwanda). |\n| `sa-IN` | Sanskrit (India). |\n| `sc-IT` | Sardinian (Italy). |\n| `sd-PK` | Sindhi (Pakistan). |\n| `se-NO` | Northern Sami (Norway). |\n| `sg-CF` | Sango (Central African Republic). |\n| `si-LK` | Sinhala (Sri Lanka). |\n| `sk-SK` | Slovak (Slovakia). |\n| `sl-SI` | Slovenian (Slovenia). |\n| `sm-WS` | Samoan (Samoa). |\n| `sn-ZW` | Shona (Zimbabwe). |\n| `so-SO` | Somali (Somalia). |\n| `sq-AL` | Albanian (Albania). |\n| `sr-RS` | Serbian (Serbia). |\n| `ss-SZ` | Swati (Eswatini). |\n| `st-LS` | Southern Sotho (Lesotho). |\n| `su-ID` | Sundanese (Indonesia). |\n| `sv-SE` | Swedish (Sweden). |\n| `sw-TZ` | Swahili (Tanzania). |\n| `ta-IN` | Tamil (India). |\n| `te-IN` | Telugu (India). |\n| `tg-TJ` | Tajik (Tajikistan). |\n| `th-TH` | Thai (Thailand). |\n| `ti-ET` | Tigrinya (Ethiopia). |\n| `tk-TM` | Turkmen (Turkmenistan). |\n| `tl-PH` | Tagalog (Philippines). |\n| `tn-BW` | Tswana (Botswana). |\n| `to-TO` | Tonga (Tonga). |\n| `tr-TR` | Turkish (Turkey). |\n| `ts-ZA` | Tsonga (South Africa). |\n| `tt-RU` | Tatar (Russia). |\n| `tw-GH` | Twi (Ghana). |\n| `ty-PF` | Tahitian (French Polynesia). |\n| `ug-CN` | Uyghur (China). |\n| `uk-UA` | Ukrainian (Ukraine). |\n| `ur-PK` | Urdu (Pakistan). |\n| `uz-UZ` | Uzbek (Uzbekistan). |\n| `ve-ZA` | Venda (South Africa). |\n| `vi-VN` | Vietnamese (Vietnam). |\n| `vo-INT` | Volapük (International). |\n| `wa-BE` | Walloon (Belgium). |\n| `wo-SN` | Wolof (Senegal). |\n| `xh-ZA` | Xhosa (South Africa). |\n| `yi-IL` | Yiddish (Israel). |\n| `yo-NG` | Yoruba (Nigeria). |\n| `za-CN` | Zhuang (China). |\n| `zh-CN` | Chinese (China). |\n| `zh-TW` | Chinese (Taiwan). |\n| `zu-ZA` | Zulu (South Africa). |\n","enum":["ak-GH","am-ET","an-ES","ar-AE","as-IN","av-RU","ay-BO","ba-RU","be-BY","bg-BG","bh-IN","bi-VU","bm-ML","bo-CN","bs-BA","ca-ES","ce-RU","ch-GU","de-DE","el-GR","en-AE","en-AU","en-CA","en-GB","en-IN","en-SG","en-US","eo-INT","es-CO","es-ES","es-MX","et-EE","eu-ES","fa-IR","fi-FI","fj-FJ","fo-FO","fr-CA","fr-FR","fy-NL","ga-IE","gd-GB","gl-ES","gn-PY","gu-IN","gv-IM","ha-NG","he-IL","hi-IN","ho-PG","hr-HR","ht-HT","hu-HU","hy-AM","hz-NA","ia-INT","id-ID","ie-INT","ig-NG","ii-CN","ik-US","io-INT","is-IS","it-IT","iu-CA","ja-JP","jv-ID","ka-GE","kg-CD","ki-KE","kj-NA","kk-KZ","kl-GL","km-KH","kn-IN","ko-KR","kr-NG","ks-IN","ku-TR","kv-RU","kw-GB","ky-KG","la-VA","lb-LU","lg-UG","li-NL","ln-CD","lo-LA","lt-LT","lu-CD","lv-LV","mg-MG","mh-MH","mi-NZ","mk-MK","ml-IN","mn-MN","mr-IN","ms-MY","mt-MT","my-MM","na-NR","nb-NO","nd-ZW","ne-NP","ng-NA","nl-NL","nn-NO","no-NO","nr-ZA","nv-US","ny-MW","oc-FR","oj-CA","om-ET","or-IN","os-RU","pa-IN","pi-IN","pl-PL","ps-AF","pt-BR","pt-PT","qu-PE","rm-CH","rn-BI","ro-RO","ru-RU","rw-RW","sa-IN","sc-IT","sd-PK","se-NO","sg-CF","si-LK","sk-SK","sl-SI","sm-WS","sn-ZW","so-SO","sq-AL","sr-RS","ss-SZ","st-LS","su-ID","sv-SE","sw-TZ","ta-IN","te-IN","tg-TJ","th-TH","ti-ET","tk-TM","tl-PH","tn-BW","to-TO","tr-TR","ts-ZA","tt-RU","tw-GH","ty-PF","ug-CN","uk-UA","ur-PK","uz-UZ","ve-ZA","vi-VN","vo-INT","wa-BE","wo-SN","xh-ZA","yi-IL","yo-NG","za-CN","zh-CN","zh-TW","zu-ZA"],"type":"string","x-enum-varnames":["ak_GH","am_ET","an_ES","ar_AE","as_IN","av_RU","ay_BO","ba_RU","be_BY","bg_BG","bh_IN","bi_VU","bm_ML","bo_CN","bs_BA","ca_ES","ce_RU","ch_GU","de_DE","el_GR","en_AE","en_AU","en_CA","en_GB","en_IN","en_SG","en_US","eo_INT","es_CO","es_ES","es_MX","et_EE","eu_ES","fa_IR","fi_FI","fj_FJ","fo_FO","fr_CA","fr_FR","fy_NL","ga_IE","gd_GB","gl_ES","gn_PY","gu_IN","gv_IM","ha_NG","he_IL","hi_IN","ho_PG","hr_HR","ht_HT","hu_HU","hy_AM","hz_NA","ia_INT","id_ID","ie_INT","ig_NG","ii_CN","ik_US","io_INT","is_IS","it_IT","iu_CA","ja_JP","jv_ID","ka_GE","kg_CD","ki_KE","kj_NA","kk_KZ","kl_GL","km_KH","kn_IN","ko_KR","kr_NG","ks_IN","ku_TR","kv_RU","kw_GB","ky_KG","la_VA","lb_LU","lg_UG","li_NL","ln_CD","lo_LA","lt_LT","lu_CD","lv_LV","mg_MG","mh_MH","mi_NZ","mk_MK","ml_IN","mn_MN","mr_IN","ms_MY","mt_MT","my_MM","na_NR","nb_NO","nd_ZW","ne_NP","ng_NA","nl_NL","nn_NO","no_NO","nr_ZA","nv_US","ny_MW","oc_FR","oj_CA","om_ET","or_IN","os_RU","pa_IN","pi_IN","pl_PL","ps_AF","pt_BR","pt_PT","qu_PE","rm_CH","rn_BI","ro_RO","ru_RU","rw_RW","sa_IN","sc_IT","sd_PK","se_NO","sg_CF","si_LK","sk_SK","sl_SI","sm_WS","sn_ZW","so_SO","sq_AL","sr_RS","ss_SZ","st_LS","su_ID","sv_SE","sw_TZ","ta_IN","te_IN","tg_TJ","th_TH","ti_ET","tk_TM","tl_PH","tn_BW","to_TO","tr_TR","ts_ZA","tt_RU","tw_GH","ty_PF","ug_CN","uk_UA","ur_PK","uz_UZ","ve_ZA","vi_VN","vo_INT","wa_BE","wo_SN","xh_ZA","yi_IL","yo_NG","za_CN","zh_CN","zh_TW","zu_ZA"]},"Marketplace":{"description":"A list of country codes representing Amazon marketplaces\n\n","enum":["AE","AU","BE","BR","CA","CL","CO","DE","EG","ES","FR","GB","IE","IN","IT","JP","MX","NG","NL","PL","SA","SE","SG","TR","US","ZA"],"type":"string"},"NotFoundResponseContent":{"properties":{"code":{"$ref":"#/components/schemas/ErrorCode"},"message":{"type":"string"}},"required":["code","message"],"type":"object"},"ObjectSettings":{"oneOf":[{"properties":{"ad":{"type":"string"}},"required":["ad"],"title":"ad","type":"object"},{"properties":{"adGroup":{"type":"string"}},"required":["adGroup"],"title":"adGroup","type":"object"},{"properties":{"automaticGlobalAdsEnrollmentSettings":{"$ref":"#/components/schemas/AutomaticGlobalAdsEnrollmentSettings"}},"required":["automaticGlobalAdsEnrollmentSettings"],"title":"automaticGlobalAdsEnrollmentSettings","type":"object"},{"properties":{"brandProductKeywordSettings":{"$ref":"#/components/schemas/BrandProductKeywordSettings"}},"required":["brandProductKeywordSettings"],"title":"brandProductKeywordSettings","type":"object"},{"properties":{"brandProductSegmentSettings":{"$ref":"#/components/schemas/BrandProductSegmentSettings"}},"required":["brandProductSegmentSettings"],"title":"brandProductSegmentSettings","type":"object"},{"properties":{"campaign":{"type":"string"}},"required":["campaign"],"title":"campaign","type":"object"},{"properties":{"target":{"type":"string"}},"required":["target"],"title":"target","type":"object"}]},"PotentialImpact":{"description":"Estimated impact of the recommendation","properties":{"marketplaces":{"description":"Specifies the marketplace that will be impacted if an action is taken on the recommendedObject","items":{"$ref":"#/components/schemas/Marketplace"},"maxItems":30,"minItems":0,"type":"array"},"metric":{"description":"The metric being measured","pattern":"^[a-zA-Z0-9]+\\.[a-zA-Z0-9]+$","type":"string"},"metricUnitClassification":{"$ref":"#/components/schemas/ReportingFieldClassificationTag"},"metricUnitType":{"$ref":"#/components/schemas/ReportingFieldDataType"},"range":{"$ref":"#/components/schemas/EstimatedRange"},"value":{"description":"The estimated value of the impact","format":"double","type":"number"}},"required":["metric"],"type":"object"},"ProductIdType":{"description":"**ProductIdType Enum:**\n\n| ProductIdType | Description |\n|------|------|\n| `ASIN` | ASIN identifier type. |\n","enum":["ASIN"],"type":"string"},"ProductScopeInclusions":{"description":"Criteria for selecting products to include in a collection.","properties":{"brandProductSegmentIds":{"description":"Brand product segment identifiers (a ProductCategory type) to include.","items":{"type":"string"},"maxItems":100,"minItems":0,"type":"array"},"products":{"description":"Products to include in the collection.","items":{"$ref":"#/components/schemas/AdvertisedProducts"},"maxItems":1000,"minItems":0,"type":"array"}},"type":"object"},"QueryRecommendationRequest":{"properties":{"accessRequestedAccounts":{"items":{"$ref":"#/components/schemas/QueryRecommendationRequestAccessRequestedAccountItem"},"maxItems":2000,"minItems":1,"type":"array"},"adProductFilter":{"$ref":"#/components/schemas/RecommendationAdProductFilter"},"languageFilter":{"$ref":"#/components/schemas/RecommendationLanguageLocaleIsoFilter"},"marketplacesFilter":{"$ref":"#/components/schemas/RecommendationMarketplaceFilter"},"maxResults":{"default":100,"format":"int32","maximum":100,"minimum":1,"type":"integer"},"nextToken":{"type":"string"},"recommendationTypeDetailsFilter":{"$ref":"#/components/schemas/RecommendationRecommendationTypeDetailsFilter"},"recommendationTypeFilter":{"$ref":"#/components/schemas/RecommendationRecommendationTypeEnumFilter"}},"required":["accessRequestedAccounts"],"type":"object"},"QueryRecommendationRequestAccessRequestedAccountItem":{"description":"| QueryRecommendationRequestAccessRequestedAccountItem | Description |\n| --- | --- |\n| `advertiserAccountId` | ADSP Regional Account or Global Account |","oneOf":[{"properties":{"advertiserAccountId":{"type":"string"}},"required":["advertiserAccountId"],"title":"advertiserAccountId","type":"object"}]},"Recommendation":{"properties":{"adProduct":{"$ref":"#/components/schemas/AdProduct"},"advertiserAccount":{"$ref":"#/components/schemas/RecommendationAdvertiserAccount"},"createdDateTime":{"description":"The date time when the recommendation is created, used for internal purposes only","format":"date-time","type":"string"},"deferredUntilDateTime":{"description":"The date time when a snoozed recommendation will be displayed again","format":"date-time","type":"string"},"expiryDateTime":{"description":"The date time when the recommendation will expire","format":"date-time","type":"string"},"language":{"$ref":"#/components/schemas/LanguageLocaleIso"},"marketplaces":{"description":"Specifies the marketplaces where the recommendation is exposed to customers. Note that this display marketplace may differ from the actual geographical regions where the recommended actions can be implemented.","items":{"$ref":"#/components/schemas/Marketplace"},"maxItems":30,"minItems":0,"type":"array"},"potentialImpacts":{"description":"Estimated customer benefits if recommendation is followed","items":{"$ref":"#/components/schemas/PotentialImpact"},"maxItems":100,"minItems":0,"type":"array"},"publishedDateTime":{"description":"The date time when the recommendation is published","format":"date-time","type":"string"},"recommendationId":{"description":"The identifier of the recommendation","type":"string"},"recommendationInsight":{"$ref":"#/components/schemas/RecommendationInsight"},"recommendationType":{"$ref":"#/components/schemas/RecommendationTypeEnum"},"recommendationTypeDetails":{"$ref":"#/components/schemas/RecommendationTypeDetails"},"recommendedAction":{"$ref":"#/components/schemas/RecommendedAction"},"recommendedObjects":{"description":"The target objects of the recommendation","items":{"$ref":"#/components/schemas/RecommendedObject"},"maxItems":1000,"minItems":1,"type":"array"},"state":{"$ref":"#/components/schemas/RecommendationState"},"tags":{"description":"Open ended labels with a key value pair applied to the recommendation","items":{"$ref":"#/components/schemas/Tag"},"maxItems":50,"minItems":0,"type":"array"}},"required":["adProduct","createdDateTime","language","publishedDateTime","recommendationId","recommendationType","recommendedObjects","state"],"type":"object"},"RecommendationAdProductFilter":{"properties":{"include":{"description":"**AdProduct Enum:**\n| AdProduct | Description |\n| --- | --- |\n| `SPONSORED_PRODUCTS` | Sponsored Products ad product. |\n| `SPONSORED_BRANDS` | Sponsored Brands ad product. |\n| `SPONSORED_DISPLAY` | Sponsored Display ad product. |\n| `SPONSORED_TELEVISION` | Sponsored Television ad product. |\n| `AMAZON_DSP` | Amazon Demand-Side Platform ad product. |\n| `FULL_FUNNEL` | Full funnel ad product combining multiple ad types. |\n| `RMS` | Sponsored ads for external retailers. |","items":{"$ref":"#/components/schemas/AdProduct"},"maxItems":7,"minItems":1,"type":"array"}},"required":["include"],"type":"object"},"RecommendationAdvertiserAccount":{"description":"The advertiser account attributes exposed inline on a recommendation. Mirrors selected fields of the AdvertiserAccount entity so consumers receive account details without a separate lookup.","properties":{"advertiserAccountId":{"description":"The unique identifier for the advertiser account.","type":"string"},"displayName":{"description":"Display name for the advertiser account.","type":"string"}},"type":"object"},"RecommendationInsight":{"description":"Contextual information explaining why this recommendation is relevant, such as title, description, or explanation.","properties":{"insightTexts":{"description":"Key-value pairs of insight information (e.g. key\u003d\u0027description\u0027, value\u003d\u0027Your campaign ran out of budget 3 times last week\u0027).","items":{"$ref":"#/components/schemas/Tag"},"maxItems":10,"minItems":1,"type":"array"}},"required":["insightTexts"],"type":"object"},"RecommendationLanguageLocaleIsoFilter":{"properties":{"include":{"description":"**Language Enum:**\n| Language | Description |\n| --- | --- |\n| `ak-GH` | Akan (Ghana). |\n| `am-ET` | Amharic (Ethiopia). |\n| `an-ES` | Aragonese (Spain). |\n| `ar-AE` | Arabic (UAE). |\n| `as-IN` | Assamese (India). |\n| `av-RU` | Avaric (Russia). |\n| `ay-BO` | Aymara (Bolivia). |\n| `ba-RU` | Bashkir (Russia). |\n| `be-BY` | Belarusian (Belarus). |\n| `bg-BG` | Bulgarian (Bulgaria). |\n| `bh-IN` | Bihari (India). |\n| `bi-VU` | Bislama (Vanuatu). |\n| `bm-ML` | Bambara (Mali). |\n| `bo-CN` | Tibetan (China). |\n| `bs-BA` | Bosnian (Bosnia and Herzegovina). |\n| `ca-ES` | Catalan (Spain). |\n| `ce-RU` | Chechen (Russia). |\n| `ch-GU` | Chamorro (Guam). |\n| `de-DE` | German (Germany). |\n| `el-GR` | Greek (Greece). |\n| `en-AE` | English (UAE). |\n| `en-AU` | English (Australia). |\n| `en-CA` | English (Canada). |\n| `en-GB` | English (United Kingdom). |\n| `en-IN` | English (India). |\n| `en-SG` | English (Singapore). |\n| `en-US` | English (United States). |\n| `eo-INT` | Esperanto (International). |\n| `es-CO` | Spanish (Colombia). |\n| `es-ES` | Spanish (Spain). |\n| `es-MX` | Spanish (Mexico). |\n| `et-EE` | Estonian (Estonia). |\n| `eu-ES` | Basque (Spain). |\n| `fa-IR` | Persian (Iran). |\n| `fi-FI` | Finnish (Finland). |\n| `fj-FJ` | Fijian (Fiji). |\n| `fo-FO` | Faroese (Faroe Islands). |\n| `fr-CA` | French (Canada). |\n| `fr-FR` | French (France). |\n| `fy-NL` | Western Frisian (Netherlands). |\n| `ga-IE` | Irish (Ireland). |\n| `gd-GB` | Scottish Gaelic (United Kingdom). |\n| `gl-ES` | Galician (Spain). |\n| `gn-PY` | Guarani (Paraguay). |\n| `gu-IN` | Gujarati (India). |\n| `gv-IM` | Manx (Isle of Man). |\n| `ha-NG` | Hausa (Nigeria). |\n| `he-IL` | Hebrew (Israel). |\n| `hi-IN` | Hindi (India). |\n| `ho-PG` | Hiri Motu (Papua New Guinea). |\n| `hr-HR` | Croatian (Croatia). |\n| `ht-HT` | Haitian Creole (Haiti). |\n| `hu-HU` | Hungarian (Hungary). |\n| `hy-AM` | Armenian (Armenia). |\n| `hz-NA` | Herero (Namibia). |\n| `ia-INT` | Interlingua (International). |\n| `id-ID` | Indonesian (Indonesia). |\n| `ie-INT` | Interlingue (International). |\n| `ig-NG` | Igbo (Nigeria). |\n| `ii-CN` | Sichuan Yi (China). |\n| `ik-US` | Inupiaq (United States). |\n| `io-INT` | Ido (International). |\n| `is-IS` | Icelandic (Iceland). |\n| `it-IT` | Italian (Italy). |\n| `iu-CA` | Inuktitut (Canada). |\n| `ja-JP` | Japanese (Japan). |\n| `jv-ID` | Javanese (Indonesia). |\n| `ka-GE` | Georgian (Georgia). |\n| `kg-CD` | Kongo (Democratic Republic of the Congo). |\n| `ki-KE` | Kikuyu (Kenya). |\n| `kj-NA` | Kwanyama (Namibia). |\n| `kk-KZ` | Kazakh (Kazakhstan). |\n| `kl-GL` | Kalaallisut (Greenland). |\n| `km-KH` | Khmer (Cambodia). |\n| `kn-IN` | Kannada (India). |\n| `ko-KR` | Korean (South Korea). |\n| `kr-NG` | Kanuri (Nigeria). |\n| `ks-IN` | Kashmiri (India). |\n| `ku-TR` | Kurdish (Turkey). |\n| `kv-RU` | Komi (Russia). |\n| `kw-GB` | Cornish (United Kingdom). |\n| `ky-KG` | Kyrgyz (Kyrgyzstan). |\n| `la-VA` | Latin (Vatican City). |\n| `lb-LU` | Luxembourgish (Luxembourg). |\n| `lg-UG` | Ganda (Uganda). |\n| `li-NL` | Limburgish (Netherlands). |\n| `ln-CD` | Lingala (Democratic Republic of the Congo). |\n| `lo-LA` | Lao (Laos). |\n| `lt-LT` | Lithuanian (Lithuania). |\n| `lu-CD` | Luba-Katanga (Democratic Republic of the Congo). |\n| `lv-LV` | Latvian (Latvia). |\n| `mg-MG` | Malagasy (Madagascar). |\n| `mh-MH` | Marshallese (Marshall Islands). |\n| `mi-NZ` | Māori (New Zealand). |\n| `mk-MK` | Macedonian (North Macedonia). |\n| `ml-IN` | Malayalam (India). |\n| `mn-MN` | Mongolian (Mongolia). |\n| `mr-IN` | Marathi (India). |\n| `ms-MY` | Malay (Malaysia). |\n| `mt-MT` | Maltese (Malta). |\n| `my-MM` | Burmese (Myanmar). |\n| `na-NR` | Nauru (Nauru). |\n| `nb-NO` | Norwegian Bokmål (Norway). |\n| `nd-ZW` | North Ndebele (Zimbabwe). |\n| `ne-NP` | Nepali (Nepal). |\n| `ng-NA` | Ndonga (Namibia). |\n| `nl-NL` | Dutch (Netherlands). |\n| `nn-NO` | Norwegian Nynorsk (Norway). |\n| `no-NO` | Norwegian (Norway). |\n| `nr-ZA` | South Ndebele (South Africa). |\n| `nv-US` | Navajo (United States). |\n| `ny-MW` | Chichewa (Malawi). |\n| `oc-FR` | Occitan (France). |\n| `oj-CA` | Ojibwa (Canada). |\n| `om-ET` | Oromo (Ethiopia). |\n| `or-IN` | Oriya (India). |\n| `os-RU` | Ossetian (Russia). |\n| `pa-IN` | Punjabi (India). |\n| `pi-IN` | Pali (India). |\n| `pl-PL` | Polish (Poland). |\n| `ps-AF` | Pashto (Afghanistan). |\n| `pt-BR` | Portuguese (Brazil). |\n| `pt-PT` | Portuguese (Portugal). |\n| `qu-PE` | Quechua (Peru). |\n| `rm-CH` | Romansh (Switzerland). |\n| `rn-BI` | Kirundi (Burundi). |\n| `ro-RO` | Romanian (Romania). |\n| `ru-RU` | Russian (Russia). |\n| `rw-RW` | Kinyarwanda (Rwanda). |\n| `sa-IN` | Sanskrit (India). |\n| `sc-IT` | Sardinian (Italy). |\n| `sd-PK` | Sindhi (Pakistan). |\n| `se-NO` | Northern Sami (Norway). |\n| `sg-CF` | Sango (Central African Republic). |\n| `si-LK` | Sinhala (Sri Lanka). |\n| `sk-SK` | Slovak (Slovakia). |\n| `sl-SI` | Slovenian (Slovenia). |\n| `sm-WS` | Samoan (Samoa). |\n| `sn-ZW` | Shona (Zimbabwe). |\n| `so-SO` | Somali (Somalia). |\n| `sq-AL` | Albanian (Albania). |\n| `sr-RS` | Serbian (Serbia). |\n| `ss-SZ` | Swati (Eswatini). |\n| `st-LS` | Southern Sotho (Lesotho). |\n| `su-ID` | Sundanese (Indonesia). |\n| `sv-SE` | Swedish (Sweden). |\n| `sw-TZ` | Swahili (Tanzania). |\n| `ta-IN` | Tamil (India). |\n| `te-IN` | Telugu (India). |\n| `tg-TJ` | Tajik (Tajikistan). |\n| `th-TH` | Thai (Thailand). |\n| `ti-ET` | Tigrinya (Ethiopia). |\n| `tk-TM` | Turkmen (Turkmenistan). |\n| `tl-PH` | Tagalog (Philippines). |\n| `tn-BW` | Tswana (Botswana). |\n| `to-TO` | Tonga (Tonga). |\n| `tr-TR` | Turkish (Turkey). |\n| `ts-ZA` | Tsonga (South Africa). |\n| `tt-RU` | Tatar (Russia). |\n| `tw-GH` | Twi (Ghana). |\n| `ty-PF` | Tahitian (French Polynesia). |\n| `ug-CN` | Uyghur (China). |\n| `uk-UA` | Ukrainian (Ukraine). |\n| `ur-PK` | Urdu (Pakistan). |\n| `uz-UZ` | Uzbek (Uzbekistan). |\n| `ve-ZA` | Venda (South Africa). |\n| `vi-VN` | Vietnamese (Vietnam). |\n| `vo-INT` | Volapük (International). |\n| `wa-BE` | Walloon (Belgium). |\n| `wo-SN` | Wolof (Senegal). |\n| `xh-ZA` | Xhosa (South Africa). |\n| `yi-IL` | Yiddish (Israel). |\n| `yo-NG` | Yoruba (Nigeria). |\n| `za-CN` | Zhuang (China). |\n| `zh-CN` | Chinese (China). |\n| `zh-TW` | Chinese (Taiwan). |\n| `zu-ZA` | Zulu (South Africa). |","items":{"$ref":"#/components/schemas/LanguageLocaleIso"},"maxItems":1,"minItems":1,"type":"array"}},"required":["include"],"type":"object"},"RecommendationMarketplaceFilter":{"properties":{"include":{"items":{"$ref":"#/components/schemas/Marketplace"},"maxItems":26,"minItems":1,"type":"array"}},"required":["include"],"type":"object"},"RecommendationRecommendationTypeDetailsFilter":{"properties":{"include":{"items":{"$ref":"#/components/schemas/RecommendationTypeDetails"},"maxItems":30,"minItems":1,"type":"array"}},"required":["include"],"type":"object"},"RecommendationRecommendationTypeEnumFilter":{"properties":{"include":{"description":"**RecommendationType Enum:**\n| RecommendationType | Description |\n| --- | --- |\n| `BRAND_PRODUCT_SEGMENT` | Recommends product groups within a brand that shoppers search for as a distinct need. Requires BrandProductSegmentRecommendationTypeDetails to scope by brand. |\n| `BRAND_PRODUCT_KEYWORD` | Recommends keywords and bids for brand product segments. Requires BrandProductKeywordRecommendationTypeDetails to scope by brand and inclusions. |\n| `AUTOMATIC_GLOBAL_ADS_ENROLLMENT` | Surfaces an advertiser\u0027s automatic global ads enrollment status and trial performance. No additional type details are required when querying. |\n| `PAUSED_CAMPAIGN_RESUMPTION` | Recommends resuming campaigns that were automatically paused by the system so the advertiser can recover lost sales. No additional type details are required when querying. |\n| `BUDGETING_INSIGHT_MISSED_SALES` | Surfaces estimated sales missed due to budget constraints for the advertiser. No additional type details are required when querying. |\n| `BUDGET_RULES` | Recommends setting up budget rules that automatically adjust campaign budgets based on performance and schedule. No additional type details are required when querying. |\n| `RULE_BASED_BIDDING` | Recommends rule-based bidding to automatically adjust bids based on advertiser-defined rules. No additional type details are required when querying. |\n| `SCHEDULE_BID_RULE` | Recommends scheduling intraday bid adjustments to change bids by time of day. No additional type details are required when querying. |\n| `CREDIT_AVAILABLE` | Notifies the advertiser of advertising credit available to apply to their campaigns. No additional type details are required when querying. |\n| `CREDIT_EXPIRING` | Notifies the advertiser of advertising credit that is about to expire. No additional type details are required when querying. |\n| `ELIGIBLE_PROMOTION` | Notifies the advertiser of an advertising promotion they are eligible for. No additional type details are required when querying. |\n| `FUNNEL_ANALYSIS` | Surfaces full-funnel performance analysis across the advertiser\u0027s campaigns. No additional type details are required when querying. |\n| `FUNNEL_NEW_TO_BRAND_GROWTH` | Highlights new-to-brand customer growth opportunities across the marketing funnel. No additional type details are required when querying. |\n| `BRAND_METRICS_INSIGHTS` | Surfaces brand-metrics insights such as awareness and consideration for the advertiser. No additional type details are required when querying. |\n| `GLOBAL_TARGETING_INSIGHT_ABOVE_ZERO_SALES` | Surfaces ad targets that have generated sales for the advertiser. No additional type details are required when querying. |\n| `GLOBAL_TARGETING_INSIGHT_OPTIMIZE_CONVERSION` | Surfaces ad targets with low conversion rate for the advertiser. No additional type details are required when querying. |\n| `SP_TARGETING_CONSOLIDATED` | Recommends Sponsored Products keyword recommendations including adding new keywords and pausing under-performing keywords. No additional type details are required when querying. |\n| `SEASONAL_TARGETING_STRATEGY` | Recommends seasonally relevant keywords for the advertiser\u0027s Sponsored Products campaigns. No additional type details are required when querying. |\n| `TAILORED_CAMPAIGNS` | Recommends tailored preset Sponsored Products campaigns for the advertiser. No additional type details are required when querying. |\n| `GLOBAL_TAILORED_CAMPAIGNS` | Recommends tailored Sponsored Products campaigns for global marketplaces. No additional type details are required when querying. |\n| `SB_TAILORED_AUDIENCE_EXISTING` | Recommends a tailored Sponsored Brands campaign for existing SB audiences. No additional type details are required when querying. |\n| `SB_TAILORED_AUDIENCE_NO_STORE` | Recommends a tailored Sponsored Brands campaign for advertisers without a Store. No additional type details are required when querying. |\n| `SB_TAILORED_AUDIENCE_WITH_STORE` | Recommends a tailored Sponsored Brands campaign for advertisers with a Store. No additional type details are required when querying. |\n| `SB_TAILORED_AUDIENCE_NEW_TO_BRAND` | Recommends a tailored Sponsored Brands campaign targeting new-to-brand shoppers. No additional type details are required when querying. |\n| `STORE_PRODUCT_COLLECTION` | Recommends adding a product collection page to the advertiser\u0027s Brand Store. No additional type details are required when querying. |\n| `NEW_USER_SHOPPABLE_IMAGE` | Recommends adding shoppable images to the advertiser\u0027s Brand Store. No additional type details are required when querying. |\n| `NEW_USER_ENGAGEMENT_CODE` | Surfaces an onboarding engagement nudge for non-account managed advertisers. No additional type details are required when querying. |\n| `SP_ONBOARDING_OPTIMIZE_VIDEO` | Recommends targeting approach to boost SP performance on AAC video card. No additional type details are required when querying. |\n| `PARTNER_DIRECTORY` | Recommends top matched SpA advertising partners, providing Partner Directory profile details. No additional type details are required when querying. |\n| `PERFORMANCE_BASED_ADS_TOP_OF_SEARCH` | Recommends performance-based bidding to win top-of-search placements. No additional type details are required when querying. |\n| `SPONSORED_ADS_BOOST` | Recommends advertisers to use Pay in Card Currency. No additional type details are required when querying. |\n| `ADS_PLANNER` | Recommends using Ads Planner to plan upcoming advertising campaigns. No additional type details are required when querying. |\n| `STV_INCREASE_SALES_VIDEO_AI` | Recommends using AI-generated video to increase sales with Sponsored TV. No additional type details are required when querying. |\n| `STV_READY` | Notifies the advertiser that they are ready to begin Sponsored TV advertising. No additional type details are required when querying. |\n| `ENGAGEMENT_ACQUISITION` | Recommends an advertiser to launch a Sponsored Brands campaign in a new country. No additional type details are required when querying. |","items":{"$ref":"#/components/schemas/RecommendationTypeEnum"},"maxItems":30,"minItems":1,"type":"array"}},"required":["include"],"type":"object"},"RecommendationState":{"enum":["ACTIVE","APPLIED","DEFERRED","DISMISSED","EXPIRED","INACTIVE"],"type":"string"},"RecommendationSuccessResponse":{"properties":{"nextToken":{"type":"string"},"recommendations":{"items":{"$ref":"#/components/schemas/Recommendation"},"maxItems":300,"minItems":0,"type":"array"},"totalResults":{"format":"int32","type":"integer"}},"type":"object"},"RecommendationTypeDetails":{"oneOf":[{"properties":{"brandProductKeywordRecommendationTypeDetails":{"$ref":"#/components/schemas/BrandProductKeywordRecommendationTypeDetails"}},"required":["brandProductKeywordRecommendationTypeDetails"],"title":"brandProductKeywordRecommendationTypeDetails","type":"object"},{"properties":{"brandProductSegmentRecommendationTypeDetails":{"$ref":"#/components/schemas/BrandProductSegmentRecommendationTypeDetails"}},"required":["brandProductSegmentRecommendationTypeDetails"],"title":"brandProductSegmentRecommendationTypeDetails","type":"object"}]},"RecommendationTypeEnum":{"description":"The unique identifier of the recommendation type. Used to classify and group similar recommendations (e.g. \u0027BRANDED_KEYWORD\u0027).\n**RecommendationTypeEnum Enum:**\n\n| RecommendationTypeEnum | Description |\n|------|------|\n| `ADS_PLANNER` | Recommends using Ads Planner to plan upcoming advertising campaigns. No additional type details are required when querying. |\n| `AUTOMATIC_GLOBAL_ADS_ENROLLMENT` | Surfaces an advertiser\u0027s automatic global ads enrollment status and trial performance. No additional type details are required when querying. |\n| `BRAND_METRICS_INSIGHTS` | Surfaces brand-metrics insights such as awareness and consideration for the advertiser. No additional type details are required when querying. |\n| `BRAND_PRODUCT_KEYWORD` | Recommends keywords and bids for brand product segments. Requires BrandProductKeywordRecommendationTypeDetails to scope by brand and inclusions. |\n| `BRAND_PRODUCT_SEGMENT` | Recommends product groups within a brand that shoppers search for as a distinct need. Requires BrandProductSegmentRecommendationTypeDetails to scope by brand. |\n| `BUDGETING_INSIGHT_MISSED_SALES` | Surfaces estimated sales missed due to budget constraints for the advertiser. No additional type details are required when querying. |\n| `BUDGET_RULES` | Recommends setting up budget rules that automatically adjust campaign budgets based on performance and schedule. No additional type details are required when querying. |\n| `CREDIT_AVAILABLE` | Notifies the advertiser of advertising credit available to apply to their campaigns. No additional type details are required when querying. |\n| `CREDIT_EXPIRING` | Notifies the advertiser of advertising credit that is about to expire. No additional type details are required when querying. |\n| `ELIGIBLE_PROMOTION` | Notifies the advertiser of an advertising promotion they are eligible for. No additional type details are required when querying. |\n| `ENGAGEMENT_ACQUISITION` | Recommends an advertiser to launch a Sponsored Brands campaign in a new country. No additional type details are required when querying. |\n| `FUNNEL_ANALYSIS` | Surfaces full-funnel performance analysis across the advertiser\u0027s campaigns. No additional type details are required when querying. |\n| `FUNNEL_NEW_TO_BRAND_GROWTH` | Highlights new-to-brand customer growth opportunities across the marketing funnel. No additional type details are required when querying. |\n| `GLOBAL_TAILORED_CAMPAIGNS` | Recommends tailored Sponsored Products campaigns for global marketplaces. No additional type details are required when querying. |\n| `GLOBAL_TARGETING_INSIGHT_ABOVE_ZERO_SALES` | Surfaces ad targets that have generated sales for the advertiser. No additional type details are required when querying. |\n| `GLOBAL_TARGETING_INSIGHT_OPTIMIZE_CONVERSION` | Surfaces ad targets with low conversion rate for the advertiser. No additional type details are required when querying. |\n| `NEW_USER_ENGAGEMENT_CODE` | Surfaces an onboarding engagement nudge for non-account managed advertisers. No additional type details are required when querying. |\n| `NEW_USER_SHOPPABLE_IMAGE` | Recommends adding shoppable images to the advertiser\u0027s Brand Store. No additional type details are required when querying. |\n| `PARTNER_DIRECTORY` | Recommends top matched SpA advertising partners, providing Partner Directory profile details. No additional type details are required when querying. |\n| `PAUSED_CAMPAIGN_RESUMPTION` | Recommends resuming campaigns that were automatically paused by the system so the advertiser can recover lost sales. No additional type details are required when querying. |\n| `PERFORMANCE_BASED_ADS_TOP_OF_SEARCH` | Recommends performance-based bidding to win top-of-search placements. No additional type details are required when querying. |\n| `RULE_BASED_BIDDING` | Recommends rule-based bidding to automatically adjust bids based on advertiser-defined rules. No additional type details are required when querying. |\n| `SB_TAILORED_AUDIENCE_EXISTING` | Recommends a tailored Sponsored Brands campaign for existing SB audiences. No additional type details are required when querying. |\n| `SB_TAILORED_AUDIENCE_NEW_TO_BRAND` | Recommends a tailored Sponsored Brands campaign targeting new-to-brand shoppers. No additional type details are required when querying. |\n| `SB_TAILORED_AUDIENCE_NO_STORE` | Recommends a tailored Sponsored Brands campaign for advertisers without a Store. No additional type details are required when querying. |\n| `SB_TAILORED_AUDIENCE_WITH_STORE` | Recommends a tailored Sponsored Brands campaign for advertisers with a Store. No additional type details are required when querying. |\n| `SCHEDULE_BID_RULE` | Recommends scheduling intraday bid adjustments to change bids by time of day. No additional type details are required when querying. |\n| `SEASONAL_TARGETING_STRATEGY` | Recommends seasonally relevant keywords for the advertiser\u0027s Sponsored Products campaigns. No additional type details are required when querying. |\n| `SPONSORED_ADS_BOOST` | Recommends advertisers to use Pay in Card Currency. No additional type details are required when querying. |\n| `SP_ONBOARDING_OPTIMIZE_VIDEO` | Recommends targeting approach to boost SP performance on AAC video card. No additional type details are required when querying. |\n| `SP_TARGETING_CONSOLIDATED` | Recommends Sponsored Products keyword recommendations including adding new keywords and pausing under-performing keywords. No additional type details are required when querying. |\n| `STORE_PRODUCT_COLLECTION` | Recommends adding a product collection page to the advertiser\u0027s Brand Store. No additional type details are required when querying. |\n| `STV_INCREASE_SALES_VIDEO_AI` | Recommends using AI-generated video to increase sales with Sponsored TV. No additional type details are required when querying. |\n| `STV_READY` | Notifies the advertiser that they are ready to begin Sponsored TV advertising. No additional type details are required when querying. |\n| `TAILORED_CAMPAIGNS` | Recommends tailored preset Sponsored Products campaigns for the advertiser. No additional type details are required when querying. |\n","enum":["ADS_PLANNER","AUTOMATIC_GLOBAL_ADS_ENROLLMENT","BRAND_METRICS_INSIGHTS","BRAND_PRODUCT_KEYWORD","BRAND_PRODUCT_SEGMENT","BUDGETING_INSIGHT_MISSED_SALES","BUDGET_RULES","CREDIT_AVAILABLE","CREDIT_EXPIRING","ELIGIBLE_PROMOTION","ENGAGEMENT_ACQUISITION","FUNNEL_ANALYSIS","FUNNEL_NEW_TO_BRAND_GROWTH","GLOBAL_TAILORED_CAMPAIGNS","GLOBAL_TARGETING_INSIGHT_ABOVE_ZERO_SALES","GLOBAL_TARGETING_INSIGHT_OPTIMIZE_CONVERSION","NEW_USER_ENGAGEMENT_CODE","NEW_USER_SHOPPABLE_IMAGE","PARTNER_DIRECTORY","PAUSED_CAMPAIGN_RESUMPTION","PERFORMANCE_BASED_ADS_TOP_OF_SEARCH","RULE_BASED_BIDDING","SB_TAILORED_AUDIENCE_EXISTING","SB_TAILORED_AUDIENCE_NEW_TO_BRAND","SB_TAILORED_AUDIENCE_NO_STORE","SB_TAILORED_AUDIENCE_WITH_STORE","SCHEDULE_BID_RULE","SEASONAL_TARGETING_STRATEGY","SPONSORED_ADS_BOOST","SP_ONBOARDING_OPTIMIZE_VIDEO","SP_TARGETING_CONSOLIDATED","STORE_PRODUCT_COLLECTION","STV_INCREASE_SALES_VIDEO_AI","STV_READY","TAILORED_CAMPAIGNS"],"type":"string"},"RecommendedAction":{"description":"Suggested behavior for customer to apply the recommendation","properties":{"href":{"description":"URL Endpoint customers can apply the action","type":"string"},"linkText":{"description":"Call-to-action for customer to follow. May be exposed directly as link text.","type":"string"},"method":{"$ref":"#/components/schemas/HttpVerb"}},"type":"object"},"RecommendedObject":{"description":"Details of the recommended object","properties":{"currentObjectSettings":{"$ref":"#/components/schemas/ObjectSettings"},"description":{"description":"Additional information to provide short contextual information about the recommended object","type":"string"},"displayName":{"description":"Name of the recommendation object","type":"string"},"recommendedAction":{"$ref":"#/components/schemas/RecommendedAction"},"recommendedObjectId":{"description":"Id of the recommendation object, eg:campaignId","type":"string"},"recommendedObjectType":{"$ref":"#/components/schemas/RecommendedObjectType"}},"required":["recommendedObjectType"],"type":"object"},"RecommendedObjectType":{"description":"**RecommendedObjectType Enum:**\n\n| RecommendedObjectType | Description |\n|------|------|\n| `ADGROUP` | A group of ads within a campaign that share similar targeting |\n| `AD` | An individual advertisement within an ad group |\n| `ASIN` | Amazon Standard Identification Number, a unique product identifier |\n| `BRAND_PRODUCT_KEYWORD` | Keyword and bid recommendations for brand product segments. |\n| `BRAND_PRODUCT_SEGMENT` | A product group within a brand that shoppers search for as a distinct need. |\n| `CAMPAIGN` | An advertising campaign that groups together ad groups and ads |\n| `OBJECTIVE` | A campaign objective (e.g. GROW_SALES_ON_AMAZON, RAISE_AWARENESS_ON_AMAZON) recommended for the advertiser. |\n| `TARGET` | A specific audience or placement for ad targeting |\n","enum":["AD","ADGROUP","ASIN","BRAND_PRODUCT_KEYWORD","BRAND_PRODUCT_SEGMENT","CAMPAIGN","OBJECTIVE","TARGET"],"type":"string"},"ReportingFieldClassificationTag":{"enum":["CURRENCY_AED","CURRENCY_AUD","CURRENCY_BRL","CURRENCY_CAD","CURRENCY_CHF","CURRENCY_CNY","CURRENCY_DKK","CURRENCY_EGP","CURRENCY_EUR","CURRENCY_GBP","CURRENCY_INR","CURRENCY_JPY","CURRENCY_MXN","CURRENCY_MXP","CURRENCY_NGN","CURRENCY_NOK","CURRENCY_NZD","CURRENCY_PLN","CURRENCY_SAR","CURRENCY_SEK","CURRENCY_SGD","CURRENCY_TRY","CURRENCY_USD","CURRENCY_ZAR"],"type":"string"},"ReportingFieldDataType":{"enum":["CURRENCY","DECIMAL","LONG","PERCENTAGE"],"type":"string"},"SBAlternateBrandIdType":{"description":"The type of identifier for the alternate brand identifier.\n\n| AlternateBrandIdType | Description |\n|------|------|\n| `BRAND_REGISTRY` | Previous version of brand identifier retrieved from BrandRegistry. Identifiers of this type are returned by the GET /brands operation. |\n","enum":["BRAND_REGISTRY"],"type":"string"},"SBBrandAlternateId":{"description":"Other types of brand identifiers for a brand that are used with other operations.","properties":{"alternateBrandId":{"description":"The alternative brand identifier for the brandId.","type":"string"},"alternateBrandIdType":{"$ref":"#/components/schemas/SBAlternateBrandIdType"}},"required":["alternateBrandId","alternateBrandIdType"],"type":"object"},"SBBrandedKeyword":{"properties":{"brandAlternateId":{"$ref":"#/components/schemas/SBBrandAlternateId"},"keyword":{"description":"Branded keyword","type":"string"}},"required":["brandAlternateId","keyword"],"type":"object"},"SBBrandedKeywordList":{"properties":{"associatedBrandIds":{"description":"Brand IDs associated with the branded keyword list","items":{"type":"string"},"maxItems":1000,"minItems":0,"type":"array"},"brandedKeyword":{"description":"Branded keywords are specific words or phrases that include a company\u0027s brand name or a registered trademark of a brand","items":{"$ref":"#/components/schemas/SBBrandedKeyword"},"maxItems":1000,"minItems":0,"type":"array"}},"type":"object"},"SBBrandedKeywordRecommendationTypeDetails":{"properties":{"brandAlternateId":{"items":{"$ref":"#/components/schemas/SBBrandAlternateId"},"maxItems":1,"minItems":1,"type":"array"},"brandIds":{"description":"The brand ID to scope branded keyword recommendations for","items":{"type":"string"},"maxItems":1,"minItems":0,"type":"array"}},"required":["brandAlternateId"],"type":"object"},"SBCreateBrandAlternateId":{"description":"Other types of brand identifiers for a brand that are used with other operations.","properties":{"alternateBrandId":{"description":"The alternative brand identifier for the brandId.","type":"string"},"alternateBrandIdType":{"$ref":"#/components/schemas/SBAlternateBrandIdType"}},"required":["alternateBrandId","alternateBrandIdType"],"type":"object"},"SBCreateBrandedKeywordRecommendationTypeDetails":{"properties":{"brandAlternateId":{"items":{"$ref":"#/components/schemas/SBCreateBrandAlternateId"},"maxItems":1,"minItems":1,"type":"array"},"brandIds":{"description":"The brand ID to scope branded keyword recommendations for","items":{"type":"string"},"maxItems":1,"minItems":0,"type":"array"}},"required":["brandAlternateId"],"type":"object"},"SBCreateRecommendationRequest":{"properties":{"recommendations":{"items":{"$ref":"#/components/schemas/SBRecommendationCreate"},"maxItems":1,"minItems":1,"type":"array"}},"type":"object"},"SBCreateRecommendationTypeDetails":{"oneOf":[{"properties":{"brandedKeywordRecommendationTypeDetails":{"$ref":"#/components/schemas/SBCreateBrandedKeywordRecommendationTypeDetails"}},"required":["brandedKeywordRecommendationTypeDetails"],"title":"brandedKeywordRecommendationTypeDetails","type":"object"}]},"SBObjectSettings":{"oneOf":[{"properties":{"brandedKeywordList":{"$ref":"#/components/schemas/SBBrandedKeywordList"}},"required":["brandedKeywordList"],"title":"brandedKeywordList","type":"object"}]},"SBRecommendation":{"properties":{"recommendationId":{"description":"The identifier of the recommendation","type":"string"},"recommendationType":{"description":"A unique value to indicate similar recommendations, used for internal purposes only","type":"string"},"recommendationTypeDetails":{"$ref":"#/components/schemas/SBRecommendationTypeDetails"},"recommendedObjects":{"description":"The target objects of the recommendation","items":{"$ref":"#/components/schemas/SBRecommendedObject"},"maxItems":10,"minItems":1,"type":"array"}},"required":["recommendationId","recommendationType","recommendedObjects"],"type":"object"},"SBRecommendationCreate":{"properties":{"recommendationType":{"description":"A unique value to indicate similar recommendations, used for internal purposes only","type":"string"},"recommendationTypeDetails":{"$ref":"#/components/schemas/SBCreateRecommendationTypeDetails"}},"required":["recommendationType"],"type":"object"},"SBRecommendationMultiStatusResponse":{"properties":{"error":{"items":{"$ref":"#/components/schemas/ErrorsIndex"},"maxItems":1,"minItems":0,"type":"array"},"success":{"items":{"$ref":"#/components/schemas/SBRecommendationMultiStatusSuccess"},"maxItems":1,"minItems":0,"type":"array"}},"type":"object"},"SBRecommendationMultiStatusSuccess":{"properties":{"index":{"format":"int32","maximum":0,"minimum":0,"type":"integer"},"recommendation":{"$ref":"#/components/schemas/SBRecommendation"}},"required":["index","recommendation"],"type":"object"},"SBRecommendationTypeDetails":{"oneOf":[{"properties":{"brandedKeywordRecommendationTypeDetails":{"$ref":"#/components/schemas/SBBrandedKeywordRecommendationTypeDetails"}},"required":["brandedKeywordRecommendationTypeDetails"],"title":"brandedKeywordRecommendationTypeDetails","type":"object"}]},"SBRecommendationTypeEnum":{"description":"The unique identifier of the recommendation type. Used to classify and group similar recommendations (e.g. \u0027BRANDED_KEYWORD\u0027).\n**RecommendationTypeEnum Enum:**\n| RecommendationTypeEnum | Description |\n| --- | --- |\n| `BRANDED_KEYWORD` | Suggests branded keywords for advertiser campaigns based on associated brands. Requires BrandedKeywordRecommendationTypeDetails to scope suggestions by brand alternate IDs. |","enum":["BRANDED_KEYWORD"],"type":"string"},"SBRecommendedObject":{"description":"Details of the recommended object","properties":{"recommendedObjectSettings":{"$ref":"#/components/schemas/SBObjectSettings"}},"type":"object"},"ServiceUnavailableErrorResponseContent":{"properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"type":"object"},"Tag":{"properties":{"key":{"description":"A custom key value pair entered by the advertiser. For ADSP Campaigns and Ad Groups, Amazon creates a COMMENTS key when the Comments field is populated in UI.","type":"string"},"value":{"description":"A custom key value pair entered by the advertiser.","type":"string"}},"required":["key","value"],"type":"object"},"TargetingInsightMetrics":{"properties":{"impressionRank":{"description":"The rank of all the insight entry compared to all other advertisers.","format":"int32","type":"integer"},"impressionShare":{"description":"The percentage share of all your insight entry impressions compared to all other advertisers.","format":"double","type":"number"}},"type":"object"},"TooManyRequestsResponseContent":{"properties":{"code":{"$ref":"#/components/schemas/ErrorCode"},"message":{"type":"string"}},"required":["code","message"],"type":"object"},"TrialMetric":{"description":"A single observed trial metric with its value and optional comparison vs. baseline.","properties":{"changePercent":{"description":"Magnitude of change, as a percentage.","format":"double","type":"number"},"metricDescription":{"description":"Tooltip text describing the metric, used for rendering in the UI.","type":"string"},"metricName":{"description":"Which metric this entry reports (e.g. \u0027ROAS\u0027, \u0027CTR\u0027).","type":"string"},"value":{"description":"The observed value of the metric during the trial.","format":"double","type":"number"}},"required":["metricName","value"],"type":"object"},"UnauthorizedResponseContent":{"properties":{"code":{"$ref":"#/components/schemas/ErrorCode"},"message":{"type":"string"}},"required":["code","message"],"type":"object"}},"securitySchemes":{"OAuth2":{"flows":{"authorizationCode":{"authorizationUrl":"https://www.amazon.com/ap/oa","scopes":{"advertising::audiences":"Grants access to data provider APIs","advertising::campaign_management":"Grants write access to campaign management.","advertising::test:create_account":"Grants write access to create test accounts functionality","cpc_advertising:campaign_management":"Grants write access to campaign management. Legacy name (no difference from advertising::campaign_management)"},"tokenUrl":"https://api.amazon.com/auth/o2/token"}},"type":"oauth2"}}},"info":{"description":"Amazon Ads API v1 is a reimagined approach to our Ads API, built to provide a seamless experience across all Amazon advertising products through a common model. [Learn more about Ads API v1.](https://advertising.amazon.com/API/docs/en-us/reference/amazon-ads/overview) To learn about prerequisites and header values, see [Getting started with Amazon Ads API v1](https://advertising.amazon.com/API/docs/en-us/reference/amazon-ads/getting-started).\n\n**Download Amazon Ads API V1 OpenAPI Spec** ([All Products](https://d1y2lf8k3vrkfu.cloudfront.net/openapi/en-us/dest/AmazonAdsAPIALLMerged_prod_3p.json) | [SP](https://d1y2lf8k3vrkfu.cloudfront.net/openapi/en-us/dest/AmazonAdsAPISPMerged_prod_3p.json) | [SP Global](https://d1y2lf8k3vrkfu.cloudfront.net/openapi/en-us/dest/AmazonAdsAPISPGLOBALMerged_prod_3p.json) | [SB](https://d1y2lf8k3vrkfu.cloudfront.net/openapi/en-us/dest/AmazonAdsAPISBMerged_prod_3p.json) | [DSP](https://d1y2lf8k3vrkfu.cloudfront.net/openapi/en-us/dest/AmazonAdsAPIDSPMerged_prod_3p.json) | [ST](https://d1y2lf8k3vrkfu.cloudfront.net/openapi/en-us/dest/AmazonAdsAPISTMerged_prod_3p.json) | [SD](https://d1y2lf8k3vrkfu.cloudfront.net/openapi/en-us/dest/AmazonAdsAPISDMerged_prod_3p.json))","title":"Recommendations API","version":"3.0"},"openapi":"3.0.1","paths":{"/adsApi/v1/create/recommendations/sb":{"post":{"description":"Create recommendations\n\n**Requires one of these permissions**:\n[\"advertiser_campaign_view\"]","operationId":"SBCreateRecommendation","parameters":[{"$ref":"#/components/parameters/AccountIdHeaderOptional"},{"$ref":"#/components/parameters/ClientIdHeader"},{"$ref":"#/components/parameters/ScopeHeaderOptional"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SBCreateRecommendationRequest"}}},"required":true},"responses":{"207":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SBRecommendationMultiStatusResponse"}}},"description":"SBCreateRecommendation 207 response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestResponseContent"}}},"description":"BadRequest 400 response"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedResponseContent"}}},"description":"Unauthorized 401 response"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenResponseContent"}}},"description":"Forbidden 403 response"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundResponseContent"}}},"description":"NotFound 404 response"},"413":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContentTooLargeResponseContent"}}},"description":"ContentTooLarge 413 response"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TooManyRequestsResponseContent"}}},"description":"TooManyRequests 429 response"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerErrorResponseContent"}}},"description":"InternalServerError 500 response"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadGatewayResponseContent"}}},"description":"BadGateway 502 response"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceUnavailableErrorResponseContent"}}},"description":"ServiceUnavailableError 503 response"},"504":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayTimeoutResponseContent"}}},"description":"GatewayTimeout 504 response"}},"security":[{"OAuth2":["advertising::campaign_management"]}],"tags":["Recommendations"]}},"/adsApi/v1/query/recommendations":{"post":{"description":"Fetch full recommendations for a given advertiser and product.\n\n**Requires one of these permissions**:\n[\"adv_billing_view\", \"nemo_transactions_edit\", \"user_edit\", \n\"reports_view\", \"view_performance_dashboard\", \"campaign_confidential_data_view\", \n\"inventory_confidential_data_view\", \"nemo_report_view\", \"brand_posts_view\", \n\"account_edit\", \"amazon_stores_view\", \"advertiser_campaign_view\", \n\"campaign_edit\", \"MasterAccount_Manager\", \"user_view\", \n\"nemo_transactions_view\", \"MasterAccount_Viewer\", \"brand_posts_admin\", \n\"adv_billing_edit\", \"reports_edit\", \"ManagerAccount_Dev\", \n\"advertiser_campaign_edit\", \"account_view\", \"amazon_stores_edit\", \n\"brand_posts_edit\", \"campaign_view\", \"nemo_report_edit\"]","operationId":"QueryRecommendation","parameters":[{"$ref":"#/components/parameters/ClientIdHeader"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueryRecommendationRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecommendationSuccessResponse"}}},"description":"QueryRecommendation 200 response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestResponseContent"}}},"description":"BadRequest 400 response"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedResponseContent"}}},"description":"Unauthorized 401 response"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenResponseContent"}}},"description":"Forbidden 403 response"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundResponseContent"}}},"description":"NotFound 404 response"},"413":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContentTooLargeResponseContent"}}},"description":"ContentTooLarge 413 response"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TooManyRequestsResponseContent"}}},"description":"TooManyRequests 429 response"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerErrorResponseContent"}}},"description":"InternalServerError 500 response"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadGatewayResponseContent"}}},"description":"BadGateway 502 response"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceUnavailableErrorResponseContent"}}},"description":"ServiceUnavailableError 503 response"},"504":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayTimeoutResponseContent"}}},"description":"GatewayTimeout 504 response"}},"security":[{"OAuth2":["advertising::campaign_management"]}],"tags":["Recommendations"]}},"/adsApi/v1/recommendations":{"get":{"description":"List recommendations for a given advertiser.\n\n**Requires one of these permissions**:\n[\"adv_billing_view\", \"nemo_transactions_edit\", \"user_edit\", \n\"reports_view\", \"view_performance_dashboard\", \"campaign_confidential_data_view\", \n\"inventory_confidential_data_view\", \"nemo_report_view\", \"brand_posts_view\", \n\"account_edit\", \"amazon_stores_view\", \"advertiser_campaign_view\", \n\"campaign_edit\", \"MasterAccount_Manager\", \"user_view\", \n\"nemo_transactions_view\", \"MasterAccount_Viewer\", \"brand_posts_admin\", \n\"adv_billing_edit\", \"reports_edit\", \"ManagerAccount_Dev\", \n\"advertiser_campaign_edit\", \"account_view\", \"amazon_stores_edit\", \n\"brand_posts_edit\", \"campaign_view\", \"nemo_report_edit\"]","operationId":"ListRecommendation","parameters":[{"$ref":"#/components/parameters/AdProductQuery"},{"$ref":"#/components/parameters/LanguageLocaleIsoQuery"},{"$ref":"#/components/parameters/MarketplaceQuery"},{"$ref":"#/components/parameters/RecommendationTypeEnumQuery"},{"$ref":"#/components/parameters/NextTokenQuery"},{"$ref":"#/components/parameters/MaxResultsQuery"},{"$ref":"#/components/parameters/AccountIdHeader"},{"$ref":"#/components/parameters/ClientIdHeader"}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecommendationSuccessResponse"}}},"description":"ListRecommendation 200 response"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadRequestResponseContent"}}},"description":"BadRequest 400 response"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnauthorizedResponseContent"}}},"description":"Unauthorized 401 response"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForbiddenResponseContent"}}},"description":"Forbidden 403 response"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotFoundResponseContent"}}},"description":"NotFound 404 response"},"413":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContentTooLargeResponseContent"}}},"description":"ContentTooLarge 413 response"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TooManyRequestsResponseContent"}}},"description":"TooManyRequests 429 response"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerErrorResponseContent"}}},"description":"InternalServerError 500 response"},"502":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BadGatewayResponseContent"}}},"description":"BadGateway 502 response"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceUnavailableErrorResponseContent"}}},"description":"ServiceUnavailableError 503 response"},"504":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GatewayTimeoutResponseContent"}}},"description":"GatewayTimeout 504 response"}},"security":[{"OAuth2":["advertising::campaign_management"]}],"tags":["Recommendations"]}}},"servers":[{"description":"Production server for NA","url":"https://advertising-api.amazon.com"},{"description":"Production server for EU","url":"https://advertising-api-eu.amazon.com"},{"description":"Production server for FE","url":"https://advertising-api-fe.amazon.com"}]}