{"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"}},"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"}},"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","enum":["AMAZON_DSP"],"type":"string"},"AdvertisingDeal":{"properties":{"adProduct":{"$ref":"#/components/schemas/AdProduct"},"advertisingDealId":{"description":"A unique identifier generated by ADSP for a deal. This is not the same as the identifier provided by an exchange/SSP for a deal.","type":"string"},"creationDateTime":{"description":"The date time that the deal was created.","format":"date-time","type":"string"},"creativeRequirements":{"$ref":"#/components/schemas/CreativeRequirements"},"customPublisherDescription":{"description":"Custom description of the publisher providing inventory for this deal.","type":"string"},"dealType":{"$ref":"#/components/schemas/AdvertisingDealType"},"endDateTime":{"description":"The end date time for the deal.","format":"date-time","type":"string"},"exchangeDealId":{"description":"An identifier provided by an exchange/SSP for a deal. This is the deal ID visible in the ADSP UI and used by exchanges/SSPs when communicating with advertisers.","type":"string"},"exchangeId":{"description":"The exchange/SSP that provides the deal.","type":"string"},"name":{"description":"The name of the deal.","type":"string"},"startDateTime":{"description":"The start date time for the deal.","format":"date-time","type":"string"},"status":{"$ref":"#/components/schemas/AdvertisingDealStatus"},"supplyInventoryTypes":{"description":"The inventory type of the deal declared by the supplier. Use this field to find deals compatible with an ad group. For a DISPLAY ad group, query deals with supplyInventoryType DISPLAY. For a STREAMING_TV or ONLINE_VIDEO ad group, query deals with supplyInventoryType VIDEO. For an AUDIO or PODCAST ad group, query deals with supplyInventoryType AUDIO. Deals with an empty supplyInventoryTypes list have no inventory type restriction.","items":{"$ref":"#/components/schemas/SupplyInventoryType"},"maxItems":3,"minItems":0,"type":"array"},"supplyMetadata":{"$ref":"#/components/schemas/SupplyMetadata"},"terms":{"$ref":"#/components/schemas/AdvertisingDealTerms"}},"required":["adProduct","advertisingDealId","creationDateTime","dealType","endDateTime","name","startDateTime","status"],"type":"object"},"AdvertisingDealAdProductFilter":{"properties":{"include":{"description":"**AdProduct Enum:**\n| AdProduct | Description |\n| --- | --- |\n| `AMAZON_DSP` | Amazon Demand-Side Platform ad product. |","items":{"$ref":"#/components/schemas/AdProduct"},"maxItems":1,"minItems":1,"type":"array"}},"required":["include"],"type":"object"},"AdvertisingDealAdvertisingDealIdFilter":{"properties":{"include":{"items":{"type":"string"},"maxItems":1000,"minItems":1,"type":"array"}},"required":["include"],"type":"object"},"AdvertisingDealAdvertisingDealPriceTypeFilter":{"properties":{"include":{"description":"**PriceType Enum:**\n| PriceType | Description |\n| --- | --- |\n| `FIXED_PRICE` | Sale price for a specific ad placement regardless of auction performance. |\n| `FIXED_CPM` | Fixed cost per thousand impressions. Buyer pays this exact CPM for every impression won. Used for PREFERRED and PROGRAMMATIC_GUARANTEED deals. |\n| `FLOOR_RATE` | Minimum bid price for auction. Buyer must bid at or above this floor to compete. Used for PRIVATE_AUCTION deals. |","items":{"$ref":"#/components/schemas/AdvertisingDealPriceType"},"maxItems":10,"minItems":1,"type":"array"}},"required":["include"],"type":"object"},"AdvertisingDealAdvertisingDealTypeFilter":{"properties":{"include":{"items":{"$ref":"#/components/schemas/AdvertisingDealType"},"maxItems":10,"minItems":1,"type":"array"}},"required":["include"],"type":"object"},"AdvertisingDealBroadcastersFilter":{"properties":{"include":{"items":{"type":"string"},"maxItems":100,"minItems":1,"type":"array"}},"required":["include"],"type":"object"},"AdvertisingDealCountryCodeFilter":{"properties":{"include":{"items":{"$ref":"#/components/schemas/CountryCode"},"maxItems":1,"minItems":1,"type":"array"}},"required":["include"],"type":"object"},"AdvertisingDealCreate":{"properties":{"adProduct":{"$ref":"#/components/schemas/AdProduct"},"creativeRequirements":{"$ref":"#/components/schemas/CreateCreativeRequirements"},"customPublisherDescription":{"description":"Custom description of the publisher providing inventory for this deal.","type":"string"},"dealType":{"$ref":"#/components/schemas/AdvertisingDealType"},"endDateTime":{"description":"The end date time for the deal.","format":"date-time","type":"string"},"exchangeDealId":{"description":"An identifier provided by an exchange/SSP for a deal. This is the deal ID visible in the ADSP UI and used by exchanges/SSPs when communicating with advertisers.","type":"string"},"exchangeId":{"description":"The exchange/SSP that provides the deal.","type":"string"},"name":{"description":"The name of the deal.","type":"string"},"startDateTime":{"description":"The start date time for the deal.","format":"date-time","type":"string"},"terms":{"$ref":"#/components/schemas/CreateAdvertisingDealTerms"}},"required":["adProduct","dealType","endDateTime","name","startDateTime"],"type":"object"},"AdvertisingDealCreationDateTimeRangeFilter":{"properties":{"include":{"items":{"$ref":"#/components/schemas/DateTimeRange"},"maxItems":1,"minItems":1,"type":"array"}},"required":["include"],"type":"object"},"AdvertisingDealEndDateTimeRangeFilter":{"properties":{"include":{"items":{"$ref":"#/components/schemas/DateTimeRange"},"maxItems":1,"minItems":1,"type":"array"}},"required":["include"],"type":"object"},"AdvertisingDealExchangeDealIdFilter":{"properties":{"include":{"items":{"type":"string"},"maxItems":1000,"minItems":1,"type":"array"}},"required":["include"],"type":"object"},"AdvertisingDealExchangeIdFilter":{"properties":{"include":{"items":{"type":"string"},"maxItems":1000,"minItems":1,"type":"array"}},"required":["include"],"type":"object"},"AdvertisingDealLeaguesFilter":{"properties":{"include":{"items":{"type":"string"},"maxItems":100,"minItems":1,"type":"array"}},"required":["include"],"type":"object"},"AdvertisingDealMarketplaceDealFilter":{"properties":{"include":{"items":{"type":"boolean"},"maxItems":1,"minItems":1,"type":"array"}},"required":["include"],"type":"object"},"AdvertisingDealMultiStatusResponse":{"properties":{"error":{"items":{"$ref":"#/components/schemas/ErrorsIndex"},"maxItems":10,"minItems":0,"type":"array"},"success":{"items":{"$ref":"#/components/schemas/AdvertisingDealMultiStatusSuccess"},"maxItems":10,"minItems":0,"type":"array"}},"type":"object"},"AdvertisingDealMultiStatusSuccess":{"properties":{"advertisingDeal":{"$ref":"#/components/schemas/AdvertisingDeal"},"index":{"format":"int32","maximum":9,"minimum":0,"type":"integer"}},"required":["advertisingDeal","index"],"type":"object"},"AdvertisingDealNameFilter":{"properties":{"include":{"items":{"type":"string"},"maxItems":1,"minItems":1,"type":"array"},"queryTermMatchType":{"$ref":"#/components/schemas/AdvertisingDealNameFilterType"}},"required":["include","queryTermMatchType"],"type":"object"},"AdvertisingDealNameFilterType":{"description":"**AdvertisingDealNameFilterType Enum:**\n| AdvertisingDealNameFilterType | Description |\n| --- | --- |\n| `EXACT_MATCH` | Filter by exact match. |","enum":["EXACT_MATCH"],"type":"string"},"AdvertisingDealPrice":{"properties":{"currencyCode":{"$ref":"#/components/schemas/CurrencyCode"},"priceType":{"$ref":"#/components/schemas/AdvertisingDealPriceType"},"value":{"description":"The monetary amount of the price in the given currency.","format":"double","type":"number"}},"required":["currencyCode","priceType","value"],"type":"object"},"AdvertisingDealPriceRangeFilter":{"properties":{"include":{"items":{"$ref":"#/components/schemas/MonetaryRange"},"maxItems":1,"minItems":1,"type":"array"}},"required":["include"],"type":"object"},"AdvertisingDealPriceType":{"description":"**AdvertisingDealPriceType Enum:**\n\n| AdvertisingDealPriceType | Description |\n|------|------|\n| `FIXED_CPM` | Fixed cost per thousand impressions. Buyer pays this exact CPM for every impression won. Used for PREFERRED and PROGRAMMATIC_GUARANTEED deals. |\n| `FIXED_PRICE` | Sale price for a specific ad placement regardless of auction performance. |\n| `FLOOR_RATE` | Minimum bid price for auction. Buyer must bid at or above this floor to compete. Used for PRIVATE_AUCTION deals. |\n","enum":["FIXED_CPM","FIXED_PRICE","FLOOR_RATE"],"type":"string"},"AdvertisingDealSortOption":{"properties":{"by":{"$ref":"#/components/schemas/AdvertisingDealSortOptionsFields"},"direction":{"$ref":"#/components/schemas/SortDirection"}},"required":["by"],"type":"object"},"AdvertisingDealSortOptionsFields":{"description":"Specify which field to order by.\n| Field Name | Supported Ordering |\n| --- | --- |\n| advertisingDealId | ASCENDING,DESCENDING |\n| creationDateTime | ASCENDING,DESCENDING |\n| dealType | ASCENDING,DESCENDING |\n| endDateTime | ASCENDING,DESCENDING |\n| exchangeDealId | ASCENDING,DESCENDING |\n| name | ASCENDING,DESCENDING |\n| price | ASCENDING,DESCENDING |\n| startDateTime | ASCENDING,DESCENDING |","enum":["advertisingDealId","creationDateTime","dealType","endDateTime","exchangeDealId","name","price","startDateTime"],"type":"string"},"AdvertisingDealSportsFilter":{"properties":{"include":{"items":{"type":"string"},"maxItems":100,"minItems":1,"type":"array"}},"required":["include"],"type":"object"},"AdvertisingDealStartDateTimeRangeFilter":{"properties":{"include":{"items":{"$ref":"#/components/schemas/DateTimeRange"},"maxItems":1,"minItems":1,"type":"array"}},"required":["include"],"type":"object"},"AdvertisingDealStatus":{"properties":{"status":{"$ref":"#/components/schemas/AdvertisingDealStatusEnum"}},"required":["status"],"type":"object"},"AdvertisingDealStatusEnum":{"description":"**AdvertisingDealStatusEnum Enum:**\n\n| AdvertisingDealStatusEnum | Description |\n|------|------|\n| `ACTIVE` | Deal is ready to serve from SSP perspective. SSP will send bid requests for this deal (subject to dates and other validations). |\n| `ENDED` | Deal has passed its end date and is no longer active. |\n| `PAUSED` | Deal is temporarily paused from SSP perspective. SSP will not send bid requests for this deal, regardless of dates. |\n| `SCHEDULED` | Deal is approved and scheduled but has not yet reached its start date. |\n","enum":["ACTIVE","ENDED","PAUSED","SCHEDULED"],"type":"string"},"AdvertisingDealStatusFilter":{"properties":{"include":{"items":{"$ref":"#/components/schemas/AdvertisingDealStatus"},"maxItems":10,"minItems":1,"type":"array"}},"required":["include"],"type":"object"},"AdvertisingDealSuccessResponse":{"properties":{"advertisingDeals":{"items":{"$ref":"#/components/schemas/AdvertisingDeal"},"maxItems":10000,"minItems":0,"type":"array"},"nextToken":{"type":"string"},"totalResults":{"format":"int32","type":"integer"}},"type":"object"},"AdvertisingDealSupplyInventoryTypeFilter":{"properties":{"include":{"items":{"$ref":"#/components/schemas/SupplyInventoryType"},"maxItems":3,"minItems":1,"type":"array"}},"required":["include"],"type":"object"},"AdvertisingDealTerms":{"description":"Terms for a deal. Supports PA \u0026 PD deals along with both spend-based guarantees (standard PG) and share-of-voice based guarantees (PG-SOV).","properties":{"budget":{"$ref":"#/components/schemas/MonetaryBudget"},"guaranteed":{"description":"If true, deal is PG Deal.","type":"boolean"},"marketplaceDeal":{"description":"If true, deal is available to all Amazon DSP entities globally. Marketplace deals cannot be edited by individual buyers.","type":"boolean"},"price":{"$ref":"#/components/schemas/AdvertisingDealPrice"},"shareOfVoicePercentage":{"description":"Guaranteed Share-of-voice Percentage of the advertising deal. Used for SOV-based PG deals. Value must be \u003e 0 and \u003c\u003d 100. Mutually exclusive with budget.","format":"double","type":"number"}},"required":["guaranteed","marketplaceDeal","price"],"type":"object"},"AdvertisingDealType":{"enum":["PREFERRED","PRIVATE_AUCTION","PROGRAMMATIC_GUARANTEED"],"type":"string"},"AdvertisingDealUpdate":{"properties":{"advertisingDealId":{"description":"A unique identifier generated by ADSP for a deal. This is not the same as the identifier provided by an exchange/SSP for a deal.","type":"string"},"creativeRequirements":{"$ref":"#/components/schemas/UpdateCreativeRequirements"},"customPublisherDescription":{"description":"Custom description of the publisher providing inventory for this deal.","type":"string"},"dealType":{"$ref":"#/components/schemas/AdvertisingDealType"},"endDateTime":{"description":"The end date time for the deal.","format":"date-time","type":"string"},"name":{"description":"The name of the deal.","type":"string"},"startDateTime":{"description":"The start date time for the deal.","format":"date-time","type":"string"},"terms":{"$ref":"#/components/schemas/UpdateAdvertisingDealTerms"}},"required":["advertisingDealId"],"type":"object"},"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"},"CountryCode":{"enum":["IN"],"type":"string"},"CreateAdvertisingDealPrice":{"properties":{"currencyCode":{"$ref":"#/components/schemas/CurrencyCode"},"priceType":{"$ref":"#/components/schemas/AdvertisingDealPriceType"},"value":{"description":"The monetary amount of the price in the given currency.","format":"double","type":"number"}},"required":["currencyCode","priceType","value"],"type":"object"},"CreateAdvertisingDealRequest":{"properties":{"advertisingDeals":{"items":{"$ref":"#/components/schemas/AdvertisingDealCreate"},"maxItems":10,"minItems":1,"type":"array"}},"required":["advertisingDeals"],"type":"object"},"CreateAdvertisingDealTerms":{"description":"Terms for a deal. Supports PA \u0026 PD deals along with both spend-based guarantees (standard PG) and share-of-voice based guarantees (PG-SOV).","properties":{"budget":{"$ref":"#/components/schemas/CreateMonetaryBudget"},"price":{"$ref":"#/components/schemas/CreateAdvertisingDealPrice"}},"required":["price"],"type":"object"},"CreateCreativeRequirements":{"description":"Creative requirements associated with the deal.","type":"object"},"CreateMonetaryBudget":{"properties":{"currencyCode":{"$ref":"#/components/schemas/CurrencyCode"},"value":{"description":"The monetary amount of the budget cap in the given currency.","format":"double","type":"number"}},"required":["currencyCode","value"],"type":"object"},"CreativeRequirements":{"description":"Creative requirements associated with the deal.","properties":{"creativeSource":{"$ref":"#/components/schemas/CreativeSource"}},"type":"object"},"CreativeSource":{"description":"**CreativeSource Enum:**\n\n| CreativeSource | Description |\n|------|------|\n| `ADVERTISER` | Creative is provided by the demand side (standard flow). |\n| `PUBLISHER` | Creative is hosted by the publisher\u0027s ad server (e.g., Google Ad Manager). |\n","enum":["ADVERTISER","PUBLISHER"],"type":"string"},"CurrencyCode":{"description":"**CurrencyCode Enum:**\n\n| 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` | Chinese Yuan |\n| `DKK` | Danish Krone |\n| `EUR` | Euro |\n| `GBP` | British Pound Sterling |\n| `INR` | Indian Rupee |\n| `JPY` | Japanese Yen |\n| `MXN` | Mexican Peso |\n| `NOK` | Norwegian Krone |\n| `NZD` | New Zealand Dollar |\n| `SAR` | Saudi Riyal |\n| `SEK` | Swedish Krona |\n| `SGD` | Singapore Dollar |\n| `TRY` | Turkish Lira |\n| `USD` | United States Dollar |\n","enum":["AED","AUD","BRL","CAD","CHF","CNY","DKK","EUR","GBP","INR","JPY","MXN","NOK","NZD","SAR","SEK","SGD","TRY","USD"],"type":"string"},"DateTimeRange":{"description":"A date-time range with optional inclusive min and max bounds.","properties":{"max":{"description":"The maximum (inclusive) date time of the range.","format":"date-time","type":"string"},"min":{"description":"The minimum (inclusive) date time of the range.","format":"date-time","type":"string"}},"type":"object"},"Error":{"properties":{"code":{"$ref":"#/components/schemas/ErrorCode"},"fieldLocation":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"type":"object"},"ErrorCode":{"description":"**ErrorCode Enum:**\n\n| 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| `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","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":9,"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"},"MonetaryBudget":{"properties":{"currencyCode":{"$ref":"#/components/schemas/CurrencyCode"},"value":{"description":"The monetary amount of the budget cap in the given currency.","format":"double","type":"number"}},"required":["currencyCode","value"],"type":"object"},"MonetaryRange":{"description":"A monetary range with optional inclusive min and max bounds and a required currency code.","properties":{"currencyCode":{"$ref":"#/components/schemas/CurrencyCode"},"max":{"description":"The maximum (inclusive) monetary value of the range.","format":"double","type":"number"},"min":{"description":"The minimum (inclusive) monetary value of the range.","format":"double","type":"number"}},"required":["currencyCode"],"type":"object"},"NotFoundResponseContent":{"properties":{"code":{"$ref":"#/components/schemas/ErrorCode"},"message":{"type":"string"}},"required":["code","message"],"type":"object"},"QueryAdvertisingDealRequest":{"properties":{"adProductFilter":{"$ref":"#/components/schemas/AdvertisingDealAdProductFilter"},"advertisingDealIdFilter":{"$ref":"#/components/schemas/AdvertisingDealAdvertisingDealIdFilter"},"broadcastersFilter":{"$ref":"#/components/schemas/AdvertisingDealBroadcastersFilter"},"countryCodeFilter":{"$ref":"#/components/schemas/AdvertisingDealCountryCodeFilter"},"creationDateTimeRangeFilter":{"$ref":"#/components/schemas/AdvertisingDealCreationDateTimeRangeFilter"},"dealTypeFilter":{"$ref":"#/components/schemas/AdvertisingDealAdvertisingDealTypeFilter"},"endDateTimeRangeFilter":{"$ref":"#/components/schemas/AdvertisingDealEndDateTimeRangeFilter"},"exchangeDealIdFilter":{"$ref":"#/components/schemas/AdvertisingDealExchangeDealIdFilter"},"exchangeIdFilter":{"$ref":"#/components/schemas/AdvertisingDealExchangeIdFilter"},"leaguesFilter":{"$ref":"#/components/schemas/AdvertisingDealLeaguesFilter"},"marketplaceDealFilter":{"$ref":"#/components/schemas/AdvertisingDealMarketplaceDealFilter"},"maxResults":{"default":1000,"format":"int32","maximum":10000,"minimum":1,"type":"integer"},"nameFilter":{"$ref":"#/components/schemas/AdvertisingDealNameFilter"},"nextToken":{"type":"string"},"priceRangeFilter":{"$ref":"#/components/schemas/AdvertisingDealPriceRangeFilter"},"priceTypeFilter":{"$ref":"#/components/schemas/AdvertisingDealAdvertisingDealPriceTypeFilter"},"sort":{"items":{"$ref":"#/components/schemas/AdvertisingDealSortOption"},"maxItems":8,"minItems":0,"type":"array"},"sportsFilter":{"$ref":"#/components/schemas/AdvertisingDealSportsFilter"},"startDateTimeRangeFilter":{"$ref":"#/components/schemas/AdvertisingDealStartDateTimeRangeFilter"},"statusFilter":{"$ref":"#/components/schemas/AdvertisingDealStatusFilter"},"supplyInventoryTypesFilter":{"$ref":"#/components/schemas/AdvertisingDealSupplyInventoryTypeFilter"}},"required":["adProductFilter"],"type":"object"},"SBAdvertisingDeal":{"properties":{"advertisingDealId":{"description":"A unique identifier for a deal.","type":"string"},"endDateTime":{"description":"The end date time for the deal.","format":"date-time","type":"string"},"name":{"description":"The name of the deal.","type":"string"},"price":{"$ref":"#/components/schemas/SBAdvertisingDealPrice"},"replacingDealId":{"description":"The ID of an advertising deal that this deal intends to replace.","type":"string"},"startDateTime":{"description":"The start date time for the deal.","format":"date-time","type":"string"},"state":{"$ref":"#/components/schemas/SBAdvertisingDealState"},"status":{"$ref":"#/components/schemas/SBAdvertisingDealStatus"}},"required":["advertisingDealId","endDateTime","name","startDateTime","status"],"type":"object"},"SBAdvertisingDealAdvertisingDealIdFilter":{"properties":{"include":{"items":{"type":"string"},"maxItems":10,"minItems":1,"type":"array"}},"required":["include"],"type":"object"},"SBAdvertisingDealCreate":{"properties":{"endDateTime":{"description":"The end date time for the deal.","format":"date-time","type":"string"},"name":{"description":"The name of the deal.","type":"string"},"price":{"$ref":"#/components/schemas/SBCreateAdvertisingDealPrice"},"replacingDealId":{"description":"The ID of an advertising deal that this deal intends to replace.","type":"string"},"startDateTime":{"description":"The start date time for the deal.","format":"date-time","type":"string"},"state":{"$ref":"#/components/schemas/SBAdvertisingDealState"}},"required":["endDateTime","name","startDateTime"],"type":"object"},"SBAdvertisingDealMultiStatusResponse":{"properties":{"error":{"items":{"$ref":"#/components/schemas/ErrorsIndex"},"maxItems":10,"minItems":0,"type":"array"},"success":{"items":{"$ref":"#/components/schemas/SBAdvertisingDealMultiStatusSuccess"},"maxItems":10,"minItems":0,"type":"array"}},"type":"object"},"SBAdvertisingDealMultiStatusSuccess":{"properties":{"advertisingDeal":{"$ref":"#/components/schemas/SBAdvertisingDeal"},"index":{"format":"int32","maximum":9,"minimum":0,"type":"integer"}},"required":["advertisingDeal","index"],"type":"object"},"SBAdvertisingDealNameFilter":{"properties":{"include":{"items":{"type":"string"},"maxItems":10,"minItems":1,"type":"array"},"queryTermMatchType":{"$ref":"#/components/schemas/SBAdvertisingDealNameFilterType"}},"required":["include","queryTermMatchType"],"type":"object"},"SBAdvertisingDealNameFilterType":{"description":"| AdvertisingDealNameFilterType | Description |\n|------|------|\n| `BROAD_MATCH` | Filter by broad match. |\n| `EXACT_MATCH` | Filter by exact match. |\n","enum":["BROAD_MATCH","EXACT_MATCH"],"type":"string"},"SBAdvertisingDealPrice":{"properties":{"currencyCode":{"$ref":"#/components/schemas/SBCurrencyCode"},"priceType":{"$ref":"#/components/schemas/SBAdvertisingDealPriceType"},"value":{"description":"The monetary amount of the price in the given currency.","format":"double","type":"number"}},"required":["currencyCode","priceType","value"],"type":"object"},"SBAdvertisingDealPriceType":{"description":"| AdvertisingDealPriceType | Description |\n|------|------|\n| `FIXED_PRICE` | Sale price for a specific ad placement regardless of auction performance. |\n","enum":["FIXED_PRICE"],"type":"string"},"SBAdvertisingDealState":{"description":"| AdvertisingDealState | Description |\n|------|------|\n| `DRAFT` |  |\n| `PROPOSED` |  |\n","enum":["DRAFT","PROPOSED"],"type":"string"},"SBAdvertisingDealStatus":{"properties":{"status":{"$ref":"#/components/schemas/SBAdvertisingDealStatusEnum"}},"required":["status"],"type":"object"},"SBAdvertisingDealStatusEnum":{"description":"| AdvertisingDealStatusEnum | Description |\n|------|------|\n| `DRAFT` | The deal has not been submitted yet. |\n| `MODERATION_APPROVED` | The deal has passed moderation. |\n| `PROPOSED` | The deal has been submitted for moderation. |\n","enum":["DRAFT","MODERATION_APPROVED","PROPOSED"],"type":"string"},"SBAdvertisingDealSuccessResponse":{"properties":{"advertisingDeals":{"items":{"$ref":"#/components/schemas/SBAdvertisingDeal"},"maxItems":50,"minItems":0,"type":"array"},"nextToken":{"type":"string"}},"type":"object"},"SBAdvertisingDealUpdate":{"properties":{"advertisingDealId":{"description":"A unique identifier for a deal.","type":"string"},"endDateTime":{"description":"The end date time for the deal.","format":"date-time","type":"string"},"name":{"description":"The name of the deal.","type":"string"},"price":{"$ref":"#/components/schemas/SBUpdateAdvertisingDealPrice"},"replacingDealId":{"description":"The ID of an advertising deal that this deal intends to replace.","nullable":true,"type":"string"},"startDateTime":{"description":"The start date time for the deal.","format":"date-time","type":"string"},"state":{"$ref":"#/components/schemas/SBAdvertisingDealState"}},"required":["advertisingDealId"],"type":"object"},"SBCreateAdvertisingDealPrice":{"properties":{"priceType":{"$ref":"#/components/schemas/SBAdvertisingDealPriceType"},"value":{"description":"The monetary amount of the price in the given currency.","format":"double","type":"number"}},"required":["priceType","value"],"type":"object"},"SBCreateAdvertisingDealRequest":{"properties":{"advertisingDeals":{"items":{"$ref":"#/components/schemas/SBAdvertisingDealCreate"},"maxItems":10,"minItems":1,"type":"array"}},"type":"object"},"SBCurrencyCode":{"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` | Chinese Yuan |\n| `DKK` | Danish Krone |\n| `EGP` | Egyptian Pound |\n| `EUR` | Euro |\n| `GBP` | British Pound Sterling |\n| `INR` | Indian Rupee |\n| `JPY` | Japanese Yen |\n| `MXN` | Mexican Peso |\n| `MXP` | Mexican Peso |\n| `NGN` | Nigerian Naira |\n| `NOK` | Norwegian Krone |\n| `NZD` | New Zealand Dollar |\n| `PLN` | Polish Złoty |\n| `SAR` | Saudi Riyal |\n| `SEK` | Swedish Krona |\n| `SGD` | Singapore Dollar |\n| `TRY` | Turkish Lira |\n| `USD` | United States Dollar |\n| `ZAR` | South African Rand |\n","enum":["AED","AUD","BRL","CAD","CHF","CNY","DKK","EGP","EUR","GBP","INR","JPY","MXN","MXP","NGN","NOK","NZD","PLN","SAR","SEK","SGD","TRY","USD","ZAR"],"type":"string"},"SBDeleteAdvertisingDealRequest":{"properties":{"advertisingDealIds":{"items":{"type":"string"},"maxItems":10,"minItems":1,"type":"array"}},"type":"object"},"SBQueryAdvertisingDealRequest":{"properties":{"advertisingDealIdFilter":{"$ref":"#/components/schemas/SBAdvertisingDealAdvertisingDealIdFilter"},"maxResults":{"default":10,"format":"int32","maximum":50,"minimum":1,"type":"integer"},"nameFilter":{"$ref":"#/components/schemas/SBAdvertisingDealNameFilter"},"nextToken":{"type":"string"}},"type":"object"},"SBUpdateAdvertisingDealPrice":{"properties":{"priceType":{"$ref":"#/components/schemas/SBAdvertisingDealPriceType"},"value":{"description":"The monetary amount of the price in the given currency.","format":"double","type":"number"}},"type":"object"},"SBUpdateAdvertisingDealRequest":{"properties":{"advertisingDeals":{"items":{"$ref":"#/components/schemas/SBAdvertisingDealUpdate"},"maxItems":10,"minItems":1,"type":"array"}},"type":"object"},"ServiceUnavailableErrorResponseContent":{"properties":{"code":{"type":"string"},"message":{"type":"string"}},"required":["code","message"],"type":"object"},"SortDirection":{"description":"**SortDirection Enum:**\n| SortDirection | Description |\n| --- | --- |\n| `ASCENDING` | Sort in ascending order |\n| `DESCENDING` | Sort in descending order |","enum":["ASCENDING","DESCENDING"],"type":"string"},"SportsMetadata":{"description":"Live-sports classification for a deal. Populated for certified live-sports deals.","properties":{"broadcasters":{"description":"IDs of the broadcasters associated with this live-events deal, such as ESPN. Each ID references an entry in the Amazon Ads Live-Events Broadcasters Taxonomy; the human-readable name is resolved from that taxonomy. IDs are scoped to the broadcasters taxonomy and are not comparable to sport or league IDs. Populated for certified live-events deals.","items":{"type":"string"},"maxItems":100,"minItems":0,"type":"array"},"leagues":{"description":"IDs of the leagues associated with this live-events deal, such as NFL. Each ID references an entry in the Amazon Ads Live-Events Leagues Taxonomy; the human-readable name is resolved from that taxonomy. IDs are scoped to the leagues taxonomy and are not comparable to sport or broadcaster IDs. Populated for certified live-events deals.","items":{"type":"string"},"maxItems":100,"minItems":0,"type":"array"},"sports":{"description":"IDs of the sports associated with this live-events deal, such as American Football. Each ID references an entry in the Amazon Ads Live-Events Sports Taxonomy; the human-readable name is resolved from that taxonomy. IDs are scoped to the sports taxonomy and are not comparable to league or broadcaster IDs. Populated for certified live-events deals.","items":{"type":"string"},"maxItems":100,"minItems":0,"type":"array"}},"type":"object"},"SupplyInventoryType":{"enum":["AUDIO","DISPLAY","VIDEO"],"type":"string"},"SupplyMetadata":{"description":"Supply-specific metadata for a deal. Which metadata applies depends on the type of supply the deal provides — for example, live-sports deals carry live-events classification (sports, leagues, broadcasters).\n\n| SupplyMetadata | Description |\n|------|------|\n| `sportsMetadata` | Classification for a live-sports deal (sports, leagues, broadcasters). |\n","oneOf":[{"properties":{"sportsMetadata":{"$ref":"#/components/schemas/SportsMetadata"}},"required":["sportsMetadata"],"title":"sportsMetadata","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"},"UpdateAdvertisingDealPrice":{"properties":{"currencyCode":{"$ref":"#/components/schemas/CurrencyCode"},"priceType":{"$ref":"#/components/schemas/AdvertisingDealPriceType"},"value":{"description":"The monetary amount of the price in the given currency.","format":"double","type":"number"}},"type":"object"},"UpdateAdvertisingDealRequest":{"properties":{"advertisingDeals":{"items":{"$ref":"#/components/schemas/AdvertisingDealUpdate"},"maxItems":10,"minItems":1,"type":"array"}},"required":["advertisingDeals"],"type":"object"},"UpdateAdvertisingDealTerms":{"description":"Terms for a deal. Supports PA \u0026 PD deals along with both spend-based guarantees (standard PG) and share-of-voice based guarantees (PG-SOV).","properties":{"budget":{"$ref":"#/components/schemas/UpdateMonetaryBudget"},"price":{"$ref":"#/components/schemas/UpdateAdvertisingDealPrice"}},"type":"object"},"UpdateCreativeRequirements":{"description":"Creative requirements associated with the deal.","type":"object"},"UpdateMonetaryBudget":{"properties":{"currencyCode":{"$ref":"#/components/schemas/CurrencyCode"},"value":{"description":"The monetary amount of the budget cap in the given currency.","format":"double","type":"number"}},"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":"AdvertisingDeals API","version":"3.0"},"openapi":"3.0.1","paths":{"/adsApi/v1/create/advertisingDeals":{"post":{"description":"Create advertising deals\n\n**Requires one of these permissions**:\n[\"inventory_edit\", \"inventory_view\"]","operationId":"CreateAdvertisingDeal","parameters":[{"$ref":"#/components/parameters/AccountIdHeader"},{"$ref":"#/components/parameters/ClientIdHeader"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateAdvertisingDealRequest"}}},"required":true},"responses":{"207":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdvertisingDealMultiStatusResponse"}}},"description":"CreateAdvertisingDeal 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":["AdvertisingDeals"]}},"/adsApi/v1/create/advertisingDeals/sb":{"post":{"description":"Create advertisingDeal\n\n**Requires one of these permissions**:\n[\"advertiser_campaign_edit\", \"advertiser_campaign_view\"]","operationId":"SBCreateAdvertisingDeal","parameters":[{"$ref":"#/components/parameters/AccountIdHeaderOptional"},{"$ref":"#/components/parameters/ClientIdHeader"},{"$ref":"#/components/parameters/ScopeHeaderOptional"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SBCreateAdvertisingDealRequest"}}},"required":true},"responses":{"207":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SBAdvertisingDealMultiStatusResponse"}}},"description":"SBCreateAdvertisingDeal 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":["AdvertisingDeals"]}},"/adsApi/v1/delete/advertisingDeals/sb":{"post":{"description":"Delete advertisingDeal\n\n**Requires one of these permissions**:\n[\"advertiser_campaign_edit\", \"advertiser_campaign_view\"]","operationId":"SBDeleteAdvertisingDeal","parameters":[{"$ref":"#/components/parameters/AccountIdHeaderOptional"},{"$ref":"#/components/parameters/ClientIdHeader"},{"$ref":"#/components/parameters/ScopeHeaderOptional"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SBDeleteAdvertisingDealRequest"}}},"required":true},"responses":{"207":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SBAdvertisingDealMultiStatusResponse"}}},"description":"SBDeleteAdvertisingDeal 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":["AdvertisingDeals"]}},"/adsApi/v1/query/advertisingDeals":{"post":{"description":"Query advertising deals with filters\n\n**Requires one of these permissions**:\n[\"inventory_edit\", \"inventory_view\"]","operationId":"QueryAdvertisingDeal","parameters":[{"$ref":"#/components/parameters/AccountIdHeader"},{"$ref":"#/components/parameters/ClientIdHeader"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueryAdvertisingDealRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdvertisingDealSuccessResponse"}}},"description":"QueryAdvertisingDeal 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":["AdvertisingDeals"]}},"/adsApi/v1/query/advertisingDeals/sb":{"post":{"description":"Query advertisingDeal\n\n**Requires one of these permissions**:\n[\"advertiser_campaign_edit\", \"advertiser_campaign_view\"]","operationId":"SBQueryAdvertisingDeal","parameters":[{"$ref":"#/components/parameters/AccountIdHeaderOptional"},{"$ref":"#/components/parameters/ClientIdHeader"},{"$ref":"#/components/parameters/ScopeHeaderOptional"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SBQueryAdvertisingDealRequest"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SBAdvertisingDealSuccessResponse"}}},"description":"SBQueryAdvertisingDeal 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":["AdvertisingDeals"]}},"/adsApi/v1/update/advertisingDeals":{"post":{"description":"Update advertising deals\n\n**Requires one of these permissions**:\n[\"inventory_edit\", \"inventory_view\"]","operationId":"UpdateAdvertisingDeal","parameters":[{"$ref":"#/components/parameters/AccountIdHeader"},{"$ref":"#/components/parameters/ClientIdHeader"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateAdvertisingDealRequest"}}},"required":true},"responses":{"207":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AdvertisingDealMultiStatusResponse"}}},"description":"UpdateAdvertisingDeal 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":["AdvertisingDeals"]}},"/adsApi/v1/update/advertisingDeals/sb":{"post":{"description":"Update advertisingDeal\n\n**Requires one of these permissions**:\n[\"advertiser_campaign_edit\", \"advertiser_campaign_view\"]","operationId":"SBUpdateAdvertisingDeal","parameters":[{"$ref":"#/components/parameters/AccountIdHeaderOptional"},{"$ref":"#/components/parameters/ClientIdHeader"},{"$ref":"#/components/parameters/ScopeHeaderOptional"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SBUpdateAdvertisingDealRequest"}}},"required":true},"responses":{"207":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SBAdvertisingDealMultiStatusResponse"}}},"description":"SBUpdateAdvertisingDeal 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":["AdvertisingDeals"]}}},"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"}]}