amazon-ads 0.5.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ca37ac82a931b7caf155e83c72450a70b37b1e00ed1e161ff8df8707d1594940
-  data.tar.gz: 6595ca8f52d77efd69c38436bb4b8d0f78b27a8bd06c3e444e28cafd16dc8a5a
+  metadata.gz: 7fcaddf24ef4055301c168898cc35031d30149ead740c4c4c4ac35f606512d0f
+  data.tar.gz: 75086e6378ee6e159e7c189c2a4d0a6ca912d3fd6c5809e30ceb2c9655b25ecf
 SHA512:
-  metadata.gz: f974f8dfcd535e8c084a5a3c7d7e790f315d1190dfa5a42a15ed6aeced63d205e15545c9e580b9bafeaf025dc4de11bc3f0190ac961f7efac880e25a4ae4696b
-  data.tar.gz: 2bbd82c0a5375b827ea8411cf008fc9ad5ee11f7fd20c743da1ec830235fa1853081724c6a0d28d4e97d845f0a88a7ec81eab0462178058fa70e5266c72a2775
+  metadata.gz: f1f160656461282472fd35cc506de5adb735a6bf34f0c02ecded0ee3b8018dc84ba4f25ffd1cd74dd1f16cbe4b3e4fd397fe30a62125eaaacaa9ff3f5e4cf526
+  data.tar.gz: 9f9beab38557f29b65125698ea9502b67bfe76ca293b290a259a48038686bbcfaa47d01272addf6b9d4be22332accb8a96b7e964e562fe492687cab02d3b0cb5

data/README.md

