Amazon Ads API MCP

{"components":{"callbacks":{},"examples":{},"headers":{},"links":{},"parameters":{"AccountIdHeaderOptional":{"description":"The identifier of an Amazon Ads Advertiser Account.","in":"header","name":"Amazon-Ads-AccountId","schema":{"type":"string"}},"ClientIdHeader":{"description":"The identifier of a client associated with a 'Login with Amazon' account.","in":"header","name":"Amazon-Ads-ClientId","required":true,"schema":{"type":"string"}},"ScopeHeader":{"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"}},"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":{"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"},"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| `INTERNAL_ERROR` | The server encountered an unexpected condition that prevented it from fulfilling the request.","enum":["ACTION_NOT_SUPPORTED","ACTIVE_RESOURCE_LIMIT_EXCEEDED","ARCHIVED_PARENT_CANNOT_CREATE","ARCHIVED_PARENT_CANNOT_EDIT","ARCHIVED_RESOURCE_CANNOT_EDIT","AUTOCREATED_ENTITY_CANNOT_EDIT","BAD_REQUEST","CONFLICT","CONTENT_TOO_LARGE","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","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","properties":{}},"maxItems":20,"minItems":1,"type":"array"},"index":{"format":"int32","maximum":99,"minimum":0,"type":"integer"}},"required":["errors","index"],"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"},"InternalServerErrorResponseContent":{"properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"type":"object"},"NotFoundResponseContent":{"properties":{"code":{"$ref":"#/components/schemas/ErrorCode"},"message":{"type":"string"}},"required":["code","message"],"type":"object"},"STAd":{"properties":{"adGroupId":{"description":"The ad group associated with the ad.","type":"string"},"adId":{"description":"The identifier of the ad.","type":"string"},"adProduct":{"$ref":"#/components/schemas/STAdProduct"},"adType":{"$ref":"#/components/schemas/STAdType"},"campaignId":{"description":"The campaign associated with the ad. It's a read-only field.","type":"string"},"creationDateTime":{"description":"The date time that the ad was created.","format":"date-time","type":"string"},"creative":{"$ref":"#/components/schemas/STCreative"},"lastUpdatedDateTime":{"description":"The date time that the ad was last updated.","format":"date-time","type":"string"},"marketplaceScope":{"$ref":"#/components/schemas/STMarketplaceScope"},"marketplaces":{"description":"A list of country codes representing Amazon marketplaces\n| Marketplace | Description |\n| --- | --- |\n| `AU` | |\n| `BR` | |\n| `CA` | |\n| `DE` | |\n| `ES` | |\n| `FR` | |\n| `GB` | |\n| `IN` | |\n| `IT` | |\n| `JP` | |\n| `MX` | |\n| `SG` | |\n| `US` | |","items":{"$ref":"#/components/schemas/STMarketplace","properties":{}},"maxItems":1,"minItems":1,"type":"array"},"name":{"description":"The name of the ad.","type":"string"},"state":{"$ref":"#/components/schemas/STState"},"status":{"$ref":"#/components/schemas/STStatus"}},"required":["adGroupId","adId","adProduct","adType","campaignId","creationDateTime","creative","lastUpdatedDateTime","marketplaceScope","marketplaces","name","state"],"type":"object"},"STAdAdGroupIdFilter":{"properties":{"include":{"items":{"type":"string"},"maxItems":100,"minItems":1,"type":"array"}},"required":["include"],"type":"object"},"STAdAdIdFilter":{"properties":{"include":{"items":{"type":"string"},"maxItems":100,"minItems":1,"type":"array"}},"required":["include"],"type":"object"},"STAdAdProductFilter":{"properties":{"include":{"description":"| AdProduct | Description |\n| --- | --- |\n| `SPONSORED_TELEVISION` | |","items":{"$ref":"#/components/schemas/STAdProduct"},"maxItems":1,"minItems":1,"type":"array"}},"required":["include"],"type":"object"},"STAdCampaignIdFilter":{"properties":{"include":{"items":{"type":"string"},"maxItems":100,"minItems":1,"type":"array"}},"required":["include"],"type":"object"},"STAdCreate":{"properties":{"adGroupId":{"description":"The ad group associated with the ad.","type":"string"},"adProduct":{"$ref":"#/components/schemas/STAdProduct"},"adType":{"$ref":"#/components/schemas/STAdType"},"creative":{"$ref":"#/components/schemas/STCreateCreative"},"name":{"description":"The name of the ad.","type":"string"},"state":{"$ref":"#/components/schemas/STCreateState"}},"required":["adGroupId","adProduct","adType","creative","name","state"],"type":"object"},"STAdGroup":{"properties":{"adGroupId":{"description":"The unique identifier of the ad group.","type":"string"},"adProduct":{"$ref":"#/components/schemas/STAdProduct"},"bid":{"$ref":"#/components/schemas/STAdGroupBid"},"campaignId":{"description":"The unique identifier of the campaign the ad group belongs to.","type":"string"},"creationDateTime":{"description":"The date time that the ad group was created.","format":"date-time","type":"string"},"lastUpdatedDateTime":{"description":"The date time that the ad group was last updated.","format":"date-time","type":"string"},"marketplaces":{"description":"A list of country codes representing Amazon marketplaces\n| Marketplace | Description |\n| --- | --- |\n| `AU` | |\n| `BR` | |\n| `CA` | |\n| `DE` | |\n| `ES` | |\n| `FR` | |\n| `GB` | |\n| `IN` | |\n| `IT` | |\n| `JP` | |\n| `MX` | |\n| `SG` | |\n| `US` | |","items":{"$ref":"#/components/schemas/STMarketplace","properties":{}},"maxItems":30,"minItems":0,"type":"array"},"name":{"description":"The name of the ad group.","type":"string"},"state":{"$ref":"#/components/schemas/STState"},"status":{"$ref":"#/components/schemas/STStatus"}},"required":["adGroupId","adProduct","campaignId","creationDateTime","lastUpdatedDateTime","name","state"],"type":"object"},"STAdGroupAdGroupIdFilter":{"properties":{"include":{"items":{"type":"string"},"maxItems":100,"minItems":1,"type":"array"}},"required":["include"],"type":"object"},"STAdGroupAdProductFilter":{"properties":{"include":{"description":"| AdProduct | Description |\n| --- | --- |\n| `SPONSORED_TELEVISION` | |","items":{"$ref":"#/components/schemas/STAdProduct"},"maxItems":1,"minItems":1,"type":"array"}},"required":["include"],"type":"object"},"STAdGroupBid":{"properties":{"baseBid":{"description":"The lower bound bid used for the ads in the ad group.","format":"double","type":"number"},"currencyCode":{"$ref":"#/components/schemas/STCurrencyCode"},"defaultBid":{"description":"The default maximum bid for ads and targets in the ad group. This is used in sponsored ads as the maximum bid during the auction.","format":"double","type":"number"}},"required":["currencyCode"],"type":"object"},"STAdGroupCampaignIdFilter":{"properties":{"include":{"items":{"type":"string"},"maxItems":100,"minItems":1,"type":"array"}},"required":["include"],"type":"object"},"STAdGroupCreate":{"properties":{"adProduct":{"$ref":"#/components/schemas/STAdProduct"},"bid":{"$ref":"#/components/schemas/STCreateAdGroupBid"},"campaignId":{"description":"The unique identifier of the campaign the ad group belongs to.","type":"string"},"marketplaces":{"description":"A list of country codes representing Amazon marketplaces\n| Marketplace | Description |\n| --- | --- |\n| `AU` | |\n| `BR` | |\n| `CA` | |\n| `DE` | |\n| `ES` | |\n| `FR` | |\n| `GB` | |\n| `IN` | |\n| `IT` | |\n| `JP` | |\n| `MX` | |\n| `SG` | |\n| `US` | |","items":{"$ref":"#/components/schemas/STMarketplace"},"maxItems":30,"minItems":0,"type":"array"},"name":{"description":"The name of the ad group.","type":"string"},"state":{"$ref":"#/components/schemas/STCreateState"}},"required":["adProduct","campaignId","name","state"],"type":"object"},"STAdGroupMultiStatusResponse":{"properties":{"error":{"items":{"$ref":"#/components/schemas/ErrorsIndex","properties":{}},"maxItems":100,"minItems":0,"type":"array"},"success":{"items":{"$ref":"#/components/schemas/STAdGroupMultiStatusSuccess","properties":{}},"maxItems":100,"minItems":0,"type":"array"}},"type":"object"},"STAdGroupMultiStatusSuccess":{"properties":{"adGroup":{"$ref":"#/components/schemas/STAdGroup"},"index":{"format":"int32","maximum":99,"minimum":0,"type":"integer"}},"required":["adGroup","index"],"type":"object"},"STAdGroupNameFilter":{"properties":{"include":{"items":{"type":"string"},"maxItems":100,"minItems":1,"type":"array"},"queryTermMatchType":{"$ref":"#/components/schemas/STAdGroupNameFilterType"}},"required":["include","queryTermMatchType"],"type":"object"},"STAdGroupNameFilterType":{"description":"| AdGroupNameFilterType | Description |\n| --- | --- |\n| `EXACT_MATCH` | Filter by exact match. |\n| `BROAD_MATCH` | Filter by broad match. |","enum":["BROAD_MATCH","EXACT_MATCH"],"type":"string"},"STAdGroupStateFilter":{"properties":{"include":{"description":"| State | Description |\n| --- | --- |\n| `ENABLED` | |\n| `PAUSED` | |\n| `ARCHIVED` | |","items":{"$ref":"#/components/schemas/STState"},"maxItems":3,"minItems":1,"type":"array"}},"required":["include"],"type":"object"},"STAdGroupSuccessResponse":{"properties":{"adGroups":{"items":{"$ref":"#/components/schemas/STAdGroup","properties":{}},"maxItems":100,"minItems":0,"type":"array"},"nextToken":{"type":"string"}},"type":"object"},"STAdGroupUpdate":{"properties":{"adGroupId":{"description":"The unique identifier of the ad group.","type":"string"},"adProduct":{"$ref":"#/components/schemas/STAdProduct"},"bid":{"$ref":"#/components/schemas/STUpdateAdGroupBid"},"marketplaces":{"description":"A list of country codes representing Amazon marketplaces\n| Marketplace | Description |\n| --- | --- |\n| `AU` | |\n| `BR` | |\n| `CA` | |\n| `DE` | |\n| `ES` | |\n| `FR` | |\n| `GB` | |\n| `IN` | |\n| `IT` | |\n| `JP` | |\n| `MX` | |\n| `SG` | |\n| `US` | |","items":{"$ref":"#/components/schemas/STMarketplace"},"maxItems":30,"minItems":0,"type":"array"},"name":{"description":"The name of the ad group.","type":"string"},"state":{"$ref":"#/components/schemas/STUpdateState"}},"required":["adGroupId"],"type":"object"},"STAdMultiStatusResponse":{"properties":{"error":{"items":{"$ref":"#/components/schemas/ErrorsIndex","properties":{}},"maxItems":100,"minItems":0,"type":"array"},"success":{"items":{"$ref":"#/components/schemas/STAdMultiStatusSuccess","properties":{}},"maxItems":100,"minItems":0,"type":"array"}},"type":"object"},"STAdMultiStatusSuccess":{"properties":{"ad":{"$ref":"#/components/schemas/STAd"},"index":{"format":"int32","maximum":99,"minimum":0,"type":"integer"}},"required":["ad","index"],"type":"object"},"STAdProduct":{"description":"| AdProduct | Description |\n| --- | --- |\n| `SPONSORED_TELEVISION` | |","enum":["SPONSORED_TELEVISION"],"type":"string"},"STAdStateFilter":{"properties":{"include":{"description":"| State | Description |\n| --- | --- |\n| `ENABLED` | |\n| `PAUSED` | |\n| `ARCHIVED` | |","items":{"$ref":"#/components/schemas/STState"},"maxItems":3,"minItems":1,"type":"array"}},"required":["include"],"type":"object"},"STAdSuccessResponse":{"properties":{"ads":{"items":{"$ref":"#/components/schemas/STAd","properties":{}},"maxItems":100,"minItems":0,"type":"array"},"nextToken":{"type":"string"}},"type":"object"},"STAdType":{"description":"| AdType | Description |\n| --- | --- |\n| `VIDEO` | A creative that features one or more videos. |","enum":["VIDEO"],"type":"string"},"STAdUpdate":{"properties":{"adId":{"description":"The identifier of the ad.","type":"string"},"creative":{"$ref":"#/components/schemas/STUpdateCreative"},"name":{"description":"The name of the ad.","type":"string"},"state":{"$ref":"#/components/schemas/STUpdateState"}},"required":["adId"],"type":"object"},"STAdvertisedProducts":{"properties":{"productId":{"description":"The identifier of the advertised product.","type":"string"},"productIdType":{"$ref":"#/components/schemas/STProductIdType"},"resolvedProductId":{"description":"The identifier of product associated with the advertised product. It's a read-only field.","type":"string"},"resolvedProductIdType":{"$ref":"#/components/schemas/STProductIdType"}},"required":["productIdType"],"type":"object"},"STAudienceTarget":{"description":"Target based on a specified audience ID.","properties":{"audienceId":{"$ref":"#/components/schemas/STMarketplaceStringValue"}},"required":["audienceId"],"type":"object"},"STBudget":{"properties":{"budgetType":{"$ref":"#/components/schemas/STBudgetType"},"budgetValue":{"$ref":"#/components/schemas/STBudgetValue"},"recurrenceTimePeriod":{"$ref":"#/components/schemas/STRecurrence"}},"required":["budgetType","budgetValue","recurrenceTimePeriod"],"type":"object"},"STBudgetType":{"description":"| BudgetType | Description |\n| --- | --- |\n| `MONETARY` | |","enum":["MONETARY"],"type":"string"},"STBudgetValue":{"oneOf":[{"properties":{"monetaryBudgetValue":{"$ref":"#/components/schemas/STMonetaryBudgetValue","properties":{}}},"required":["monetaryBudgetValue"],"type":"object"}]},"STCampaign":{"properties":{"adProduct":{"$ref":"#/components/schemas/STAdProduct"},"budgets":{"description":"The object containing budget details for the campaign (for campaigns that support multiple budgets).","items":{"$ref":"#/components/schemas/STBudget","properties":{}},"maxItems":1,"minItems":1,"type":"array"},"campaignId":{"description":"A unique identifier for a campaign.","type":"string"},"countries":{"description":"This field is used in Sponsored Ads and ADSP and impacts targeted supply. For Sponsored Ads, the campaign.countries field determines what Amazon retail supply (Amazon.com, Amazon.co.uk, Amazon.","items":{"$ref":"#/components/schemas/STCountryCode","properties":{}},"maxItems":249,"minItems":0,"type":"array"},"creationDateTime":{"description":"The date time that the campaign was created.","format":"date-time","type":"string"},"endDateTime":{"description":"The end date time for the campaign.","format":"date-time","type":"string"},"lastUpdatedDateTime":{"description":"The date time that the campaign was last updated.","format":"date-time","type":"string"},"marketplaces":{"description":"A list of country codes representing Amazon marketplaces\n| Marketplace | Description |\n| --- | --- |\n| `AU` | |\n| `BR` | |\n| `CA` | |\n| `DE` | |\n| `ES` | |\n| `FR` | |\n| `GB` | |\n| `IN` | |\n| `IT` | |\n| `JP` | |\n| `MX` | |\n| `SG` | |\n| `US` | |","items":{"$ref":"#/components/schemas/STMarketplace","properties":{}},"maxItems":30,"minItems":0,"type":"array"},"name":{"description":"The name of the campaign.","type":"string"},"startDateTime":{"description":"The start date time for the campaign.","format":"date-time","type":"string"},"state":{"$ref":"#/components/schemas/STState"},"status":{"$ref":"#/components/schemas/STStatus"}},"required":["adProduct","budgets","campaignId","creationDateTime","lastUpdatedDateTime","name","startDateTime","state"],"type":"object"},"STCampaignAdProductFilter":{"properties":{"include":{"description":"| AdProduct | Description |\n| --- | --- |\n| `SPONSORED_TELEVISION` | |","items":{"$ref":"#/components/schemas/STAdProduct"},"maxItems":1,"minItems":1,"type":"array"}},"required":["include"],"type":"object"},"STCampaignCreate":{"properties":{"adProduct":{"$ref":"#/components/schemas/STAdProduct"},"budgets":{"description":"The object containing budget details for the campaign (for campaigns that support multiple budgets).","items":{"$ref":"#/components/schemas/STCreateBudget"},"maxItems":1,"minItems":1,"type":"array"},"countries":{"description":"This field is used in Sponsored Ads and ADSP and impacts targeted supply. For Sponsored Ads, the campaign.countries field determines what Amazon retail supply (Amazon.com, Amazon.co.uk, Amazon.","items":{"$ref":"#/components/schemas/STCountryCode"},"maxItems":249,"minItems":0,"type":"array"},"endDateTime":{"description":"The end date time for the campaign.","format":"date-time","type":"string"},"marketplaces":{"description":"A list of country codes representing Amazon marketplaces\n| Marketplace | Description |\n| --- | --- |\n| `AU` | |\n| `BR` | |\n| `CA` | |\n| `DE` | |\n| `ES` | |\n| `FR` | |\n| `GB` | |\n| `IN` | |\n| `IT` | |\n| `JP` | |\n| `MX` | |\n| `SG` | |\n| `US` | |","items":{"$ref":"#/components/schemas/STMarketplace"},"maxItems":30,"minItems":0,"type":"array"},"name":{"description":"The name of the campaign.","type":"string"},"startDateTime":{"description":"The start date time for the campaign.","format":"date-time","type":"string"},"state":{"$ref":"#/components/schemas/STCreateState"}},"required":["adProduct","budgets","name","startDateTime","state"],"type":"object"},"STCampaignMultiStatusResponse":{"properties":{"error":{"items":{"$ref":"#/components/schemas/ErrorsIndex","properties":{}},"maxItems":5,"minItems":0,"type":"array"},"success":{"items":{"$ref":"#/components/schemas/STCampaignMultiStatusSuccess","properties":{}},"maxItems":5,"minItems":0,"type":"array"}},"type":"object"},"STCampaignMultiStatusSuccess":{"properties":{"campaign":{"$ref":"#/components/schemas/STCampaign"},"index":{"format":"int32","maximum":4,"minimum":0,"type":"integer"}},"required":["campaign","index"],"type":"object"},"STCampaignStateFilter":{"properties":{"include":{"description":"| State | Description |\n| --- | --- |\n| `ENABLED` | |\n| `PAUSED` | |\n| `ARCHIVED` | |","items":{"$ref":"#/components/schemas/STState"},"maxItems":3,"minItems":1,"type":"array"}},"required":["include"],"type":"object"},"STCampaignSuccessResponse":{"properties":{"campaigns":{"items":{"$ref":"#/components/schemas/STCampaign","properties":{}},"maxItems":1000,"minItems":0,"type":"array"},"nextToken":{"type":"string"}},"type":"object"},"STCampaignUpdate":{"properties":{"adProduct":{"$ref":"#/components/schemas/STAdProduct"},"budgets":{"description":"The object containing budget details for the campaign (for campaigns that support multiple budgets).","items":{"$ref":"#/components/schemas/STCreateBudget"},"maxItems":1,"minItems":1,"type":"array"},"campaignId":{"description":"A unique identifier for a campaign.","type":"string"},"countries":{"description":"This field is used in Sponsored Ads and ADSP and impacts targeted supply. For Sponsored Ads, the campaign.countries field determines what Amazon retail supply (Amazon.com, Amazon.co.uk, Amazon.","items":{"$ref":"#/components/schemas/STCountryCode"},"maxItems":249,"minItems":0,"type":"array"},"endDateTime":{"description":"The end date time for the campaign.","format":"date-time","nullable":true,"type":"string"},"marketplaces":{"description":"A list of country codes representing Amazon marketplaces\n| Marketplace | Description |\n| --- | --- |\n| `AU` | |\n| `BR` | |\n| `CA` | |\n| `DE` | |\n| `ES` | |\n| `FR` | |\n| `GB` | |\n| `IN` | |\n| `IT` | |\n| `JP` | |\n| `MX` | |\n| `SG` | |\n| `US` | |","items":{"$ref":"#/components/schemas/STMarketplace"},"maxItems":30,"minItems":0,"type":"array"},"name":{"description":"The name of the campaign.","type":"string"},"startDateTime":{"description":"The start date time for the campaign.","format":"date-time","type":"string"},"state":{"$ref":"#/components/schemas/STUpdateState"}},"required":["campaignId"],"type":"object"},"STCountryCode":{"description":"| CountryCode | Description |\n| --- | --- |\n| `AU` | |\n| `BR` | |\n| `CA` | |\n| `DE` | |\n| `ES` | |\n| `FR` | |\n| `GB` | |\n| `IN` | |\n| `IT` | |\n| `JP` | |\n| `MX` | |\n| `SG` | |\n| `US` | |","enum":["AU","BR","CA","DE","ES","FR","GB","IN","IT","JP","MX","SG","US"],"type":"string"},"STCreateAdGroupBid":{"properties":{"baseBid":{"description":"The lower bound bid used for the ads in the ad group.","format":"double","type":"number"},"defaultBid":{"description":"The default maximum bid for ads and targets in the ad group. This is used in sponsored ads as the maximum bid during the auction.","format":"double","type":"number"}},"type":"object"},"STCreateAdGroupRequest":{"properties":{"adGroups":{"items":{"$ref":"#/components/schemas/STAdGroupCreate"},"maxItems":100,"minItems":1,"type":"array"}},"type":"object"},"STCreateAdRequest":{"properties":{"ads":{"items":{"$ref":"#/components/schemas/STAdCreate"},"maxItems":100,"minItems":1,"type":"array"}},"type":"object"},"STCreateAdvertisedProducts":{"properties":{"productId":{"description":"The identifier of the advertised product.","type":"string"},"productIdType":{"$ref":"#/components/schemas/STProductIdType"}},"required":["productIdType"],"type":"object"},"STCreateAudienceTarget":{"description":"Target based on a specified audience ID.","properties":{"audienceId":{"$ref":"#/components/schemas/STCreateMarketplaceStringValue"}},"required":["audienceId"],"type":"object"},"STCreateBudget":{"properties":{"budgetType":{"$ref":"#/components/schemas/STBudgetType"},"budgetValue":{"$ref":"#/components/schemas/STCreateBudgetValue"},"recurrenceTimePeriod":{"$ref":"#/components/schemas/STRecurrence"}},"required":["budgetType","budgetValue","recurrenceTimePeriod"],"type":"object"},"STCreateBudgetValue":{"oneOf":[{"properties":{"monetaryBudgetValue":{"$ref":"#/components/schemas/STCreateMonetaryBudgetValue"}},"required":["monetaryBudgetValue"],"type":"object"}]},"STCreateCampaignRequest":{"properties":{"campaigns":{"items":{"$ref":"#/components/schemas/STCampaignCreate"},"maxItems":100,"minItems":1,"type":"array"}},"type":"object"},"STCreateCreative":{"oneOf":[{"properties":{"videoCreative":{"$ref":"#/components/schemas/STCreateVideoCreative"}},"required":["videoCreative"],"type":"object"}]},"STCreateLocationTarget":{"description":"Target based on geographic location.","properties":{"locationId":{"description":"The ID of the geographic location to target.","type":"string"}},"required":["locationId"],"type":"object"},"STCreateMarketplaceStringValue":{"properties":{"defaultValue":{"description":"The default value. Either the default value or the marketplace settings should always be specified","type":"string"}},"type":"object"},"STCreateMonetaryBudget":{"properties":{"value":{"description":"The monetary amount of the budget cap in the given currency.","format":"double","type":"number"}},"required":["value"],"type":"object"},"STCreateMonetaryBudgetValue":{"properties":{"monetaryBudget":{"$ref":"#/components/schemas/STCreateMonetaryBudget"}},"type":"object"},"STCreateState":{"description":"The user defined state for the resource. For ADSP, campaign and ad group resources can only be created in the PAUSED state and must be updated to ENABLED to activate for delivery\n| CreateState | Description |\n| --- | --- |\n| `ENABLED` | |\n| `PAUSED` | |","enum":["ENABLED","PAUSED"],"type":"string"},"STCreateStreamingTvSettings":{"properties":{"landingPage":{"$ref":"#/components/schemas/STCreateVideoLandingPage"},"products":{"description":"The product advertised on this video creative.","items":{"$ref":"#/components/schemas/STCreateAdvertisedProducts"},"maxItems":1,"minItems":0,"type":"array"},"videos":{"$ref":"#/components/schemas/STCreateVideo"}},"required":["videos"],"type":"object"},"STCreateTargetDetails":{"oneOf":[{"properties":{"audienceTarget":{"$ref":"#/components/schemas/STCreateAudienceTarget"}},"required":["audienceTarget"],"type":"object"},{"properties":{"locationTarget":{"$ref":"#/components/schemas/STCreateLocationTarget"}},"required":["locationTarget"],"type":"object"}]},"STCreateTargetRequest":{"properties":{"targets":{"items":{"$ref":"#/components/schemas/STTargetCreate"},"maxItems":100,"minItems":1,"type":"array"}},"type":"object"},"STCreateVideo":{"properties":{"assetId":{"description":"The asset library ID associated with the video asset.","type":"string"},"assetVersion":{"description":"The asset library version associated with the video asset.","type":"string"}},"required":["assetId","assetVersion"],"type":"object"},"STCreateVideoCreative":{"properties":{"streamingTvSettings":{"$ref":"#/components/schemas/STCreateStreamingTvSettings"}},"type":"object"},"STCreateVideoLandingPage":{"properties":{"landingPageType":{"$ref":"#/components/schemas/STVideoLandingPageType"},"landingPageUrl":{"description":"The URL of landing page where the ad directs.","type":"string"}},"required":["landingPageType"],"type":"object"},"STCreative":{"oneOf":[{"properties":{"videoCreative":{"$ref":"#/components/schemas/STVideoCreative","properties":{}}},"required":["videoCreative"],"type":"object"}]},"STCreativeStatus":{"properties":{"moderationStatus":{"$ref":"#/components/schemas/STModerationStatus"}},"required":["moderationStatus"],"type":"object"},"STCurrencyCode":{"description":"| CurrencyCode | Description |\n| --- | --- |\n| `AED` | United Arab Emirates Dirham |\n| `AUD` | Australian Dollar |\n| `BRL` | Brazilian Real |\n| `CAD` | Canadian Dollar |\n| `CHF` | Swiss Franc |\n| `CNY...","enum":["AED","AUD","BRL","CAD","CHF","CNY","DKK","EUR","GBP","INR","JPY","MXN","NOK","SAR","SEK","SGD","TRY","USD"],"type":"string"},"STDeleteAdRequest":{"properties":{"adIds":{"items":{"type":"string"},"maxItems":100,"minItems":1,"type":"array"}},"type":"object"},"STDeleteTargetRequest":{"properties":{"targetIds":{"items":{"type":"string"},"maxItems":100,"minItems":1,"type":"array"}},"type":"object"},"STDeliveryReason":{"description":"| DeliveryReason | Description |\n| --- | --- |\n| `AD_CREATIVES_NOT_RUNNING` | |\n| `AD_GROUP_ARCHIVED` | |\n| `AD_GROUP_ENDED` | |\n| `AD_GROUP_PAUSED` | |\n| `AD_GROUP_PENDING_START_DATE` | |\n| `AD_...","enum":["AD_CREATIVES_NOT_RUNNING","AD_GROUPS_NOT_RUNNING","AD_GROUP_ARCHIVED","AD_GROUP_ENDED","AD_GROUP_PAUSED","AD_GROUP_PENDING_START_DATE","AD_GROUP_POLICING_SUSPENDED","AD_NOT_APPROVED_FOR_ALL_AD_GROUPS","AD_NOT_ASSOCIATED_WITH_AD_GROUP","AD_POLICING_PENDING_REVIEW","AD_POLICING_SUSPENDED","CAMPAIGN_ARCHIVED","CAMPAIGN_END_DATE_REACHED","CAMPAIGN_PAUSED","CAMPAIGN_PENDING_START_DATE","CAMPAIGN_POLICING_SUSPENDED","OTHER"],"type":"string"},"STDeliveryStatus":{"description":"| DeliveryStatus | Description |\n| --- | --- |\n| `DELIVERING` | Represents the resource is delivering.","enum":["DELIVERING","LIMITED","NOT_DELIVERING","UNAVAILABLE"],"type":"string"},"STLocationTarget":{"description":"Target based on geographic location.","properties":{"locationId":{"description":"The ID of the geographic location to target.","type":"string"},"locationIdResolved":{"description":"A human-readable location text. It's a read-only field.","type":"string"}},"required":["locationId"],"type":"object"},"STMarketplace":{"description":"A list of country codes representing Amazon marketplaces\n| Marketplace | Description |\n| --- | --- |\n| `AU` | |\n| `BR` | |\n| `CA` | |\n| `DE` | |\n| `ES` | |\n| `FR` | |\n| `GB` | |\n| `IN` | |\n| `IT` | |\n| `JP` | |\n| `MX` | |\n| `SG` | |\n| `US` | |","enum":["AU","BR","CA","DE","ES","FR","GB","IN","IT","JP","MX","SG","US"],"type":"string"},"STMarketplaceScope":{"description":"| MarketplaceScope | Description |\n| --- | --- |\n| `SINGLE_MARKETPLACE` | |","enum":["SINGLE_MARKETPLACE"],"type":"string"},"STMarketplaceStringValue":{"properties":{"defaultValue":{"description":"The default value. Either the default value or the marketplace settings should always be specified","type":"string"}},"type":"object"},"STModerationStatus":{"description":"| ModerationStatus | Description |\n| --- | --- |\n| `PUBLISHED` | The creative passed moderation and is serving. |\n| `SUBMITTED_FOR_MODERATION` | The creative has been submitted, but has not yet been reviewed. |\n| `REJECTED_BY_MODERATION` | The creative was rejected during the moderation process. |","enum":["PUBLISHED","REJECTED_BY_MODERATION","SUBMITTED_FOR_MODERATION"],"type":"string"},"STMonetaryBudget":{"properties":{"currencyCode":{"$ref":"#/components/schemas/STCurrencyCode"},"value":{"description":"The monetary amount of the budget cap in the given currency.","format":"double","type":"number"}},"required":["currencyCode","value"],"type":"object"},"STMonetaryBudgetValue":{"properties":{"monetaryBudget":{"$ref":"#/components/schemas/STMonetaryBudget"}},"type":"object"},"STProductIdType":{"description":"| ProductIdType | Description |\n| --- | --- |\n| `ASIN` | ASIN identifier type. |\n| `SKU` | SKU identifier type. |","enum":["ASIN","SKU"],"type":"string"},"STQueryAdGroupRequest":{"properties":{"adGroupIdFilter":{"$ref":"#/components/schemas/STAdGroupAdGroupIdFilter"},"adProductFilter":{"$ref":"#/components/schemas/STAdGroupAdProductFilter"},"campaignIdFilter":{"$ref":"#/components/schemas/STAdGroupCampaignIdFilter"},"maxResults":{"default":100,"format":"int32","maximum":100,"minimum":1,"type":"integer"},"nameFilter":{"$ref":"#/components/schemas/STAdGroupNameFilter"},"nextToken":{"type":"string"},"stateFilter":{"$ref":"#/components/schemas/STAdGroupStateFilter"}},"required":["adProductFilter"],"type":"object"},"STQueryAdRequest":{"properties":{"adGroupIdFilter":{"$ref":"#/components/schemas/STAdAdGroupIdFilter"},"adIdFilter":{"$ref":"#/components/schemas/STAdAdIdFilter"},"adProductFilter":{"$ref":"#/components/schemas/STAdAdProductFilter"},"campaignIdFilter":{"$ref":"#/components/schemas/STAdCampaignIdFilter"},"maxResults":{"default":100,"format":"int32","maximum":100,"minimum":1,"type":"integer"},"nextToken":{"type":"string"},"stateFilter":{"$ref":"#/components/schemas/STAdStateFilter"}},"required":["adProductFilter"],"type":"object"},"STQueryCampaignRequest":{"properties":{"adProductFilter":{"$ref":"#/components/schemas/STCampaignAdProductFilter"},"maxResults":{"default":1000,"format":"int32","maximum":1000,"minimum":1,"type":"integer"},"nextToken":{"type":"string"},"stateFilter":{"$ref":"#/components/schemas/STCampaignStateFilter"}},"required":["adProductFilter"],"type":"object"},"STQueryTargetRequest":{"properties":{"adGroupIdFilter":{"$ref":"#/components/schemas/STTargetAdGroupIdFilter"},"adProductFilter":{"$ref":"#/components/schemas/STTargetAdProductFilter"},"campaignIdFilter":{"$ref":"#/components/schemas/STTargetCampaignIdFilter"},"maxResults":{"default":100,"format":"int32","maximum":100,"minimum":1,"type":"integer"},"nextToken":{"type":"string"},"stateFilter":{"$ref":"#/components/schemas/STTargetStateFilter"},"targetIdFilter":{"$ref":"#/components/schemas/STTargetTargetIdFilter"}},"required":["adProductFilter"],"type":"object"},"STRecurrence":{"description":"| Recurrence | Description |\n| --- | --- |\n| `DAILY` | |","enum":["DAILY"],"type":"string"},"STState":{"description":"The user defined state for the resource. For ADSP, campaign and ad group resources can only be created in the PAUSED state and must be updated to ENABLED to activate for delivery\n| State | Description |\n| --- | --- |\n| `ENABLED` | |\n| `PAUSED` | |\n| `ARCHIVED` | |","enum":["ARCHIVED","ENABLED","PAUSED"],"type":"string"},"STStatus":{"properties":{"deliveryReasons":{"description":"This is the list of reasons behind the delivery status.","items":{"$ref":"#/components/schemas/STDeliveryReason","properties":{}},"maxItems":50,"minItems":0,"type":"array"},"deliveryStatus":{"$ref":"#/components/schemas/STDeliveryStatus"}},"required":["deliveryStatus"],"type":"object"},"STStreamingTvSettings":{"properties":{"landingPage":{"$ref":"#/components/schemas/STVideoLandingPage"},"moderationStatus":{"$ref":"#/components/schemas/STCreativeStatus"},"products":{"description":"The product advertised on this video creative.","items":{"$ref":"#/components/schemas/STAdvertisedProducts","properties":{}},"maxItems":1,"minItems":0,"type":"array"},"videos":{"$ref":"#/components/schemas/STVideo"}},"required":["videos"],"type":"object"},"STTarget":{"properties":{"adGroupId":{"description":"A unique identifier for the ad group associated with the target. Only used for ad-group level targets.","type":"string"},"adProduct":{"$ref":"#/components/schemas/STAdProduct"},"campaignId":{"description":"A unique identifier for the campaign associated with the target. Only used for campaign-level targets.","type":"string"},"creationDateTime":{"description":"The date time the target was created.","format":"date-time","type":"string"},"lastUpdatedDateTime":{"description":"The date time the target was last updated.","format":"date-time","type":"string"},"negative":{"description":"Indicates whether the target is negative or not.","type":"boolean"},"state":{"$ref":"#/components/schemas/STState"},"status":{"$ref":"#/components/schemas/STStatus"},"targetDetails":{"$ref":"#/components/schemas/STTargetDetails"},"targetId":{"description":"A unique identifier for the target.","type":"string"},"targetType":{"$ref":"#/components/schemas/STTargetType"}},"required":["adGroupId","adProduct","campaignId","creationDateTime","lastUpdatedDateTime","negative","state","targetDetails","targetId","targetType"],"type":"object"},"STTargetAdGroupIdFilter":{"properties":{"include":{"items":{"type":"string"},"maxItems":100,"minItems":1,"type":"array"}},"required":["include"],"type":"object"},"STTargetAdProductFilter":{"properties":{"include":{"description":"| AdProduct | Description |\n| --- | --- |\n| `SPONSORED_TELEVISION` | |","items":{"$ref":"#/components/schemas/STAdProduct"},"maxItems":1,"minItems":1,"type":"array"}},"required":["include"],"type":"object"},"STTargetCampaignIdFilter":{"properties":{"include":{"items":{"type":"string"},"maxItems":100,"minItems":1,"type":"array"}},"required":["include"],"type":"object"},"STTargetCreate":{"properties":{"adGroupId":{"description":"A unique identifier for the ad group associated with the target. Only used for ad-group level targets.","type":"string"},"adProduct":{"$ref":"#/components/schemas/STAdProduct"},"negative":{"description":"Indicates whether the target is negative or not.","type":"boolean"},"state":{"$ref":"#/components/schemas/STCreateState"},"targetDetails":{"$ref":"#/components/schemas/STCreateTargetDetails"},"targetType":{"$ref":"#/components/schemas/STTargetType"}},"required":["adGroupId","adProduct","negative","state","targetDetails","targetType"],"type":"object"},"STTargetDetails":{"oneOf":[{"properties":{"audienceTarget":{"$ref":"#/components/schemas/STAudienceTarget","properties":{}}},"required":["audienceTarget"],"type":"object"},{"properties":{"locationTarget":{"$ref":"#/components/schemas/STLocationTarget","properties":{}}},"required":["locationTarget"],"type":"object"}]},"STTargetMultiStatusResponse":{"properties":{"error":{"items":{"$ref":"#/components/schemas/ErrorsIndex","properties":{}},"maxItems":100,"minItems":0,"type":"array"},"success":{"items":{"$ref":"#/components/schemas/STTargetMultiStatusSuccess","properties":{}},"maxItems":100,"minItems":0,"type":"array"}},"type":"object"},"STTargetMultiStatusSuccess":{"properties":{"index":{"format":"int32","maximum":99,"minimum":0,"type":"integer"},"target":{"$ref":"#/components/schemas/STTarget"}},"required":["index","target"],"type":"object"},"STTargetStateFilter":{"properties":{"include":{"description":"| State | Description |\n| --- | --- |\n| `ENABLED` | |\n| `PAUSED` | |\n| `ARCHIVED` | |","items":{"$ref":"#/components/schemas/STState"},"maxItems":3,"minItems":1,"type":"array"}},"required":["include"],"type":"object"},"STTargetSuccessResponse":{"properties":{"nextToken":{"type":"string"},"targets":{"items":{"$ref":"#/components/schemas/STTarget","properties":{}},"maxItems":100,"minItems":0,"type":"array"},"totalResults":{"format":"int32","type":"integer"}},"type":"object"},"STTargetTargetIdFilter":{"properties":{"include":{"items":{"type":"string"},"maxItems":100,"minItems":1,"type":"array"}},"required":["include"],"type":"object"},"STTargetType":{"description":"| TargetType | Description |\n| --- | --- |\n| `AUDIENCE` | |\n| `LOCATION` | |","enum":["AUDIENCE","LOCATION"],"type":"string"},"STTargetUpdate":{"properties":{"state":{"$ref":"#/components/schemas/STUpdateState"},"targetId":{"description":"A unique identifier for the target.","type":"string"}},"required":["targetId"],"type":"object"},"STUpdateAdGroupBid":{"properties":{"baseBid":{"description":"The lower bound bid used for the ads in the ad group.","format":"double","type":"number"},"defaultBid":{"description":"The default maximum bid for ads and targets in the ad group. This is used in sponsored ads as the maximum bid during the auction.","format":"double","type":"number"}},"type":"object"},"STUpdateAdGroupRequest":{"properties":{"adGroups":{"items":{"$ref":"#/components/schemas/STAdGroupUpdate"},"maxItems":100,"minItems":1,"type":"array"}},"type":"object"},"STUpdateAdRequest":{"properties":{"ads":{"items":{"$ref":"#/components/schemas/STAdUpdate"},"maxItems":100,"minItems":1,"type":"array"}},"type":"object"},"STUpdateCampaignRequest":{"properties":{"campaigns":{"items":{"$ref":"#/components/schemas/STCampaignUpdate"},"maxItems":5,"minItems":1,"type":"array"}},"type":"object"},"STUpdateCreative":{"oneOf":[{"properties":{"videoCreative":{"$ref":"#/components/schemas/STUpdateVideoCreative"}},"required":["videoCreative"],"type":"object"}]},"STUpdateState":{"description":"The user defined state for the resource. For ADSP, campaign and ad group resources can only be created in the PAUSED state and must be updated to ENABLED to activate for delivery\n| UpdateState | Description |\n| --- | --- |\n| `ENABLED` | |\n| `PAUSED` | |","enum":["ENABLED","PAUSED"],"type":"string"},"STUpdateStreamingTvSettings":{"properties":{"videos":{"$ref":"#/components/schemas/STUpdateVideo"}},"type":"object"},"STUpdateTargetRequest":{"properties":{"targets":{"items":{"$ref":"#/components/schemas/STTargetUpdate"},"maxItems":100,"minItems":1,"type":"array"}},"type":"object"},"STUpdateVideo":{"properties":{"assetId":{"description":"The asset library ID associated with the video asset.","type":"string"},"assetVersion":{"description":"The asset library version associated with the video asset.","type":"string"}},"type":"object"},"STUpdateVideoCreative":{"properties":{"streamingTvSettings":{"$ref":"#/components/schemas/STUpdateStreamingTvSettings"}},"type":"object"},"STVideo":{"properties":{"assetId":{"description":"The asset library ID associated with the video asset.","type":"string"},"assetVersion":{"description":"The asset library version associated with the video asset.","type":"string"}},"required":["assetId","assetVersion"],"type":"object"},"STVideoCreative":{"properties":{"streamingTvSettings":{"$ref":"#/components/schemas/STStreamingTvSettings"}},"type":"object"},"STVideoLandingPage":{"properties":{"landingPageType":{"$ref":"#/components/schemas/STVideoLandingPageType"},"landingPageUrl":{"description":"The URL of landing page where the ad directs.","type":"string"}},"required":["landingPageType"],"type":"object"},"STVideoLandingPageType":{"description":"| VideoLandingPageType | Description |\n| --- | --- |\n| `STORE` | A brand Store landing page. |\n| `OFF_AMAZON_LINK` | An off-Amazon landing page. |","enum":["OFF_AMAZON_LINK","STORE"],"type":"string"},"ServiceUnavailableErrorResponseContent":{"properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"type":"object"},"TooManyRequestsResponseContent":{"properties":{"code":{"$ref":"#/components/schemas/ErrorCode"},"message":{"type":"string"}},"required":["code","message"],"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":{"title":"Amazon Ads API ST","version":"3.0"},"openapi":"3.0.1","paths":{"/adsApi/v1/create/adGroups":{"post":{"description":"Create ad groups\n\n**Requires one of these permissions**:\n[\"advertiser_campaign_edit\", \"campaign_edit\", \"dsp_campaign_edit\"]","operationId":"STCreateAdGroup","parameters":[{"$ref":"#/components/parameters/AccountIdHeaderOptional"},{"$ref":"#/components/parameters/ClientIdHeader"},{"$ref":"#/components/parameters/ScopeHeaderOptional"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/STCreateAdGroupRequest"}}}},"responses":{"207":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/STAdGroupMultiStatusResponse"}}},"description":"STCreateAdGroup 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":["AdGroups"]}},"/adsApi/v1/create/ads":{"post":{"description":"Create ads\n\n**Requires one of these permissions**:\n[\"advertiser_campaign_edit\"]","operationId":"STCreateAd","parameters":[{"$ref":"#/components/parameters/ClientIdHeader"},{"$ref":"#/components/parameters/ScopeHeader"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/STCreateAdRequest"}}}},"responses":{"207":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/STAdMultiStatusResponse"}}},"description":"STCreateAd 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":["Ads"]}},"/adsApi/v1/create/campaigns":{"post":{"description":"Create campaigns\n\n**Requires one of these permissions**:\n[\"advertiser_campaign_edit\", \"campaign_edit\", \"dsp_campaign_edit\"]","operationId":"STCreateCampaign","parameters":[{"$ref":"#/components/parameters/AccountIdHeaderOptional"},{"$ref":"#/components/parameters/ClientIdHeader"},{"$ref":"#/components/parameters/ScopeHeaderOptional"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/STCreateCampaignRequest"}}}},"responses":{"207":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/STCampaignMultiStatusResponse"}}},"description":"STCreateCampaign 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":["Campaigns"]}},"/adsApi/v1/create/targets":{"post":{"description":"Create target\n\n**Requires one of these permissions**:\n[\"advertiser_campaign_edit\", \"campaign_edit\", \"dsp_campaign_edit\"]","operationId":"STCreateTarget","parameters":[{"$ref":"#/components/parameters/AccountIdHeaderOptional"},{"$ref":"#/components/parameters/ClientIdHeader"},{"$ref":"#/components/parameters/ScopeHeaderOptional"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/STCreateTargetRequest"}}}},"responses":{"207":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/STTargetMultiStatusResponse"}}},"description":"STCreateTarget 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":["Targets"]}},"/adsApi/v1/delete/ads":{"post":{"description":"Delete ads\n\n**Requires one of these permissions**:\n[\"advertiser_campaign_edit\"]","operationId":"STDeleteAd","parameters":[{"$ref":"#/components/parameters/ClientIdHeader"},{"$ref":"#/components/parameters/ScopeHeader"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/STDeleteAdRequest"}}}},"responses":{"207":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/STAdMultiStatusResponse"}}},"description":"STDeleteAd 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":["Ads"]}},"/adsApi/v1/delete/targets":{"post":{"description":"Delete target\n\n**Requires one of these permissions**:\n[\"advertiser_campaign_edit\", \"campaign_edit\", \"dsp_campaign_edit\"]","operationId":"STDeleteTarget","parameters":[{"$ref":"#/components/parameters/AccountIdHeaderOptional"},{"$ref":"#/components/parameters/ClientIdHeader"},{"$ref":"#/components/parameters/ScopeHeaderOptional"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/STDeleteTargetRequest"}}}},"responses":{"207":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/STTargetMultiStatusResponse"}}},"description":"STDeleteTarget 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":["Targets"]}},"/adsApi/v1/query/adGroups":{"post":{"description":"List ad groups\n\n**Requires one of these permissions**:\n[\"advertiser_campaign_edit\", \"dsp_campaign_view\", \"campaign_view\", \n\"advertiser_campaign_view\"]","operationId":"STQueryAdGroup","parameters":[{"$ref":"#/components/parameters/AccountIdHeaderOptional"},{"$ref":"#/components/parameters/ClientIdHeader"},{"$ref":"#/components/parameters/ScopeHeaderOptional"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/STQueryAdGroupRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/STAdGroupSuccessResponse"}}},"description":"STQueryAdGroup 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":["AdGroups"]}},"/adsApi/v1/query/ads":{"post":{"description":"List ads\n\n**Requires one of these permissions**:\n[\"advertiser_campaign_edit\",\"advertiser_campaign_view\"]","operationId":"STQueryAd","parameters":[{"$ref":"#/components/parameters/ClientIdHeader"},{"$ref":"#/components/parameters/ScopeHeader"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/STQueryAdRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/STAdSuccessResponse"}}},"description":"STQueryAd 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":["Ads"]}},"/adsApi/v1/query/campaigns":{"post":{"description":"Query campaign\n\n**Requires one of these permissions**:\n[]","operationId":"STQueryCampaign","parameters":[{"$ref":"#/components/parameters/ClientIdHeader"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/STQueryCampaignRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/STCampaignSuccessResponse"}}},"description":"STQueryCampaign 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":["Campaigns"]}},"/adsApi/v1/query/targets":{"post":{"description":"List target\n\n**Requires one of these permissions**:\n[\"advertiser_campaign_edit\", \"dsp_campaign_view\", \"campaign_view\", \n\"advertiser_campaign_view\", \"campaign_edit\", \"dsp_campaign_edit\"]","operationId":"STQueryTarget","parameters":[{"$ref":"#/components/parameters/AccountIdHeaderOptional"},{"$ref":"#/components/parameters/ClientIdHeader"},{"$ref":"#/components/parameters/ScopeHeaderOptional"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/STQueryTargetRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/STTargetSuccessResponse"}}},"description":"STQueryTarget 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":["Targets"]}},"/adsApi/v1/update/adGroups":{"post":{"description":"Update ad groups\n\n**Requires one of these permissions**:\n[\"advertiser_campaign_edit\", \"campaign_edit\", \"dsp_campaign_edit\"]","operationId":"STUpdateAdGroup","parameters":[{"$ref":"#/components/parameters/AccountIdHeaderOptional"},{"$ref":"#/components/parameters/ClientIdHeader"},{"$ref":"#/components/parameters/ScopeHeaderOptional"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/STUpdateAdGroupRequest"}}}},"responses":{"207":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/STAdGroupMultiStatusResponse"}}},"description":"STUpdateAdGroup 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":["AdGroups"]}},"/adsApi/v1/update/ads":{"post":{"description":"Update ads\n\n**Requires one of these permissions**:\n[\"advertiser_campaign_edit\"]","operationId":"STUpdateAd","parameters":[{"$ref":"#/components/parameters/ClientIdHeader"},{"$ref":"#/components/parameters/ScopeHeader"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/STUpdateAdRequest"}}}},"responses":{"207":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/STAdMultiStatusResponse"}}},"description":"STUpdateAd 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":["Ads"]}},"/adsApi/v1/update/campaigns":{"post":{"description":"Update campaign\n\n**Requires one of these permissions**:\n[]","operationId":"STUpdateCampaign","parameters":[{"$ref":"#/components/parameters/ClientIdHeader"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/STUpdateCampaignRequest"}}}},"responses":{"207":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/STCampaignMultiStatusResponse"}}},"description":"STUpdateCampaign 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":["Campaigns"]}},"/adsApi/v1/update/targets":{"post":{"description":"Update target\n\n**Requires one of these permissions**:\n[\"advertiser_campaign_edit\"]","operationId":"STUpdateTarget","parameters":[{"$ref":"#/components/parameters/AccountIdHeaderOptional"},{"$ref":"#/components/parameters/ClientIdHeader"},{"$ref":"#/components/parameters/ScopeHeaderOptional"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/STUpdateTargetRequest"}}}},"responses":{"207":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/STTargetMultiStatusResponse"}}},"description":"STUpdateTarget 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":["Targets"]}}},"servers":[{"url":"https://advertising-api.amazon.com"}]}