@@ -54,6 +54,8 @@ campaigns = AmazonAds::Campaigns.new(
 campaigns.list_campaigns
 ```
 
+Pass `http:` to inject a configured `HTTP` client (e.g. `http: HTTP.use(logging: { logger: Logger.new($stdout) })`). Note that debug logging prints request headers, exposing access tokens.
+
 ## Error handling
 
 Responses with a 4xx or 5xx status raise `AmazonAds::Error`, which carries the full response:
@@ -63,15 +65,30 @@ begin
   campaigns.list_campaigns
 rescue AmazonAds::Error => e
   e.status         # 400
+  e.code           # "FIELD_VALUE_IS_INVALID"
   e.response.body  # Amazon's error document
 end
 ```
 
-The error supports pattern matching on status:
+When the response carries one of Amazon's documented error codes, the error is a matching subclass under `AmazonAds::Errors`:
+
+```ruby
+begin
+  campaigns.list_campaigns
+rescue AmazonAds::Errors::TooManyRequests
+  backoff
+rescue AmazonAds::Errors::Unauthorized
+  refresh_token
+end
+```
+
+Unknown or missing codes raise the base `AmazonAds::Error`. Reporting sends the HTTP status as its code, so its errors are always the base class.
+
+The error supports pattern matching on status and code:
 
 ```ruby
 case error
-in status: 429 then backoff
+in code: "TOO_MANY_REQUESTS" then backoff
 in status: 500..599 then retry
 end
 ```

data/lib/amazon_ads/apis/ad_groups.rb

@@ -15,9 +15,9 @@ module AmazonAds
     end
 
     # List ad groups
-    #: (ad_product_filter: untyped, ?ad_group_id_filter: untyped?, ?campaign_id_filter: untyped?, ?marketplace_scope_filter: untyped?, ?max_results: Integer?, ?name_filter: untyped?, ?next_token: String?, ?state_filter: untyped?) -> HTTP::Response
-    def query_ad_group(ad_product_filter:, ad_group_id_filter: nil, campaign_id_filter: nil, marketplace_scope_filter: nil, max_results: nil, name_filter: nil, next_token: nil, state_filter: nil)
-      request(:post, "/adsApi/v1/query/adGroups", json: { "adGroupIdFilter" => ad_group_id_filter, "adProductFilter" => ad_product_filter, "campaignIdFilter" => campaign_id_filter, "marketplaceScopeFilter" => marketplace_scope_filter, "maxResults" => max_results, "nameFilter" => name_filter, "nextToken" => next_token, "stateFilter" => state_filter }.compact)
+    #: (ad_product_filter: untyped, ?ad_group_id_filter: untyped?, ?campaign_id_filter: untyped?, ?inventory_type_filter: untyped?, ?marketplace_scope_filter: untyped?, ?max_results: Integer?, ?name_filter: untyped?, ?next_token: String?, ?retailer_scope_filter: untyped?, ?state_filter: untyped?) -> HTTP::Response
+    def query_ad_group(ad_product_filter:, ad_group_id_filter: nil, campaign_id_filter: nil, inventory_type_filter: nil, marketplace_scope_filter: nil, max_results: nil, name_filter: nil, next_token: nil, retailer_scope_filter: nil, state_filter: nil)
+      request(:post, "/adsApi/v1/query/adGroups", json: { "adGroupIdFilter" => ad_group_id_filter, "adProductFilter" => ad_product_filter, "campaignIdFilter" => campaign_id_filter, "inventoryTypeFilter" => inventory_type_filter, "marketplaceScopeFilter" => marketplace_scope_filter, "maxResults" => max_results, "nameFilter" => name_filter, "nextToken" => next_token, "retailerScopeFilter" => retailer_scope_filter, "stateFilter" => state_filter }.compact)
     end
 
     # Update ad groups

data/lib/amazon_ads/apis/ads.rb

@@ -15,9 +15,9 @@ module AmazonAds
     end
 
     # List ads
-    #: (ad_product_filter: untyped, ?ad_group_id_filter: untyped?, ?ad_id_filter: untyped?, ?campaign_id_filter: untyped?, ?marketplace_scope_filter: untyped?, ?max_results: Integer?, ?name_filter: untyped?, ?next_token: String?, ?state_filter: untyped?) -> HTTP::Response
-    def query_ad(ad_product_filter:, ad_group_id_filter: nil, ad_id_filter: nil, campaign_id_filter: nil, marketplace_scope_filter: nil, max_results: nil, name_filter: nil, next_token: nil, state_filter: nil)
-      request(:post, "/adsApi/v1/query/ads", json: { "adGroupIdFilter" => ad_group_id_filter, "adIdFilter" => ad_id_filter, "adProductFilter" => ad_product_filter, "campaignIdFilter" => campaign_id_filter, "marketplaceScopeFilter" => marketplace_scope_filter, "maxResults" => max_results, "nameFilter" => name_filter, "nextToken" => next_token, "stateFilter" => state_filter }.compact)
+    #: (ad_product_filter: untyped, ?ad_group_id_filter: untyped?, ?ad_id_filter: untyped?, ?campaign_id_filter: untyped?, ?marketplace_scope_filter: untyped?, ?max_results: Integer?, ?name_filter: untyped?, ?next_token: String?, ?retailer_scope_filter: untyped?, ?state_filter: untyped?) -> HTTP::Response
+    def query_ad(ad_product_filter:, ad_group_id_filter: nil, ad_id_filter: nil, campaign_id_filter: nil, marketplace_scope_filter: nil, max_results: nil, name_filter: nil, next_token: nil, retailer_scope_filter: nil, state_filter: nil)
+      request(:post, "/adsApi/v1/query/ads", json: { "adGroupIdFilter" => ad_group_id_filter, "adIdFilter" => ad_id_filter, "adProductFilter" => ad_product_filter, "campaignIdFilter" => campaign_id_filter, "marketplaceScopeFilter" => marketplace_scope_filter, "maxResults" => max_results, "nameFilter" => name_filter, "nextToken" => next_token, "retailerScopeFilter" => retailer_scope_filter, "stateFilter" => state_filter }.compact)
     end
 
     # Update ads

data/lib/amazon_ads/apis/advertising_deals.rb

@@ -2,6 +2,18 @@
 
 module AmazonAds
   class AdvertisingDeals < API
+    # Create advertising deals
+    #: (advertising_deals: Array[untyped]) -> HTTP::Response
+    def create_advertising_deal(advertising_deals:)
+      request(:post, "/adsApi/v1/create/advertisingDeals", json: { "advertisingDeals" => advertising_deals }.compact)
+    end
+
+    # Query advertising deals with filters
+    #: (ad_product_filter: untyped, ?advertising_deal_id_filter: untyped?, ?broadcasters_filter: untyped?, ?country_code_filter: untyped?, ?creation_date_time_range_filter: untyped?, ?deal_type_filter: untyped?, ?end_date_time_range_filter: untyped?, ?exchange_deal_id_filter: untyped?, ?exchange_id_filter: untyped?, ?leagues_filter: untyped?, ?marketplace_deal_filter: untyped?, ?max_results: Integer?, ?name_filter: untyped?, ?next_token: String?, ?price_range_filter: untyped?, ?price_type_filter: untyped?, ?sort: Array[untyped]?, ?sports_filter: untyped?, ?start_date_time_range_filter: untyped?, ?status_filter: untyped?, ?supply_inventory_types_filter: untyped?) -> HTTP::Response
+    def query_advertising_deal(ad_product_filter:, advertising_deal_id_filter: nil, broadcasters_filter: nil, country_code_filter: nil, creation_date_time_range_filter: nil, deal_type_filter: nil, end_date_time_range_filter: nil, exchange_deal_id_filter: nil, exchange_id_filter: nil, leagues_filter: nil, marketplace_deal_filter: nil, max_results: nil, name_filter: nil, next_token: nil, price_range_filter: nil, price_type_filter: nil, sort: nil, sports_filter: nil, start_date_time_range_filter: nil, status_filter: nil, supply_inventory_types_filter: nil)
+      request(:post, "/adsApi/v1/query/advertisingDeals", json: { "adProductFilter" => ad_product_filter, "advertisingDealIdFilter" => advertising_deal_id_filter, "broadcastersFilter" => broadcasters_filter, "countryCodeFilter" => country_code_filter, "creationDateTimeRangeFilter" => creation_date_time_range_filter, "dealTypeFilter" => deal_type_filter, "endDateTimeRangeFilter" => end_date_time_range_filter, "exchangeDealIdFilter" => exchange_deal_id_filter, "exchangeIdFilter" => exchange_id_filter, "leaguesFilter" => leagues_filter, "marketplaceDealFilter" => marketplace_deal_filter, "maxResults" => max_results, "nameFilter" => name_filter, "nextToken" => next_token, "priceRangeFilter" => price_range_filter, "priceTypeFilter" => price_type_filter, "sort" => sort, "sportsFilter" => sports_filter, "startDateTimeRangeFilter" => start_date_time_range_filter, "statusFilter" => status_filter, "supplyInventoryTypesFilter" => supply_inventory_types_filter }.compact)
+    end
+
     # Create advertisingDeal
     #: (?advertising_deals: Array[untyped]?) -> HTTP::Response
     def sb_create_advertising_deal(advertising_deals: nil)
@@ -25,5 +37,11 @@ module AmazonAds
     def sb_update_advertising_deal(advertising_deals: nil)
       request(:post, "/adsApi/v1/update/advertisingDeals/sb", json: { "advertisingDeals" => advertising_deals }.compact)
     end
+
+    # Update advertising deals
+    #: (advertising_deals: Array[untyped]) -> HTTP::Response
+    def update_advertising_deal(advertising_deals:)
+      request(:post, "/adsApi/v1/update/advertisingDeals", json: { "advertisingDeals" => advertising_deals }.compact)
+    end
   end
 end

data/lib/amazon_ads/apis/buyer_seats.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module AmazonAds
+  class BuyerSeats < API
+    # Create buyer seats for advertisers
+    #: (buyer_seats: Array[untyped]) -> HTTP::Response
+    def create_buyer_seat(buyer_seats:)
+      request(:post, "/adsApi/v1/create/buyerSeats", json: { "buyerSeats" => buyer_seats }.compact)
+    end
+
+    # List buyer seats
+    # @rbs ad_product: String -- **AdProduct Enum:** | AdProduct | Description | | --- | --- | | `AMAZON_DSP` | Amazon Demand-Side Platform ad product. |
+    # @rbs buyer_seat_type: String -- **BuyerSeatType Enum:** | BuyerSeatType | Description | | --- | --- | | `DEAL_CREATION` | The ID for deal providers to identify the buyer seat when creating deals. | | `SPEND_TRACKING` | The ID passed to exchanges to enable buyer recognition within auctions. This can be used for both real-time decision making and offline reporting. |
+    #: (?ad_product: String?, ?buyer_seat_type: String?, ?exchange_id: String?, ?next_token: String?, ?max_results: Integer?) -> HTTP::Response
+    def list_buyer_seat(ad_product: nil, buyer_seat_type: nil, exchange_id: nil, next_token: nil, max_results: nil)
+      request(:get, "/adsApi/v1/buyerSeats", params: { "adProduct" => ad_product, "buyerSeatType" => buyer_seat_type, "exchangeId" => exchange_id, "nextToken" => next_token, "maxResults" => max_results }.compact)
+    end
+  end
+end

data/lib/amazon_ads/apis/campaigns.rb

@@ -15,9 +15,9 @@ module AmazonAds
     end
 
     # Query campaign
-    #: (ad_product_filter: untyped, ?campaign_id_filter: untyped?, ?goal_filter: untyped?, ?marketplace_scope_filter: untyped?, ?max_results: Integer?, ?name_filter: untyped?, ?next_token: String?, ?portfolio_id_filter: untyped?, ?state_filter: untyped?) -> HTTP::Response
-    def query_campaign(ad_product_filter:, campaign_id_filter: nil, goal_filter: nil, marketplace_scope_filter: nil, max_results: nil, name_filter: nil, next_token: nil, portfolio_id_filter: nil, state_filter: nil)
-      request(:post, "/adsApi/v1/query/campaigns", json: { "adProductFilter" => ad_product_filter, "campaignIdFilter" => campaign_id_filter, "goalFilter" => goal_filter, "marketplaceScopeFilter" => marketplace_scope_filter, "maxResults" => max_results, "nameFilter" => name_filter, "nextToken" => next_token, "portfolioIdFilter" => portfolio_id_filter, "stateFilter" => state_filter }.compact)
+    #: (ad_product_filter: untyped, ?campaign_id_filter: untyped?, ?goal_filter: untyped?, ?marketplace_scope_filter: untyped?, ?max_results: Integer?, ?name_filter: untyped?, ?next_token: String?, ?portfolio_id_filter: untyped?, ?retailer_scope_filter: untyped?, ?state_filter: untyped?) -> HTTP::Response
+    def query_campaign(ad_product_filter:, campaign_id_filter: nil, goal_filter: nil, marketplace_scope_filter: nil, max_results: nil, name_filter: nil, next_token: nil, portfolio_id_filter: nil, retailer_scope_filter: nil, state_filter: nil)
+      request(:post, "/adsApi/v1/query/campaigns", json: { "adProductFilter" => ad_product_filter, "campaignIdFilter" => campaign_id_filter, "goalFilter" => goal_filter, "marketplaceScopeFilter" => marketplace_scope_filter, "maxResults" => max_results, "nameFilter" => name_filter, "nextToken" => next_token, "portfolioIdFilter" => portfolio_id_filter, "retailerScopeFilter" => retailer_scope_filter, "stateFilter" => state_filter }.compact)
     end
 
     # Update campaign

data/lib/amazon_ads/apis/commitment_spends.rb

@@ -2,12 +2,6 @@
 
 module AmazonAds
   class CommitmentSpends < API
-    # Retrieve commitment spend (Deprecated legacy ad-product path alias of RetrieveCommitmentSpend; prefer the ad-product-agnostic path.)
-    #: (commitment_ids: Array[untyped]) -> HTTP::Response
-    def dsp_retrieve_commitment_spend(commitment_ids:)
-      request(:post, "/adsApi/v1/retrieve/commitmentSpends/dsp", json: { "commitmentIds" => commitment_ids }.compact)
-    end
-
     # Retrieve commitment spend
     #: (commitment_ids: Array[untyped]) -> HTTP::Response
     def retrieve_commitment_spend(commitment_ids:)

data/lib/amazon_ads/apis/commitments.rb

@@ -8,36 +8,6 @@ module AmazonAds
       request(:post, "/adsApi/v1/create/commitments", json: { "commitments" => commitments }.compact)
     end
 
-    # Create commitments (Deprecated legacy ad-product path alias of CreateCommitment; prefer the ad-product-agnostic path.)
-    #: (commitments: Array[untyped]) -> HTTP::Response
-    def dsp_create_commitment(commitments:)
-      request(:post, "/adsApi/v1/create/commitments/dsp", json: { "commitments" => commitments }.compact)
-    end
-
-    # List commitments (Deprecated legacy ad-product path alias of ListCommitment; prefer the ad-product-agnostic path.)
-    #: (?next_token: String?, ?max_results: Integer?) -> HTTP::Response
-    def dsp_list_commitment(next_token: nil, max_results: nil)
-      request(:get, "/adsApi/v1/commitments/dsp", params: { "nextToken" => next_token, "maxResults" => max_results }.compact)
-    end
-
-    # Query commitments with filters (Deprecated legacy ad-product path alias of QueryCommitment; prefer the ad-product-agnostic path.)
-    #: (?advertiser_ids_filter: untyped?, ?campaign_ids_filter: untyped?, ?commitment_id_filter: untyped?, ?commitment_name_filter: untyped?, ?deal_ids_filter: untyped?, ?max_results: Integer?, ?next_token: String?, ?spend_calculation_mode_filter: untyped?) -> HTTP::Response
-    def dsp_query_commitment(advertiser_ids_filter: nil, campaign_ids_filter: nil, commitment_id_filter: nil, commitment_name_filter: nil, deal_ids_filter: nil, max_results: nil, next_token: nil, spend_calculation_mode_filter: nil)
-      request(:post, "/adsApi/v1/query/commitments/dsp", json: { "advertiserIdsFilter" => advertiser_ids_filter, "campaignIdsFilter" => campaign_ids_filter, "commitmentIdFilter" => commitment_id_filter, "commitmentNameFilter" => commitment_name_filter, "dealIdsFilter" => deal_ids_filter, "maxResults" => max_results, "nextToken" => next_token, "spendCalculationModeFilter" => spend_calculation_mode_filter }.compact)
-    end
-
-    # Get Commitments (Deprecated legacy ad-product path alias of RetrieveCommitment; prefer the ad-product-agnostic path.)
-    #: (commitment_ids: Array[untyped]) -> HTTP::Response
-    def dsp_retrieve_commitment(commitment_ids:)
-      request(:post, "/adsApi/v1/retrieve/commitments/dsp", json: { "commitmentIds" => commitment_ids }.compact)
-    end
-
-    # Update commitments (Deprecated legacy ad-product path alias of UpdateCommitment; prefer the ad-product-agnostic path.)
-    #: (commitments: Array[untyped]) -> HTTP::Response
-    def dsp_update_commitment(commitments:)
-      request(:post, "/adsApi/v1/update/commitments/dsp", json: { "commitments" => commitments }.compact)
-    end
-
     # List commitments
     #: (?next_token: String?, ?max_results: Integer?) -> HTTP::Response
     def list_commitment(next_token: nil, max_results: nil)

data/lib/amazon_ads/apis/deal_advertiser_access_entries.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module AmazonAds
+  class DealAdvertiserAccessEntries < API
+    # Add advertisers to a deal advertiser access list
+    #: (deal_advertiser_access_entries: Array[untyped]) -> HTTP::Response
+    def create_deal_advertiser_access_entry(deal_advertiser_access_entries:)
+      request(:post, "/adsApi/v1/create/dealAdvertiserAccessEntries", json: { "dealAdvertiserAccessEntries" => deal_advertiser_access_entries }.compact)
+    end
+
+    # Remove advertisers from a deal advertiser access list
+    #: (deal_advertiser_access_entry_ids: Array[untyped]) -> HTTP::Response
+    def delete_deal_advertiser_access_entry(deal_advertiser_access_entry_ids:)
+      request(:post, "/adsApi/v1/delete/dealAdvertiserAccessEntries", json: { "dealAdvertiserAccessEntryIds" => deal_advertiser_access_entry_ids }.compact)
+    end
+
+    # Query advertiser entries for a deal advertiser access record
+    #: (deal_advertiser_access_id_filter: untyped, ?ad_product_filter: untyped?, ?max_results: Integer?, ?next_token: String?) -> HTTP::Response
+    def query_deal_advertiser_access_entry(deal_advertiser_access_id_filter:, ad_product_filter: nil, max_results: nil, next_token: nil)
+      request(:post, "/adsApi/v1/query/dealAdvertiserAccessEntries", json: { "adProductFilter" => ad_product_filter, "dealAdvertiserAccessIdFilter" => deal_advertiser_access_id_filter, "maxResults" => max_results, "nextToken" => next_token }.compact)
+    end
+  end
+end

data/lib/amazon_ads/apis/deal_advertiser_accesses.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module AmazonAds
+  class DealAdvertiserAccesses < API
+    # Create a deal advertiser access record with a strategy (ALLOW or BLOCK)
+    #: (deal_advertiser_accesses: Array[untyped]) -> HTTP::Response
+    def create_deal_advertiser_access(deal_advertiser_accesses:)
+      request(:post, "/adsApi/v1/create/dealAdvertiserAccesses", json: { "dealAdvertiserAccesses" => deal_advertiser_accesses }.compact)
+    end
+
+    # Delete a deal advertiser access record and all associated entries
+    #: (deal_advertiser_access_ids: Array[untyped]) -> HTTP::Response
+    def delete_deal_advertiser_access(deal_advertiser_access_ids:)
+      request(:post, "/adsApi/v1/delete/dealAdvertiserAccesses", json: { "dealAdvertiserAccessIds" => deal_advertiser_access_ids }.compact)
+    end
+
+    # Retrieve a deal advertiser access record by ID
+    #: (deal_advertiser_access_ids: Array[untyped]) -> HTTP::Response
+    def retrieve_deal_advertiser_access(deal_advertiser_access_ids:)
+      request(:post, "/adsApi/v1/retrieve/dealAdvertiserAccesses", json: { "dealAdvertiserAccessIds" => deal_advertiser_access_ids }.compact)
+    end
+  end
+end

data/lib/amazon_ads/apis/deal_availses.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module AmazonAds
+  class DealAvailses < API
+    # Query deal avails by advertising deal ID. Returns avails records aggregated by selected attributes over the last 7 days, sorted by eligible avails descending.
+    #: (ad_product_filter: untyped, advertising_deal_id_filter: untyped, ?eligible_avails_targeting_filter: untyped?, ?group_by_attributes_filter: untyped?, ?max_results: Integer?, ?next_token: String?, ?sort: Array[untyped]?) -> HTTP::Response
+    def query_deal_avails(ad_product_filter:, advertising_deal_id_filter:, eligible_avails_targeting_filter: nil, group_by_attributes_filter: nil, max_results: nil, next_token: nil, sort: nil)
+      request(:post, "/adsApi/v1/query/dealAvailses", json: { "adProductFilter" => ad_product_filter, "advertisingDealIdFilter" => advertising_deal_id_filter, "eligibleAvailsTargetingFilter" => eligible_avails_targeting_filter, "groupByAttributesFilter" => group_by_attributes_filter, "maxResults" => max_results, "nextToken" => next_token, "sort" => sort }.compact)
+    end
+  end
+end

data/lib/amazon_ads/apis/deal_performances.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module AmazonAds
+  class DealPerformances < API
+    # Retrieve performance metrics for each specified deal.
+    # @rbs ad_product: String -- **AdProduct Enum:** | AdProduct | Description | | --- | --- | | `AMAZON_DSP` | Amazon Demand-Side Platform ad product. |
+    #: (advertising_deal_id: String, ?ad_product: String?, ?performance_end_date: String?, ?performance_start_date: String?, ?next_token: String?, ?max_results: Integer?) -> HTTP::Response
+    def list_deal_performance(advertising_deal_id:, ad_product: nil, performance_end_date: nil, performance_start_date: nil, next_token: nil, max_results: nil)
+      request(:get, "/adsApi/v1/dealPerformances", params: { "adProduct" => ad_product, "advertisingDealId" => advertising_deal_id, "performanceEndDate" => performance_end_date, "performanceStartDate" => performance_start_date, "nextToken" => next_token, "maxResults" => max_results }.compact)
+    end
+  end
+end

data/lib/amazon_ads/apis/deal_planning_metricses.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module AmazonAds
+  class DealPlanningMetricses < API
+    # Query deal planning metrics for specified deals, with optional metric range filters and sort.
+    #: (ad_product_filter: untyped, advertising_deal_id_filter: untyped, ?click_through_rate_filter: untyped?, ?currency_filter: untyped?, ?effective_cpm_filter: untyped?, ?max_results: Integer?, ?measured_rate_filter: untyped?, ?next_token: String?, ?sort: Array[untyped]?, ?video_completion_rate_filter: untyped?, ?view_rate_filter: untyped?, ?viewable_cpm_filter: untyped?) -> HTTP::Response
+    def query_deal_planning_metrics(ad_product_filter:, advertising_deal_id_filter:, click_through_rate_filter: nil, currency_filter: nil, effective_cpm_filter: nil, max_results: nil, measured_rate_filter: nil, next_token: nil, sort: nil, video_completion_rate_filter: nil, view_rate_filter: nil, viewable_cpm_filter: nil)
+      request(:post, "/adsApi/v1/query/dealPlanningMetricses", json: { "adProductFilter" => ad_product_filter, "advertisingDealIdFilter" => advertising_deal_id_filter, "clickThroughRateFilter" => click_through_rate_filter, "currencyFilter" => currency_filter, "effectiveCPMFilter" => effective_cpm_filter, "maxResults" => max_results, "measuredRateFilter" => measured_rate_filter, "nextToken" => next_token, "sort" => sort, "videoCompletionRateFilter" => video_completion_rate_filter, "viewRateFilter" => view_rate_filter, "viewableCPMFilter" => viewable_cpm_filter }.compact)
+    end
+  end
+end

data/lib/amazon_ads/apis/label_object_associations.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module AmazonAds
+  class LabelObjectAssociations < API
+    # Query label-to-object associations with filters.
+    #: (label_object_type_filter: untyped, ?ad_product_filter: untyped?, ?label_id_filter: untyped?, ?label_object_id_filter: untyped?, ?max_results: Integer?, ?next_token: String?) -> HTTP::Response
+    def query_label_object_association(label_object_type_filter:, ad_product_filter: nil, label_id_filter: nil, label_object_id_filter: nil, max_results: nil, next_token: nil)
+      request(:post, "/adsApi/v1/query/labelObjectAssociations", json: { "adProductFilter" => ad_product_filter, "labelIdFilter" => label_id_filter, "labelObjectIdFilter" => label_object_id_filter, "labelObjectTypeFilter" => label_object_type_filter, "maxResults" => max_results, "nextToken" => next_token }.compact)
+    end
+  end
+end

data/lib/amazon_ads/apis/labels.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module AmazonAds
+  class Labels < API
+    # Query labels with filters. Returns labels that have associations of the specified object type and are visible to the caller's entity.
+    #: (label_object_type_filter: untyped, ?ad_product_filter: untyped?, ?label_id_filter: untyped?, ?label_name_filter: untyped?, ?max_results: Integer?, ?next_token: String?) -> HTTP::Response
+    def query_label(label_object_type_filter:, ad_product_filter: nil, label_id_filter: nil, label_name_filter: nil, max_results: nil, next_token: nil)
+      request(:post, "/adsApi/v1/query/labels", json: { "adProductFilter" => ad_product_filter, "labelIdFilter" => label_id_filter, "labelNameFilter" => label_name_filter, "labelObjectTypeFilter" => label_object_type_filter, "maxResults" => max_results, "nextToken" => next_token }.compact)
+    end
+  end
+end

data/lib/amazon_ads/apis/marketing_stream.rb

@@ -10,7 +10,7 @@ module AmazonAds
     # @rbs notes: String -- Additional details associated with the subscription
     #: (client_request_token: String, data_set_id: String, ?destination: untyped?, ?destination_arn: String?, ?notes: String?) -> HTTP::Response
     def create_dsp_stream_subscription(client_request_token:, data_set_id:, destination: nil, destination_arn: nil, notes: nil)
-      request(:post, "/dsp/streams/subscriptions", json: { "clientRequestToken" => client_request_token, "dataSetId" => data_set_id, "destination" => destination, "destinationArn" => destination_arn, "notes" => notes }.compact, headers: { "Content-Type" => "application/vnd.amazonmarketingstreamsubscriptions.v1+json" })
+      request(:post, "/dsp/streams/subscriptions", json: { "clientRequestToken" => client_request_token, "dataSetId" => data_set_id, "destination" => destination, "destinationArn" => destination_arn, "notes" => notes }.compact, headers: { "Content-Type" => "application/vnd.amazonmarketingstreamsubscriptions.v1+json", "Accept" => "application/vnd.amazonmarketingstreamsubscriptions.v1+json" })
     end
 
     # Create a new subscription Note: trailing slash in request uri is not allowed
@@ -20,7 +20,7 @@ module AmazonAds
     # @rbs notes: String -- Additional details associated with the subscription
     #: (client_request_token: String, data_set_id: String, ?destination: untyped?, ?destination_arn: String?, ?notes: String?) -> HTTP::Response
     def create_stream_subscription(client_request_token:, data_set_id:, destination: nil, destination_arn: nil, notes: nil)
-      request(:post, "/streams/subscriptions", json: { "clientRequestToken" => client_request_token, "dataSetId" => data_set_id, "destination" => destination, "destinationArn" => destination_arn, "notes" => notes }.compact, headers: { "Content-Type" => "application/vnd.amazonmarketingstreamsubscriptions.v1+json" })
+      request(:post, "/streams/subscriptions", json: { "clientRequestToken" => client_request_token, "dataSetId" => data_set_id, "destination" => destination, "destinationArn" => destination_arn, "notes" => notes }.compact, headers: { "Content-Type" => "application/vnd.amazonmarketingstreamsubscriptions.v1+json", "Accept" => "application/vnd.amazonmarketingstreamsubscriptions.v1+json" })
     end
 
     # Fetch a specific subscription by Id Note: trailing slash in request uri is not allowed
@@ -58,7 +58,7 @@ module AmazonAds
     # @rbs notes: String -- Additional details associated with the subscription
     #: (String, ?notes: String?, ?status: untyped?) -> HTTP::Response
     def update_dsp_stream_subscription(subscription_id, notes: nil, status: nil)
-      request(:put, "/dsp/streams/subscriptions/#{subscription_id}", json: { "notes" => notes, "status" => status }.compact, headers: { "Content-Type" => "application/vnd.amazonmarketingstreamsubscriptions.v1+json" })
+      request(:put, "/dsp/streams/subscriptions/#{subscription_id}", json: { "notes" => notes, "status" => status }.compact, headers: { "Content-Type" => "application/vnd.amazonmarketingstreamsubscriptions.v1+json", "Accept" => "application/vnd.amazonmarketingstreamsubscriptions.v1+json" })
     end
 
     # Update an existing subscription Note: trailing slash in request uri is not allowed
@@ -66,7 +66,7 @@ module AmazonAds
     # @rbs notes: String -- Additional details associated with the subscription
     #: (String, ?notes: String?, ?status: untyped?) -> HTTP::Response
     def update_stream_subscription(subscription_id, notes: nil, status: nil)
-      request(:put, "/streams/subscriptions/#{subscription_id}", json: { "notes" => notes, "status" => status }.compact, headers: { "Content-Type" => "application/vnd.amazonmarketingstreamsubscriptions.v1+json" })
+      request(:put, "/streams/subscriptions/#{subscription_id}", json: { "notes" => notes, "status" => status }.compact, headers: { "Content-Type" => "application/vnd.amazonmarketingstreamsubscriptions.v1+json", "Accept" => "application/vnd.amazonmarketingstreamsubscriptions.v1+json" })
     end
   end
 end

data/lib/amazon_ads/apis/portfolios.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module AmazonAds
+  # Portfolios
+  class Portfolios < API
+    # @rbs portfolios: Array[untyped] -- An array of portfolio to create.
+    #: (portfolios: Array[untyped]) -> HTTP::Response
+    def create_portfolios(portfolios:)
+      request(:post, "/portfolios", json: { "portfolios" => portfolios }.compact, headers: { "Content-Type" => "application/vnd.spPortfolio.v3+json", "Accept" => "application/vnd.spPortfolio.v3+json" })
+    end
+
+    # @rbs include_extended_data_fields: bool -- whether to get a list of targetingClauses with extended data fields (creationDate, lastUpdateDate, servingStatus).
+    # @rbs next_token: String -- token value allowing to navigate to the next response page
+    #: (?include_extended_data_fields: bool?, ?name_filter: untyped?, ?next_token: String?, ?portfolio_id_filter: untyped?, ?state_filter: untyped?) -> HTTP::Response
+    def list_portfolios(include_extended_data_fields: nil, name_filter: nil, next_token: nil, portfolio_id_filter: nil, state_filter: nil)
+      request(:post, "/portfolios/list", json: { "includeExtendedDataFields" => include_extended_data_fields, "nameFilter" => name_filter, "nextToken" => next_token, "portfolioIdFilter" => portfolio_id_filter, "stateFilter" => state_filter }.compact, headers: { "Content-Type" => "application/vnd.spPortfolio.v3+json", "Accept" => "application/vnd.spPortfolio.v3+json" })
+    end
+
+    # Budget usage API for portfolios
+    # @rbs portfolio_ids: Array[untyped] -- A list of portfolio IDs.
+    #: (?portfolio_ids: Array[untyped]?) -> HTTP::Response
+    def portfolio_budget_usage(portfolio_ids: nil)
+      request(:post, "/portfolios/budget/usage", json: { "portfolioIds" => portfolio_ids }.compact, headers: { "Content-Type" => "application/vnd.portfoliobudgetusage.v1+json", "Accept" => "application/vnd.portfoliobudgetusage.v1+json" })
+    end
+
+    # @rbs portfolios: Array[untyped] -- An array of portfolio with updated values.
+    #: (portfolios: Array[untyped]) -> HTTP::Response
+    def update_portfolios(portfolios:)
+      request(:put, "/portfolios", json: { "portfolios" => portfolios }.compact, headers: { "Content-Type" => "application/vnd.spPortfolio.v3+json", "Accept" => "application/vnd.spPortfolio.v3+json" })
+    end
+  end
+end

data/lib/amazon_ads/apis/publishers.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module AmazonAds
+  class Publishers < API
+    # Query publishers. A publisher is a business entity that operates the apps, sites, or video streams where ads are displayed. Use this API to search publishers by ID or name, for example to understand and compare where your ads run.
+    #: (ad_product_filter: untyped, ?max_results: Integer?, ?name_filter: untyped?, ?next_token: String?, ?publisher_id_filter: untyped?, ?publisher_owner_id_filter: untyped?, ?root_domain_filter: untyped?, ?sort: Array[untyped]?) -> HTTP::Response
+    def query_publisher(ad_product_filter:, max_results: nil, name_filter: nil, next_token: nil, publisher_id_filter: nil, publisher_owner_id_filter: nil, root_domain_filter: nil, sort: nil)
+      request(:post, "/adsApi/v1/query/publishers", json: { "adProductFilter" => ad_product_filter, "maxResults" => max_results, "nameFilter" => name_filter, "nextToken" => next_token, "publisherIdFilter" => publisher_id_filter, "publisherOwnerIdFilter" => publisher_owner_id_filter, "rootDomainFilter" => root_domain_filter, "sort" => sort }.compact)
+    end
+  end
+end

data/lib/amazon_ads/apis/recommendations.rb

@@ -2,6 +2,22 @@
 
 module AmazonAds
   class Recommendations < API
+    # List recommendations for a given advertiser.
+    # @rbs ad_product: String -- **AdProduct Enum:** | AdProduct | Description | | --- | --- | | `AMAZON_DSP` | Amazon Demand-Side Platform ad product. |
+    # @rbs language_locale_iso: String -- A combination of ISO-639 standard for language code and ISO-3166 for country code. **LanguageLocaleIso Enum:** | LanguageLocaleIso | Description | | --- | --- | | `ak-GH` | Akan (Ghana). | | `am-ET` | Amharic (Ethiopia). | | `an-ES` | Aragonese (Spain). | | `ar-AE` | Arabic (UAE). | | `as-IN` | Assamese (India). | | `av-RU` | Avaric (Russia). | | `ay-BO` | Aymara (Bolivia). | | `ba-RU` | Bashkir (Russia). | | `be-BY` | Belarusian (Belarus). | | `bg-BG` | Bulgarian (Bulgaria). | | `bh-IN` | Bihari (India). | | `bi-VU` | Bislama (Vanuatu). | | `bm-ML` | Bambara (Mali). | | `bo-CN` | Tibetan (China). | | `bs-BA` | Bosnian (Bosnia and Herzegovina). | | `ca-ES` | Catalan (Spain). | | `ce-RU` | Chechen (Russia). | | `ch-GU` | Chamorro (Guam). | | `de-DE` | German (Germany). | | `el-GR` | Greek (Greece). | | `en-AE` | English (UAE). | | `en-AU` | English (Australia). | | `en-CA` | English (Canada). | | `en-GB` | English (United Kingdom). | | `en-IN` | English (India). | | `en-SG` | English (Singapore). | | `en-US` | English (United States). | | `eo-INT` | Esperanto (International). | | `es-CO` | Spanish (Colombia). | | `es-ES` | Spanish (Spain). | | `es-MX` | Spanish (Mexico). | | `et-EE` | Estonian (Estonia). | | `eu-ES` | Basque (Spain). | | `fa-IR` | Persian (Iran). | | `fi-FI` | Finnish (Finland). | | `fj-FJ` | Fijian (Fiji). | | `fo-FO` | Faroese (Faroe Islands). | | `fr-CA` | French (Canada). | | `fr-FR` | French (France). | | `fy-NL` | Western Frisian (Netherlands). | | `ga-IE` | Irish (Ireland). | | `gd-GB` | Scottish Gaelic (United Kingdom). | | `gl-ES` | Galician (Spain). | | `gn-PY` | Guarani (Paraguay). | | `gu-IN` | Gujarati (India). | | `gv-IM` | Manx (Isle of Man). | | `ha-NG` | Hausa (Nigeria). | | `he-IL` | Hebrew (Israel). | | `hi-IN` | Hindi (India). | | `ho-PG` | Hiri Motu (Papua New Guinea). | | `hr-HR` | Croatian (Croatia). | | `ht-HT` | Haitian Creole (Haiti). | | `hu-HU` | Hungarian (Hungary). | | `hy-AM` | Armenian (Armenia). | | `hz-NA` | Herero (Namibia). | | `ia-INT` | Interlingua (International). | | `id-ID` | Indonesian (Indonesia). | | `ie-INT` | Interlingue (International). | | `ig-NG` | Igbo (Nigeria). | | `ii-CN` | Sichuan Yi (China). | | `ik-US` | Inupiaq (United States). | | `io-INT` | Ido (International). | | `is-IS` | Icelandic (Iceland). | | `it-IT` | Italian (Italy). | | `iu-CA` | Inuktitut (Canada). | | `ja-JP` | Japanese (Japan). | | `jv-ID` | Javanese (Indonesia). | | `ka-GE` | Georgian (Georgia). | | `kg-CD` | Kongo (Democratic Republic of the Congo). | | `ki-KE` | Kikuyu (Kenya). | | `kj-NA` | Kwanyama (Namibia). | | `kk-KZ` | Kazakh (Kazakhstan). | | `kl-GL` | Kalaallisut (Greenland). | | `km-KH` | Khmer (Cambodia). | | `kn-IN` | Kannada (India). | | `ko-KR` | Korean (South Korea). | | `kr-NG` | Kanuri (Nigeria). | | `ks-IN` | Kashmiri (India). | | `ku-TR` | Kurdish (Turkey). | | `kv-RU` | Komi (Russia). | | `kw-GB` | Cornish (United Kingdom). | | `ky-KG` | Kyrgyz (Kyrgyzstan). | | `la-VA` | Latin (Vatican City). | | `lb-LU` | Luxembourgish (Luxembourg). | | `lg-UG` | Ganda (Uganda). | | `li-NL` | Limburgish (Netherlands). | | `ln-CD` | Lingala (Democratic Republic of the Congo). | | `lo-LA` | Lao (Laos). | | `lt-LT` | Lithuanian (Lithuania). | | `lu-CD` | Luba-Katanga (Democratic Republic of the Congo). | | `lv-LV` | Latvian (Latvia). | | `mg-MG` | Malagasy (Madagascar). | | `mh-MH` | Marshallese (Marshall Islands). | | `mi-NZ` | Māori (New Zealand). | | `mk-MK` | Macedonian (North Macedonia). | | `ml-IN` | Malayalam (India). | | `mn-MN` | Mongolian (Mongolia). | | `mr-IN` | Marathi (India). | | `ms-MY` | Malay (Malaysia). | | `mt-MT` | Maltese (Malta). | | `my-MM` | Burmese (Myanmar). | | `na-NR` | Nauru (Nauru). | | `nb-NO` | Norwegian Bokmål (Norway). | | `nd-ZW` | North Ndebele (Zimbabwe). | | `ne-NP` | Nepali (Nepal). | | `ng-NA` | Ndonga (Namibia). | | `nl-NL` | Dutch (Netherlands). | | `nn-NO` | Norwegian Nynorsk (Norway). | | `no-NO` | Norwegian (Norway). | | `nr-ZA` | South Ndebele (South Africa). | | `nv-US` | Navajo (United States). | | `ny-MW` | Chichewa (Malawi). | | `oc-FR` | Occitan (France). | | `oj-CA` | Ojibwa (Canada). | | `om-ET` | Oromo (Ethiopia). | | `or-IN` | Oriya (India). | | `os-RU` | Ossetian (Russia). | | `pa-IN` | Punjabi (India). | | `pi-IN` | Pali (India). | | `pl-PL` | Polish (Poland). | | `ps-AF` | Pashto (Afghanistan). | | `pt-BR` | Portuguese (Brazil). | | `pt-PT` | Portuguese (Portugal). | | `qu-PE` | Quechua (Peru). | | `rm-CH` | Romansh (Switzerland). | | `rn-BI` | Kirundi (Burundi). | | `ro-RO` | Romanian (Romania). | | `ru-RU` | Russian (Russia). | | `rw-RW` | Kinyarwanda (Rwanda). | | `sa-IN` | Sanskrit (India). | | `sc-IT` | Sardinian (Italy). | | `sd-PK` | Sindhi (Pakistan). | | `se-NO` | Northern Sami (Norway). | | `sg-CF` | Sango (Central African Republic). | | `si-LK` | Sinhala (Sri Lanka). | | `sk-SK` | Slovak (Slovakia). | | `sl-SI` | Slovenian (Slovenia). | | `sm-WS` | Samoan (Samoa). | | `sn-ZW` | Shona (Zimbabwe). | | `so-SO` | Somali (Somalia). | | `sq-AL` | Albanian (Albania). | | `sr-RS` | Serbian (Serbia). | | `ss-SZ` | Swati (Eswatini). | | `st-LS` | Southern Sotho (Lesotho). | | `su-ID` | Sundanese (Indonesia). | | `sv-SE` | Swedish (Sweden). | | `sw-TZ` | Swahili (Tanzania). | | `ta-IN` | Tamil (India). | | `te-IN` | Telugu (India). | | `tg-TJ` | Tajik (Tajikistan). | | `th-TH` | Thai (Thailand). | | `ti-ET` | Tigrinya (Ethiopia). | | `tk-TM` | Turkmen (Turkmenistan). | | `tl-PH` | Tagalog (Philippines). | | `tn-BW` | Tswana (Botswana). | | `to-TO` | Tonga (Tonga). | | `tr-TR` | Turkish (Turkey). | | `ts-ZA` | Tsonga (South Africa). | | `tt-RU` | Tatar (Russia). | | `tw-GH` | Twi (Ghana). | | `ty-PF` | Tahitian (French Polynesia). | | `ug-CN` | Uyghur (China). | | `uk-UA` | Ukrainian (Ukraine). | | `ur-PK` | Urdu (Pakistan). | | `uz-UZ` | Uzbek (Uzbekistan). | | `ve-ZA` | Venda (South Africa). | | `vi-VN` | Vietnamese (Vietnam). | | `vo-INT` | Volapük (International). | | `wa-BE` | Walloon (Belgium). | | `wo-SN` | Wolof (Senegal). | | `xh-ZA` | Xhosa (South Africa). | | `yi-IL` | Yiddish (Israel). | | `yo-NG` | Yoruba (Nigeria). | | `za-CN` | Zhuang (China). | | `zh-CN` | Chinese (China). | | `zh-TW` | Chinese (Taiwan). | | `zu-ZA` | Zulu (South Africa). |
+    # @rbs marketplace: String -- A list of country codes representing Amazon marketplaces
+    # @rbs recommendation_type_enum: String -- The unique identifier of the recommendation type. Used to classify and group similar recommendations (e.g. 'BRANDED_KEYWORD'). **RecommendationTypeEnum Enum:** | RecommendationTypeEnum | Description | | --- | --- | | `AUTOMATIC_GLOBAL_ADS_ENROLLMENT` | Surfaces an advertiser's automatic global ads enrollment status and trial performance. No additional type details are required when querying. |
+    #: (?ad_product: String?, ?language_locale_iso: String?, ?marketplace: String?, ?recommendation_type_enum: String?, ?next_token: String?, ?max_results: Integer?) -> HTTP::Response
+    def list_recommendation(ad_product: nil, language_locale_iso: nil, marketplace: nil, recommendation_type_enum: nil, next_token: nil, max_results: nil)
+      request(:get, "/adsApi/v1/recommendations", params: { "adProduct" => ad_product, "languageLocaleIso" => language_locale_iso, "marketplace" => marketplace, "recommendationTypeEnum" => recommendation_type_enum, "nextToken" => next_token, "maxResults" => max_results }.compact)
+    end
+
+    # Fetch full recommendations for a given advertiser and product.
+    #: (access_requested_accounts: Array[untyped], ?ad_product_filter: untyped?, ?language_filter: untyped?, ?marketplaces_filter: untyped?, ?max_results: Integer?, ?next_token: String?, ?recommendation_type_details_filter: untyped?, ?recommendation_type_filter: untyped?) -> HTTP::Response
+    def query_recommendation(access_requested_accounts:, ad_product_filter: nil, language_filter: nil, marketplaces_filter: nil, max_results: nil, next_token: nil, recommendation_type_details_filter: nil, recommendation_type_filter: nil)
+      request(:post, "/adsApi/v1/query/recommendations", json: { "accessRequestedAccounts" => access_requested_accounts, "adProductFilter" => ad_product_filter, "languageFilter" => language_filter, "marketplacesFilter" => marketplaces_filter, "maxResults" => max_results, "nextToken" => next_token, "recommendationTypeDetailsFilter" => recommendation_type_details_filter, "recommendationTypeFilter" => recommendation_type_filter }.compact)
+    end
+
     # Create recommendations
     #: (?recommendations: Array[untyped]?) -> HTTP::Response
     def sb_create_recommendation(recommendations: nil)

data/lib/amazon_ads/apis/reporting.rb

@@ -3,13 +3,15 @@
 module AmazonAds
   # Offline Report
   class Reporting < API
+    include AmazonAds::Helpers::Reporting
+
     # Creates a report request
     # @rbs end_date: String -- YYYY-MM-DD format. The maximum lookback window supported depends on the selection of reportTypeId. Most report types support `95 days` as lookback window.
     # @rbs name: String -- The name of the report.
     # @rbs start_date: String -- YYYY-MM-DD format. The maximum lookback window supported depends on the selection of reportTypeId. Most report types support `95 days` as lookback window.
     #: (configuration: untyped, end_date: String, start_date: String, ?name: String?) -> HTTP::Response
     def create_async_report(configuration:, end_date:, start_date:, name: nil)
-      request(:post, "/reporting/reports", json: { "configuration" => configuration, "endDate" => end_date, "name" => name, "startDate" => start_date }.compact, headers: { "Content-Type" => "application/vnd.createasyncreportrequest.v3+json" })
+      request(:post, "/reporting/reports", json: { "configuration" => configuration, "endDate" => end_date, "name" => name, "startDate" => start_date }.compact, headers: { "Content-Type" => "application/vnd.createasyncreportrequest.v3+json", "Accept" => "application/vnd.createasyncreportrequest.v3+json" })
     end
 
     # Deletes a report by id

data/lib/amazon_ads/apis/reports.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module AmazonAds
+  class Reports < API
+    # Create a report
+    #: (access_requested_accounts: Array[untyped], reports: Array[untyped]) -> HTTP::Response
+    def ads_apiv1_create_report(access_requested_accounts:, reports:)
+      request(:post, "/adsApi/v1/create/reports", json: { "accessRequestedAccounts" => access_requested_accounts, "reports" => reports }.compact)
+    end
+
+    # Delete a report by ID
+    #: (report_ids: Array[untyped]) -> HTTP::Response
+    def ads_apiv1_delete_report(report_ids:)
+      request(:post, "/adsApi/v1/delete/reports", json: { "reportIds" => report_ids }.compact)
+    end
+
+    # Retrieve a report by ID
+    #: (report_ids: Array[untyped]) -> HTTP::Response
+    def ads_apiv1_retrieve_report(report_ids:)
+      request(:post, "/adsApi/v1/retrieve/reports", json: { "reportIds" => report_ids }.compact)
+    end
+  end
+end

data/lib/amazon_ads/apis/sellers.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module AmazonAds
+  class Sellers < API
+    # Query sellers. A seller is a business entity that has the rights to sell a publisher's advertising inventory and holds accounts with suppliers that send that inventory to Amazon DSP. Use this API to search sellers by ID or name, for example to identify a seller when creating a deal or commitment.
+    #: (ad_product_filter: untyped, ?max_results: Integer?, ?name_filter: untyped?, ?next_token: String?, ?seller_id_filter: untyped?, ?seller_parent_id_filter: untyped?, ?sort: Array[untyped]?) -> HTTP::Response
+    def query_seller(ad_product_filter:, max_results: nil, name_filter: nil, next_token: nil, seller_id_filter: nil, seller_parent_id_filter: nil, sort: nil)
+      request(:post, "/adsApi/v1/query/sellers", json: { "adProductFilter" => ad_product_filter, "maxResults" => max_results, "nameFilter" => name_filter, "nextToken" => next_token, "sellerIdFilter" => seller_id_filter, "sellerParentIdFilter" => seller_parent_id_filter, "sort" => sort }.compact)
+    end
+  end
+end

data/lib/amazon_ads/apis/stream_subscriptions.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module AmazonAds
+  class StreamSubscriptions < API
+    # Create a new subscription\nNote: trailing slash in request uri is not allowed
+    #: (access_requested_accounts: Array[untyped], stream_subscriptions: Array[untyped]) -> HTTP::Response
+    def ads_apiv1_create_stream_subscription(access_requested_accounts:, stream_subscriptions:)
+      request(:post, "/adsApi/v1/create/streamSubscriptions", json: { "accessRequestedAccounts" => access_requested_accounts, "streamSubscriptions" => stream_subscriptions }.compact)
+    end
+
+    # Archive an existing subscription Note: trailing slash in request uri is not allowed
+    #: (access_requested_accounts: Array[untyped], stream_subscription_ids: Array[untyped]) -> HTTP::Response
+    def ads_apiv1_delete_stream_subscription(access_requested_accounts:, stream_subscription_ids:)
+      request(:post, "/adsApi/v1/delete/streamSubscriptions", json: { "accessRequestedAccounts" => access_requested_accounts, "streamSubscriptionIds" => stream_subscription_ids }.compact)
+    end
+
+    # Query subscriptions Note: trailing slash in request uri is not allowed
+    #: (access_requested_accounts: Array[untyped], ?max_results: Integer?, ?next_token: String?) -> HTTP::Response
+    def ads_apiv1_query_stream_subscription(access_requested_accounts:, max_results: nil, next_token: nil)
+      request(:post, "/adsApi/v1/query/streamSubscriptions", json: { "accessRequestedAccounts" => access_requested_accounts, "maxResults" => max_results, "nextToken" => next_token }.compact)
+    end
+
+    # Fetch a specific subscription by Id Note: trailing slash in request uri is not allowed
+    #: (access_requested_accounts: Array[untyped], stream_subscription_ids: Array[untyped]) -> HTTP::Response
+    def ads_apiv1_retrieve_stream_subscription(access_requested_accounts:, stream_subscription_ids:)
+      request(:post, "/adsApi/v1/retrieve/streamSubscriptions", json: { "accessRequestedAccounts" => access_requested_accounts, "streamSubscriptionIds" => stream_subscription_ids }.compact)
+    end
+  end
+end

data/lib/amazon_ads/apis/suppliers.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module AmazonAds
+  class Suppliers < API
+    # Query suppliers. A supplier is a business entity that sends advertising inventory to Amazon DSP, either through direct publisher relationships or as an intermediary such as a supply-side platform (SSP). Use this API to search suppliers by ID or name, or to find the suppliers that can serve a given inventory type or delivery channel in the open auction.
+    #: (ad_product_filter: untyped, ?integration_type_filter: untyped?, ?max_results: Integer?, ?next_token: String?, ?open_auction_delivery_channels_filter: untyped?, ?open_auction_device_types_filter: untyped?, ?open_auction_inventory_types_filter: untyped?, ?sort: Array[untyped]?, ?state_filter: untyped?, ?supplier_id_filter: untyped?, ?supplier_name_filter: untyped?, ?type_filter: untyped?) -> HTTP::Response
+    def query_supplier(ad_product_filter:, integration_type_filter: nil, max_results: nil, next_token: nil, open_auction_delivery_channels_filter: nil, open_auction_device_types_filter: nil, open_auction_inventory_types_filter: nil, sort: nil, state_filter: nil, supplier_id_filter: nil, supplier_name_filter: nil, type_filter: nil)
+      request(:post, "/adsApi/v1/query/suppliers", json: { "adProductFilter" => ad_product_filter, "integrationTypeFilter" => integration_type_filter, "maxResults" => max_results, "nextToken" => next_token, "openAuctionDeliveryChannelsFilter" => open_auction_delivery_channels_filter, "openAuctionDeviceTypesFilter" => open_auction_device_types_filter, "openAuctionInventoryTypesFilter" => open_auction_inventory_types_filter, "sort" => sort, "stateFilter" => state_filter, "supplierIdFilter" => supplier_id_filter, "supplierNameFilter" => supplier_name_filter, "typeFilter" => type_filter }.compact)
+    end
+  end
+end

data/lib/amazon_ads/apis/targets.rb

@@ -15,9 +15,9 @@ module AmazonAds
     end
 
     # List target
-    #: (ad_product_filter: untyped, ?ad_group_id_filter: untyped?, ?campaign_id_filter: untyped?, ?inventory_source_id_filter: untyped?, ?inventory_source_type_filter: untyped?, ?keyword_filter: untyped?, ?marketplace_scope_filter: untyped?, ?match_type_filter: untyped?, ?max_results: Integer?, ?native_language_locale_filter: untyped?, ?negative_filter: untyped?, ?next_token: String?, ?product_id_filter: untyped?, ?state_filter: untyped?, ?target_id_filter: untyped?, ?target_type_filter: untyped?) -> HTTP::Response
-    def query_target(ad_product_filter:, ad_group_id_filter: nil, campaign_id_filter: nil, inventory_source_id_filter: nil, inventory_source_type_filter: nil, keyword_filter: nil, marketplace_scope_filter: nil, match_type_filter: nil, max_results: nil, native_language_locale_filter: nil, negative_filter: nil, next_token: nil, product_id_filter: nil, state_filter: nil, target_id_filter: nil, target_type_filter: nil)
-      request(:post, "/adsApi/v1/query/targets", json: { "adGroupIdFilter" => ad_group_id_filter, "adProductFilter" => ad_product_filter, "campaignIdFilter" => campaign_id_filter, "inventorySourceIdFilter" => inventory_source_id_filter, "inventorySourceTypeFilter" => inventory_source_type_filter, "keywordFilter" => keyword_filter, "marketplaceScopeFilter" => marketplace_scope_filter, "matchTypeFilter" => match_type_filter, "maxResults" => max_results, "nativeLanguageLocaleFilter" => native_language_locale_filter, "negativeFilter" => negative_filter, "nextToken" => next_token, "productIdFilter" => product_id_filter, "stateFilter" => state_filter, "targetIdFilter" => target_id_filter, "targetTypeFilter" => target_type_filter }.compact)
+    #: (ad_product_filter: untyped, ?ad_group_id_filter: untyped?, ?campaign_id_filter: untyped?, ?inventory_source_id_filter: untyped?, ?inventory_source_type_filter: untyped?, ?keyword_filter: untyped?, ?marketplace_scope_filter: untyped?, ?match_type_filter: untyped?, ?max_results: Integer?, ?native_language_locale_filter: untyped?, ?negative_filter: untyped?, ?next_token: String?, ?product_id_filter: untyped?, ?retailer_id_filter: untyped?, ?retailer_scope_filter: untyped?, ?state_filter: untyped?, ?target_id_filter: untyped?, ?target_type_filter: untyped?) -> HTTP::Response
+    def query_target(ad_product_filter:, ad_group_id_filter: nil, campaign_id_filter: nil, inventory_source_id_filter: nil, inventory_source_type_filter: nil, keyword_filter: nil, marketplace_scope_filter: nil, match_type_filter: nil, max_results: nil, native_language_locale_filter: nil, negative_filter: nil, next_token: nil, product_id_filter: nil, retailer_id_filter: nil, retailer_scope_filter: nil, state_filter: nil, target_id_filter: nil, target_type_filter: nil)
+      request(:post, "/adsApi/v1/query/targets", json: { "adGroupIdFilter" => ad_group_id_filter, "adProductFilter" => ad_product_filter, "campaignIdFilter" => campaign_id_filter, "inventorySourceIdFilter" => inventory_source_id_filter, "inventorySourceTypeFilter" => inventory_source_type_filter, "keywordFilter" => keyword_filter, "marketplaceScopeFilter" => marketplace_scope_filter, "matchTypeFilter" => match_type_filter, "maxResults" => max_results, "nativeLanguageLocaleFilter" => native_language_locale_filter, "negativeFilter" => negative_filter, "nextToken" => next_token, "productIdFilter" => product_id_filter, "retailerIdFilter" => retailer_id_filter, "retailerScopeFilter" => retailer_scope_filter, "stateFilter" => state_filter, "targetIdFilter" => target_id_filter, "targetTypeFilter" => target_type_filter }.compact)
     end
 
     # Update target

data/lib/amazon_ads/error.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require "http"
+require "json"
 
 module AmazonAds
   # Raised when the API or LWA responds with a 4xx or 5xx
@@ -8,15 +9,34 @@ module AmazonAds
     # The failed response
     attr_reader :response #: HTTP::Response?
 
+    # Amazon's error code, if the response carries one
+    attr_reader :code #: String?
+
+    # Returns the subclass in Errors matching the response's error code,
+    # falling back to Error when the code is unknown or missing
+    #
     #: (HTTP::Response) -> Error
     def self.build(response)
       response.flush # memoize the body while the connection is still readable
-      new(response.status.to_s, response)
+      code = parse_code(response)
+      klass = (code && Errors::CODES[code]) || Error
+      klass.new(response.status.to_s, response, code: code)
+    end
+
+    #: (HTTP::Response) -> String?
+    def self.parse_code(response)
+      body = JSON.parse(response.body.to_s)
+      code = body["code"] if body.is_a?(Hash)
+      code if code.is_a?(String)
+    rescue JSON::ParserError
+      nil
     end
+    private_class_method :parse_code
 
-    #: (?String?, ?HTTP::Response?) -> void
-    def initialize(msg = nil, response = nil)
+    #: (?String?, ?HTTP::Response?, ?code: String?) -> void
+    def initialize(msg = nil, response = nil, code: nil)
       @response = response
+      @code = code
       super(msg)
     end
 
@@ -25,16 +45,16 @@ module AmazonAds
       response&.status&.code
     end
 
-    # Supports pattern matching on status
+    # Supports pattern matching on status and code
     #
     #   case error
-    #   in status: 429 then backoff
+    #   in code: "TOO_MANY_REQUESTS" then backoff
     #   in status: 500..599 then retry
     #   end
     #
     #: (Array[Symbol]?) -> Hash[Symbol, untyped]
     def deconstruct_keys(keys)
-      hash = { status: status }
+      hash = { status: status, code: code }
       keys ? hash.slice(*keys) : hash
     end
   end

data/lib/amazon_ads/errors.rb

@@ -0,0 +1,286 @@
+# frozen_string_literal: true
+
+module AmazonAds
+  # Errors for the codes Amazon Ads documents in its ErrorCode enum
+  module Errors
+    # The request does not have access to the manager account provided in the registration request.
+    class AccessDeniedForManagerAccount < Error; end
+
+    # An advertiser account already exists with this display name.
+    class AccountAlreadyExistsForAccountName < Error; end
+
+    # An advertiser account already exists for this selling account.
+    class AccountAlreadyExistsForSellingAccount < Error; end
+
+    # An advertiser account already exists for the selected vendor.
+    class AccountAlreadyExistsForVendor < Error; end
+
+    # The request is not supported.
+    class ActionNotSupported < Error; end
+
+    # Too many live resources. Remove resources and try again.
+    class ActiveResourceLimitExceeded < Error; end
+
+    # Business name provided is too long.
+    class AddressBusinessNameTooLong < Error; end
+
+    # The state provided in business address is invalid.
+    class AddressInvalidState < Error; end
+
+    # New resources cannot be created within an archived parent.
+    class ArchivedParentCannotCreate < Error; end
+
+    # Resources within an archived parent cannot be edited.
+    class ArchivedParentCannotEdit < Error; end
+
+    # Archived resources cannot be edited.
+    class ArchivedResourceCannotEdit < Error; end
+
+    # The provided asset is still being processed.
+    class AssetNotReady < Error; end
+
+    # Autocreated entities cannot be edited. To complete this action, create the resource manually.
+    class AutocreatedEntityCannotEdit < Error; end
+
+    # The request is not valid considering the documented schema.
+    class BadRequest < Error; end
+
+    # Operation could not be completed due to a conflict. Please retry your request.
+    class Conflict < Error; end
+
+    # The request is too large. Consider splitting it into multiple requests.
+    class ContentTooLarge < Error; end
+
+    # Update the date to be in the future.
+    class DateCannotBeInPast < Error; end
+
+    # Update the date.
+    class DateCannotBeNull < Error; end
+
+    # Update the date to be further in the future.
+    class DateTooSoon < Error; end
+
+    # Multiple resources share the non-unique field values. Remove the non-unique field value.
+    class DuplicateFieldValueFound < Error; end
+
+    # Multiple resources share the same ID. Remove the duplicate ID.
+    class DuplicateResourceIdFound < Error; end
+
+    # Update the length to be within the required range.
+    class DurationTooShort < Error; end
+
+    # Feature has been discontinued.
+    class FeatureDiscontinued < Error; end
+
+    # The requested feature is not available.
+    class FeatureNotAvailable < Error; end
+
+    # Update the value to be within the required range.
+    class FieldSizeIsAboveMaximumLimit < Error; end
+
+    # Update the value to be within the required range.
+    class FieldSizeIsBelowMinimumLimit < Error; end
+
+    # Update the value to be within the required range.
+    class FieldSizeIsOutOfRange < Error; end
+
+    # Field value cannot be edited.
+    class FieldValueCannotEdit < Error; end
+
+    # Update the request with the required information for this resource.
+    class FieldValueContainsBlocklistedWords < Error; end
+
+    # Remove the invalid characters and try again.
+    class FieldValueContainsInvalidCharacters < Error; end
+
+    # Update the value to be within the required range.
+    class FieldValueIsAboveMaximumLimit < Error; end
+
+    # Update the value to be within the required range.
+    class FieldValueIsBelowMinimumLimit < Error; end
+
+    # Update the request with the required information for this resource.
+    class FieldValueIsEmpty < Error; end
+
+    # Update the request with the required information for this resource.
+    class FieldValueIsInvalid < Error; end
+
+    # Update the request with the required information for this resource.
+    class FieldValueIsNull < Error; end
+
+    # Update the value to be within the required range.
+    class FieldValueIsOutOfRange < Error; end
+
+    # Mismatch among resource field values.
+    class FieldValueMismatch < Error; end
+
+    # Update the request with the required information for this resource.
+    class FieldValueMustBeEmptyOrNull < Error; end
+
+    # Resource specified in the field value not found. Try again with valid value.
+    class FieldValueNotFound < Error; end
+
+    # Resource field value conflicts with existing resource. Try again with an unique field value.
+    class FieldValueNotUnique < Error; end
+
+    # The caller is not authorized to make the given request.
+    class Forbidden < Error; end
+
+    # The campaign is associated with a global campaign. Portfolio association cannot be updated on a child campaign. Please perform operation on the global campaign.
+    class GlobalAttributeUpdateRestrictedPortfolio < Error; end
+
+    # The campaign is associated with a global campaign. The state on child campaign cannot be set to archived. Please perform operation on global campaign.
+    class GlobalAttributeUpdateRestrictedState < Error; end
+
+    # The campaign is associated with a global campaign. Only one ad group can be created under this campaign.
+    class GlobalCampaignSingleAdgroupLimit < Error; end
+
+    # The server encountered an unexpected condition that prevented it from fulfilling the request.
+    class InternalError < Error; end
+
+    # The request has invalid input parameters.
+    class InvalidInput < Error; end
+
+    # The state provided in business address is invalid.
+    class InvalidStateOrRegion < Error; end
+
+    # The website url provided in business detail is invalid
+    class InvalidWebsiteUrl < Error; end
+
+    # The zip code provided in business address is invalid.
+    class InvalidZipCode < Error; end
+
+    # Address line 1 is missing in business address.
+    class MissingAddressLineOne < Error; end
+
+    # Business name is missing from business detail.
+    class MissingBusinessName < Error; end
+
+    # City is missing in business address.
+    class MissingCity < Error; end
+
+    # Country is missing in business address.
+    class MissingCountryCode < Error; end
+
+    # Phone number is missing from business detail.
+    class MissingPhoneNumber < Error; end
+
+    # State is missing in business address.
+    class MissingState < Error; end
+
+    # Website url is missing from business detail.
+    class MissingWebsiteUrl < Error; end
+
+    # Zip code is missing in business address.
+    class MissingZipCode < Error; end
+
+    # The requested resource does not exist.
+    class NotFound < Error; end
+
+    # Payment failed.
+    class PaymentIssue < Error; end
+
+    # Product is not eligible for advertising. Try again with a valid product.
+    class ProductIneligible < Error; end
+
+    # Resource does not belong to the specified parent. Try again with a valid parent ID.
+    class ResourceDoesNotBelongToParent < Error; end
+
+    # Resource ID not found. Try again with valid ID.
+    class ResourceIdNotFound < Error; end
+
+    # Update the request with the required information for this resource.
+    class ResourceIsEmpty < Error; end
+
+    # Resource is in terminal state.
+    class ResourceIsInTerminalState < Error; end
+
+    # Update the request with the required information for this resource.
+    class ResourceIsNull < Error; end
+
+    # There have been too many requests, please slow down your call rate.
+    class TooManyRequests < Error; end
+
+    # Too many resources. Remove resources and try again.
+    class TotalResourceLimitExceeded < Error; end
+
+    # The request lacks the necessary credentials.
+    class Unauthorized < Error; end
+
+    # Marketplace not supported. Try again with a supported marketplace.
+    class UnsupportedMarketplace < Error; end
+
+    # Maps Amazon's error codes to their classes
+    CODES = { #: Hash[String, singleton(Error)]
+      "ACCESS_DENIED_FOR_MANAGER_ACCOUNT" => AccessDeniedForManagerAccount,
+      "ACCOUNT_ALREADY_EXISTS_FOR_ACCOUNT_NAME" => AccountAlreadyExistsForAccountName,
+      "ACCOUNT_ALREADY_EXISTS_FOR_SELLING_ACCOUNT" => AccountAlreadyExistsForSellingAccount,
+      "ACCOUNT_ALREADY_EXISTS_FOR_VENDOR" => AccountAlreadyExistsForVendor,
+      "ACTION_NOT_SUPPORTED" => ActionNotSupported,
+      "ACTIVE_RESOURCE_LIMIT_EXCEEDED" => ActiveResourceLimitExceeded,
+      "ADDRESS_BUSINESS_NAME_TOO_LONG" => AddressBusinessNameTooLong,
+      "ADDRESS_INVALID_STATE" => AddressInvalidState,
+      "ARCHIVED_PARENT_CANNOT_CREATE" => ArchivedParentCannotCreate,
+      "ARCHIVED_PARENT_CANNOT_EDIT" => ArchivedParentCannotEdit,
+      "ARCHIVED_RESOURCE_CANNOT_EDIT" => ArchivedResourceCannotEdit,
+      "ASSET_NOT_READY" => AssetNotReady,
+      "AUTOCREATED_ENTITY_CANNOT_EDIT" => AutocreatedEntityCannotEdit,
+      "BAD_REQUEST" => BadRequest,
+      "CONFLICT" => Conflict,
+      "CONTENT_TOO_LARGE" => ContentTooLarge,
+      "DATE_CANNOT_BE_IN_PAST" => DateCannotBeInPast,
+      "DATE_CANNOT_BE_NULL" => DateCannotBeNull,
+      "DATE_TOO_SOON" => DateTooSoon,
+      "DUPLICATE_FIELD_VALUE_FOUND" => DuplicateFieldValueFound,
+      "DUPLICATE_RESOURCE_ID_FOUND" => DuplicateResourceIdFound,
+      "DURATION_TOO_SHORT" => DurationTooShort,
+      "FEATURE_DISCONTINUED" => FeatureDiscontinued,
+      "FEATURE_NOT_AVAILABLE" => FeatureNotAvailable,
+      "FIELD_SIZE_IS_ABOVE_MAXIMUM_LIMIT" => FieldSizeIsAboveMaximumLimit,
+      "FIELD_SIZE_IS_BELOW_MINIMUM_LIMIT" => FieldSizeIsBelowMinimumLimit,
+      "FIELD_SIZE_IS_OUT_OF_RANGE" => FieldSizeIsOutOfRange,
+      "FIELD_VALUE_CANNOT_EDIT" => FieldValueCannotEdit,
+      "FIELD_VALUE_CONTAINS_BLOCKLISTED_WORDS" => FieldValueContainsBlocklistedWords,
+      "FIELD_VALUE_CONTAINS_INVALID_CHARACTERS" => FieldValueContainsInvalidCharacters,
+      "FIELD_VALUE_IS_ABOVE_MAXIMUM_LIMIT" => FieldValueIsAboveMaximumLimit,
+      "FIELD_VALUE_IS_BELOW_MINIMUM_LIMIT" => FieldValueIsBelowMinimumLimit,
+      "FIELD_VALUE_IS_EMPTY" => FieldValueIsEmpty,
+      "FIELD_VALUE_IS_INVALID" => FieldValueIsInvalid,
+      "FIELD_VALUE_IS_NULL" => FieldValueIsNull,
+      "FIELD_VALUE_IS_OUT_OF_RANGE" => FieldValueIsOutOfRange,
+      "FIELD_VALUE_MISMATCH" => FieldValueMismatch,
+      "FIELD_VALUE_MUST_BE_EMPTY_OR_NULL" => FieldValueMustBeEmptyOrNull,
+      "FIELD_VALUE_NOT_FOUND" => FieldValueNotFound,
+      "FIELD_VALUE_NOT_UNIQUE" => FieldValueNotUnique,
+      "FORBIDDEN" => Forbidden,
+      "GLOBAL_ATTRIBUTE_UPDATE_RESTRICTED_PORTFOLIO" => GlobalAttributeUpdateRestrictedPortfolio,
+      "GLOBAL_ATTRIBUTE_UPDATE_RESTRICTED_STATE" => GlobalAttributeUpdateRestrictedState,
+      "GLOBAL_CAMPAIGN_SINGLE_ADGROUP_LIMIT" => GlobalCampaignSingleAdgroupLimit,
+      "INTERNAL_ERROR" => InternalError,
+      "INVALID_INPUT" => InvalidInput,
+      "INVALID_STATE_OR_REGION" => InvalidStateOrRegion,
+      "INVALID_WEBSITE_URL" => InvalidWebsiteUrl,
+      "INVALID_ZIP_CODE" => InvalidZipCode,
+      "MISSING_ADDRESS_LINE_ONE" => MissingAddressLineOne,
+      "MISSING_BUSINESS_NAME" => MissingBusinessName,
+      "MISSING_CITY" => MissingCity,
+      "MISSING_COUNTRY_CODE" => MissingCountryCode,
+      "MISSING_PHONE_NUMBER" => MissingPhoneNumber,
+      "MISSING_STATE" => MissingState,
+      "MISSING_WEBSITE_URL" => MissingWebsiteUrl,
+      "MISSING_ZIP_CODE" => MissingZipCode,
+      "NOT_FOUND" => NotFound,
+      "PAYMENT_ISSUE" => PaymentIssue,
+      "PRODUCT_INELIGIBLE" => ProductIneligible,
+      "RESOURCE_DOES_NOT_BELONG_TO_PARENT" => ResourceDoesNotBelongToParent,
+      "RESOURCE_ID_NOT_FOUND" => ResourceIdNotFound,
+      "RESOURCE_IS_EMPTY" => ResourceIsEmpty,
+      "RESOURCE_IS_IN_TERMINAL_STATE" => ResourceIsInTerminalState,
+      "RESOURCE_IS_NULL" => ResourceIsNull,
+      "TOO_MANY_REQUESTS" => TooManyRequests,
+      "TOTAL_RESOURCE_LIMIT_EXCEEDED" => TotalResourceLimitExceeded,
+      "UNAUTHORIZED" => Unauthorized,
+      "UNSUPPORTED_MARKETPLACE" => UnsupportedMarketplace,
+    }.freeze
+  end
+end

data/lib/amazon_ads/helpers/reporting.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+require "http"
+require "stringio"
+require "zlib"
+
+module AmazonAds
+  module Helpers
+    # Convenience methods for the Reporting API
+    module Reporting
+      # Downloads a report by report ID or presigned download URL
+      #
+      # @param report_id_or_url [String] The report identifier or download URL
+      # @return [HTTP::Response] The response containing decompressed report content
+      #: (String) -> HTTP::Response
+      def download_report(report_id_or_url)
+        url = if report_id_or_url.start_with?("http")
+          report_id_or_url
+        else
+          # @type var client: AmazonAds::Reporting
+          client = self
+          client.get_async_report(report_id_or_url).parse.fetch("url")
+        end
+
+        download_report_from_url(url)
+      end
+
+      private
+
+      #: (String) -> HTTP::Response
+      def download_report_from_url(url)
+        response = HTTP.use(:auto_inflate).get(url)
+        body = response.body.to_s
+        if body.b.start_with?("\x1F\x8B".b)
+          body = Zlib::GzipReader.new(StringIO.new(body)).read
+        end
+
+        headers = response.headers.to_h
+        headers["Content-Type"] ||= "application/json"
+
+        HTTP::Response.new(
+          status: response.code,
+          version: response.version,
+          headers: headers,
+          body: body,
+          request: response.request,
+        )
+      end
+    end
+  end
+end

data/lib/amazon_ads/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module AmazonAds
-  VERSION = "0.5.0"
+  VERSION = "0.7.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: amazon-ads
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.7.0
 platform: ruby
 authors:
 - Hakan Ensari
@@ -73,22 +73,35 @@ files:
 - lib/amazon_ads/apis/brand_store_pages.rb
 - lib/amazon_ads/apis/brand_stores.rb
 - lib/amazon_ads/apis/branded_keywords_pricings.rb
+- lib/amazon_ads/apis/buyer_seats.rb
 - lib/amazon_ads/apis/campaign_forecasts.rb
 - lib/amazon_ads/apis/campaigns.rb
 - lib/amazon_ads/apis/commitment_spends.rb
 - lib/amazon_ads/apis/commitments.rb
+- lib/amazon_ads/apis/deal_advertiser_access_entries.rb
+- lib/amazon_ads/apis/deal_advertiser_accesses.rb
+- lib/amazon_ads/apis/deal_availses.rb
+- lib/amazon_ads/apis/deal_performances.rb
+- lib/amazon_ads/apis/deal_planning_metricses.rb
 - lib/amazon_ads/apis/deal_preferences.rb
 - lib/amazon_ads/apis/geo_locations.rb
 - lib/amazon_ads/apis/keyword_reservation_validations.rb
+- lib/amazon_ads/apis/label_object_associations.rb
+- lib/amazon_ads/apis/labels.rb
 - lib/amazon_ads/apis/location_indexes.rb
 - lib/amazon_ads/apis/manager_accounts.rb
 - lib/amazon_ads/apis/marketing_stream.rb
+- lib/amazon_ads/apis/portfolios.rb
 - lib/amazon_ads/apis/profiles.rb
+- lib/amazon_ads/apis/publishers.rb
 - lib/amazon_ads/apis/recommendation_types.rb
 - lib/amazon_ads/apis/recommendations.rb
 - lib/amazon_ads/apis/reporting.rb
+- lib/amazon_ads/apis/reports.rb
 - lib/amazon_ads/apis/reserved_target_pricings.rb
+- lib/amazon_ads/apis/sellers.rb
 - lib/amazon_ads/apis/selling_accounts.rb
+- lib/amazon_ads/apis/stream_subscriptions.rb
 - lib/amazon_ads/apis/supplier_ad_product_prices.rb
 - lib/amazon_ads/apis/supplier_ad_products.rb
 - lib/amazon_ads/apis/supplier_proposal_destinations.rb
@@ -99,8 +112,11 @@ files:
 - lib/amazon_ads/apis/supplier_proposed_deals.rb
 - lib/amazon_ads/apis/supplier_publishers.rb
 - lib/amazon_ads/apis/supplier_target_items.rb
+- lib/amazon_ads/apis/suppliers.rb
 - lib/amazon_ads/apis/targets.rb
 - lib/amazon_ads/error.rb
+- lib/amazon_ads/errors.rb
+- lib/amazon_ads/helpers/reporting.rb
 - lib/amazon_ads/lwa.rb
 - lib/amazon_ads/version.rb
 homepage: https://github.com/lineofflight/amazon-ads-ruby
@@ -125,7 +141,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.16
+rubygems_version: 4.0.20
 specification_version: 4
 summary: Amazon Ads API client for Ruby
 test_files: []