amazon-ads 0.2.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 576fb2a70351a890db1f8792fb65fca433b06f9aa33ce4b037b674b2bcc8beff
-  data.tar.gz: 4326197b234cd8917b176645c7732a9ab77e66fc1fe79173907b7ff2c1640381
+  metadata.gz: 5e6d25250dfeb3f930a2c3253a1f0ed8da99226ba0d5290948b8e3ca8cfba483
+  data.tar.gz: 073acd8350a1446de8ea3a2ec207491506d3c996ffbad5d444b4bec2c77e2b7e
 SHA512:
-  metadata.gz: dac34993c1d5100be01ded6aedaf59bc6819bae76fb18817eff7839a43723468e1d54419f9ae4ba0b7cf8bb4cd53bd85a5a98cc6891b8804c9350728d167fc0c
-  data.tar.gz: 2f2de968113e103e2422b61687b1e01b10962c628c188d60e3c0dabc69895814bb216013e35744a8f17551b515f832179ed1a6e5c563ecbc5b74dd7ec66aa592
+  metadata.gz: ed62d0a64d560078cd3ca2d3d564e5cac7ae3e1da59ba00766fd4f0701b362d89980e879347e91f2ac5049176769580d9ce8cdc0e796770fdd24180a527023b4
+  data.tar.gz: 4e083231e7f90868aa5207b124f8affc757b452b8ce77d03319f83945822fa754e7e7b0286e9fb1b4271db327780b61b59746ef86dae28ba5fe4fcd44b6c91cc

data/README.md

@@ -42,31 +42,42 @@ Make requests:
 
 ```ruby
 # List advertising profiles
-profiles = AmazonAds::Profiles.new(region: :na, access_token: access_token)
+profiles = AmazonAds::Profiles.new(region: "NA", access_token:)
 profiles.list_profiles
 
 # List campaigns under a profile
 campaigns = AmazonAds::Campaigns.new(
-  region: :na,
-  access_token: access_token,
+  region: "NA",
+  access_token:,
   profile_id: "123456789",
 )
 campaigns.list_campaigns
 ```
 
-## Development
+## Error handling
 
-```bash
-bin/setup        # Install dependencies
-rake test        # Run tests
-rake rubocop     # Lint
-rake steep       # Type check
+Responses with a 4xx or 5xx status raise `AmazonAds::Error`, which carries the full response:
+
+```ruby
+begin
+  campaigns.list_campaigns
+rescue AmazonAds::Error => e
+  e.status         # 400
+  e.response.body  # Amazon's error document
+end
 ```
 
-## Contributing
+The error supports pattern matching on status:
 
-Bug reports and pull requests are welcome on [GitHub](https://github.com/lineofflight/amazon-ads-ruby).
+```ruby
+case error
+in status: 429 then backoff
+in status: 500..599 then retry
+end
+```
 
-## License
+Network failures (`HTTP::ConnectionError`, `HTTP::TimeoutError`) raise as-is, whether or not retries are configured.
+
+## Development
 
-MIT
+See [AGENTS.md](AGENTS.md).

data/lib/amazon_ads/api.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-# rbs_inline: enabled
-
 require "http"
 
 module AmazonAds
@@ -51,22 +49,28 @@ module AmazonAds
         .headers(default_headers)
         .use(:auto_inflate)
 
-      if retries.zero?
-        client.use(:raise_error)
-      else
-        client
-          .use(raise_error: { ignore: [429] })
-          .retriable(tries: retries + 1, retry_statuses: [429])
-      end
+      return client if retries.zero?
+
+      client.retriable(tries: retries + 1, retry_statuses: [429])
     end
 
     private
 
-    #: (Symbol, String, **untyped) -> HTTP::Response
+    #: (HTTP::verb, String, **untyped) -> HTTP::Response
     def request(method, path, **options)
       url = endpoint
       url.path = path
-      http.request(method, url, **options)
+      response = http.request(method, url.to_s, **options)
+      raise Error.build(response) if response.code >= 400
+
+      response
+    rescue HTTP::OutOfRetriesError => e
+      response = e.response
+      raise Error.build(response) if response
+
+      # No response means a transport error; re-raise as if never retried
+      cause = e.cause #: Exception
+      raise cause
     end
 
     #: () -> Hash[String, String]
@@ -77,8 +81,12 @@ module AmazonAds
         "Content-Type" => "application/json",
         "Accept" => "application/json",
       }
-      headers["Amazon-Advertising-API-Scope"] = profile_id if profile_id
-      headers["Amazon-Ads-AccountId"] = account_id if account_id
+      if (scope = profile_id)
+        headers["Amazon-Advertising-API-Scope"] = scope
+      end
+      if (account = account_id)
+        headers["Amazon-Ads-AccountId"] = account
+      end
 
       headers
     end

data/lib/amazon_ads/apis/ad_associations.rb

@@ -1,5 +1,4 @@
 # frozen_string_literal: true
-# rbs_inline: enabled
 
 module AmazonAds
   class AdAssociations < API
@@ -16,7 +15,7 @@ module AmazonAds
     end
 
     # Query Ad Association
-    #: (?ad_association_id_filter: String?, ?ad_group_id_filter: String?, ?ad_id_filter: String?, ?max_results: Integer?, ?next_token: String?) -> HTTP::Response
+    #: (?ad_association_id_filter: untyped?, ?ad_group_id_filter: untyped?, ?ad_id_filter: untyped?, ?max_results: Integer?, ?next_token: String?) -> HTTP::Response
     def query_ad_association(ad_association_id_filter: nil, ad_group_id_filter: nil, ad_id_filter: nil, max_results: nil, next_token: nil)
       request(:post, "/adsApi/v1/query/adAssociations", json: { "adAssociationIdFilter" => ad_association_id_filter, "adGroupIdFilter" => ad_group_id_filter, "adIdFilter" => ad_id_filter, "maxResults" => max_results, "nextToken" => next_token }.compact)
     end

data/lib/amazon_ads/apis/ad_extensions.rb

@@ -1,5 +1,4 @@
 # frozen_string_literal: true
-# rbs_inline: enabled
 
 module AmazonAds
   class AdExtensions < API
@@ -10,7 +9,7 @@ module AmazonAds
     end
 
     # Query ad_extension - API is in open beta
-    #: (?ad_extension_id_filter: String?, ?ad_extension_status_filter: String?, ?ad_extension_type_filter: String?, ?ad_group_id_filter: String?, ?ad_id_filter: String?, ?ad_product_filter: String?, ?max_results: Integer?, ?next_token: String?, ?state_filter: String?) -> HTTP::Response
+    #: (?ad_extension_id_filter: untyped?, ?ad_extension_status_filter: untyped?, ?ad_extension_type_filter: untyped?, ?ad_group_id_filter: untyped?, ?ad_id_filter: untyped?, ?ad_product_filter: untyped?, ?max_results: Integer?, ?next_token: String?, ?state_filter: untyped?) -> HTTP::Response
     def query_ad_extension(ad_extension_id_filter: nil, ad_extension_status_filter: nil, ad_extension_type_filter: nil, ad_group_id_filter: nil, ad_id_filter: nil, ad_product_filter: nil, max_results: nil, next_token: nil, state_filter: nil)
       request(:post, "/adsApi/v1/query/adExtensions", json: { "adExtensionIdFilter" => ad_extension_id_filter, "adExtensionStatusFilter" => ad_extension_status_filter, "adExtensionTypeFilter" => ad_extension_type_filter, "adGroupIdFilter" => ad_group_id_filter, "adIdFilter" => ad_id_filter, "adProductFilter" => ad_product_filter, "maxResults" => max_results, "nextToken" => next_token, "stateFilter" => state_filter }.compact)
     end

data/lib/amazon_ads/apis/ad_groups.rb

@@ -1,5 +1,4 @@
 # frozen_string_literal: true
-# rbs_inline: enabled
 
 module AmazonAds
   class AdGroups < API
@@ -16,7 +15,7 @@ module AmazonAds
     end
 
     # List ad groups
-    #: (ad_product_filter: String, ?ad_group_id_filter: String?, ?campaign_id_filter: String?, ?marketplace_scope_filter: String?, ?max_results: Integer?, ?name_filter: String?, ?next_token: String?, ?state_filter: String?) -> HTTP::Response
+    #: (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)
     end

data/lib/amazon_ads/apis/ads.rb

@@ -1,5 +1,4 @@
 # frozen_string_literal: true
-# rbs_inline: enabled
 
 module AmazonAds
   class Ads < API
@@ -16,7 +15,7 @@ module AmazonAds
     end
 
     # List ads
-    #: (ad_product_filter: String, ?ad_group_id_filter: String?, ?ad_id_filter: String?, ?campaign_id_filter: String?, ?marketplace_scope_filter: String?, ?max_results: Integer?, ?name_filter: String?, ?next_token: String?, ?state_filter: String?) -> HTTP::Response
+    #: (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)
     end

data/lib/amazon_ads/apis/advertising_deal_targets.rb

@@ -1,5 +1,4 @@
 # frozen_string_literal: true
-# rbs_inline: enabled
 
 module AmazonAds
   class AdvertisingDealTargets < API
@@ -16,7 +15,7 @@ module AmazonAds
     end
 
     # Query advertisingDealTarget
-    #: (advertising_deal_id_filter: String, ?max_results: Integer?, ?next_token: String?) -> HTTP::Response
+    #: (advertising_deal_id_filter: untyped, ?max_results: Integer?, ?next_token: String?) -> HTTP::Response
     def sb_query_advertising_deal_target(advertising_deal_id_filter:, max_results: nil, next_token: nil)
       request(:post, "/adsApi/v1/query/advertisingDealTargets/sb", json: { "advertisingDealIdFilter" => advertising_deal_id_filter, "maxResults" => max_results, "nextToken" => next_token }.compact)
     end

data/lib/amazon_ads/apis/advertising_deals.rb

@@ -1,5 +1,4 @@
 # frozen_string_literal: true
-# rbs_inline: enabled
 
 module AmazonAds
   class AdvertisingDeals < API
@@ -16,7 +15,7 @@ module AmazonAds
     end
 
     # Query advertisingDeal
-    #: (?advertising_deal_id_filter: String?, ?max_results: Integer?, ?name_filter: String?, ?next_token: String?) -> HTTP::Response
+    #: (?advertising_deal_id_filter: untyped?, ?max_results: Integer?, ?name_filter: untyped?, ?next_token: String?) -> HTTP::Response
     def sb_query_advertising_deal(advertising_deal_id_filter: nil, max_results: nil, name_filter: nil, next_token: nil)
       request(:post, "/adsApi/v1/query/advertisingDeals/sb", json: { "advertisingDealIdFilter" => advertising_deal_id_filter, "maxResults" => max_results, "nameFilter" => name_filter, "nextToken" => next_token }.compact)
     end

data/lib/amazon_ads/apis/brand_store_edition_publish_versions.rb

@@ -1,10 +1,9 @@
 # frozen_string_literal: true
-# rbs_inline: enabled
 
 module AmazonAds
   class BrandStoreEditionPublishVersions < API
     # Query store edition publish versions
-    #: (edition_id_filter: String, publish_status_filter: String, store_id_filter: String, ?max_results: Integer?, ?next_token: String?) -> HTTP::Response
+    #: (edition_id_filter: untyped, publish_status_filter: untyped, store_id_filter: untyped, ?max_results: Integer?, ?next_token: String?) -> HTTP::Response
     def query_brand_store_edition_publish_version(edition_id_filter:, publish_status_filter:, store_id_filter:, max_results: nil, next_token: nil)
       request(:post, "/adsApi/v1/query/brandStoreEditionPublishVersions", json: { "editionIdFilter" => edition_id_filter, "maxResults" => max_results, "nextToken" => next_token, "publishStatusFilter" => publish_status_filter, "storeIdFilter" => store_id_filter }.compact)
     end

data/lib/amazon_ads/apis/brand_store_editions.rb

@@ -1,5 +1,4 @@
 # frozen_string_literal: true
-# rbs_inline: enabled
 
 module AmazonAds
   class BrandStoreEditions < API

data/lib/amazon_ads/apis/brand_store_pages.rb

@@ -1,10 +1,9 @@
 # frozen_string_literal: true
-# rbs_inline: enabled
 
 module AmazonAds
   class BrandStorePages < API
     # Retrieve brand store page content
-    #: (edition_id_filter: String, page_id_filter: String, store_id_filter: String, ?max_results: Integer?, ?next_token: String?, ?store_edition_publish_id_filter: String?) -> HTTP::Response
+    #: (edition_id_filter: untyped, page_id_filter: untyped, store_id_filter: untyped, ?max_results: Integer?, ?next_token: String?, ?store_edition_publish_id_filter: untyped?) -> HTTP::Response
     def query_brand_store_page(edition_id_filter:, page_id_filter:, store_id_filter:, max_results: nil, next_token: nil, store_edition_publish_id_filter: nil)
       request(:post, "/adsApi/v1/query/brandStorePages", json: { "editionIdFilter" => edition_id_filter, "maxResults" => max_results, "nextToken" => next_token, "pageIdFilter" => page_id_filter, "storeEditionPublishIdFilter" => store_edition_publish_id_filter, "storeIdFilter" => store_id_filter }.compact)
     end

data/lib/amazon_ads/apis/brand_stores.rb

@@ -1,10 +1,9 @@
 # frozen_string_literal: true
-# rbs_inline: enabled
 
 module AmazonAds
   class BrandStores < API
     # Query brand store content
-    #: (store_name_filter: String, ?max_results: Integer?, ?next_token: String?, ?sort: Array[untyped]?) -> HTTP::Response
+    #: (store_name_filter: untyped, ?max_results: Integer?, ?next_token: String?, ?sort: Array[untyped]?) -> HTTP::Response
     def query_brand_store(store_name_filter:, max_results: nil, next_token: nil, sort: nil)
       request(:post, "/adsApi/v1/query/brandStores", json: { "maxResults" => max_results, "nextToken" => next_token, "sort" => sort, "storeNameFilter" => store_name_filter }.compact)
     end

data/lib/amazon_ads/apis/branded_keywords_pricings.rb

@@ -1,5 +1,4 @@
 # frozen_string_literal: true
-# rbs_inline: enabled
 
 module AmazonAds
   class BrandedKeywordsPricings < API

data/lib/amazon_ads/apis/campaign_forecasts.rb

@@ -1,5 +1,4 @@
 # frozen_string_literal: true
-# rbs_inline: enabled
 
 module AmazonAds
   class CampaignForecasts < API

data/lib/amazon_ads/apis/campaigns.rb

@@ -1,5 +1,4 @@
 # frozen_string_literal: true
-# rbs_inline: enabled
 
 module AmazonAds
   class Campaigns < API
@@ -16,7 +15,7 @@ module AmazonAds
     end
 
     # Query campaign
-    #: (ad_product_filter: String, ?campaign_id_filter: String?, ?goal_filter: String?, ?marketplace_scope_filter: String?, ?max_results: Integer?, ?name_filter: String?, ?next_token: String?, ?portfolio_id_filter: String?, ?state_filter: String?) -> HTTP::Response
+    #: (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)
     end

data/lib/amazon_ads/apis/commitment_spends.rb

@@ -1,5 +1,4 @@
 # frozen_string_literal: true
-# rbs_inline: enabled
 
 module AmazonAds
   class CommitmentSpends < API

data/lib/amazon_ads/apis/commitments.rb

@@ -1,5 +1,4 @@
 # frozen_string_literal: true
-# rbs_inline: enabled
 
 module AmazonAds
   class Commitments < API

data/lib/amazon_ads/apis/keyword_reservation_validations.rb

@@ -1,5 +1,4 @@
 # frozen_string_literal: true
-# rbs_inline: enabled
 
 module AmazonAds
   class KeywordReservationValidations < API

data/lib/amazon_ads/apis/marketing_stream.rb

@@ -1,5 +1,4 @@
 # frozen_string_literal: true
-# rbs_inline: enabled
 
 module AmazonAds
   # Amazon Marketing Stream
@@ -9,7 +8,7 @@ module AmazonAds
     # @rbs data_set_id: String -- Identifier of data set, callers can be subscribed to. Please refer to https://advertising.amazon.com/API/docs/en-us/amazon-marketing-stream/data-guide for the list of all data sets.
     # @rbs destination_arn: String -- AWS ARN of the destination endpoint associated with the subscription. Supported destination types: - SQS
     # @rbs notes: String -- Additional details associated with the subscription
-    #: (client_request_token: String, data_set_id: String, ?destination: String?, ?destination_arn: String?, ?notes: String?) -> HTTP::Response
+    #: (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" })
     end
@@ -19,7 +18,7 @@ module AmazonAds
     # @rbs data_set_id: String -- Identifier of data set, callers can be subscribed to. Please refer to https://advertising.amazon.com/API/docs/en-us/amazon-marketing-stream/data-guide for the list of all data sets.
     # @rbs destination_arn: String -- AWS ARN of the destination endpoint associated with the subscription. Supported destination types: - SQS
     # @rbs notes: String -- Additional details associated with the subscription
-    #: (client_request_token: String, data_set_id: String, ?destination: String?, ?destination_arn: String?, ?notes: String?) -> HTTP::Response
+    #: (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" })
     end
@@ -57,7 +56,7 @@ module AmazonAds
     # Update an existing subscription Note: trailing slash in request uri is not allowed
     # @rbs subscription_id: String -- Unique subscription identifier
     # @rbs notes: String -- Additional details associated with the subscription
-    #: (String, ?notes: String?, ?status: String?) -> HTTP::Response
+    #: (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" })
     end
@@ -65,7 +64,7 @@ module AmazonAds
     # Update an existing subscription Note: trailing slash in request uri is not allowed
     # @rbs subscription_id: String -- Unique subscription identifier
     # @rbs notes: String -- Additional details associated with the subscription
-    #: (String, ?notes: String?, ?status: String?) -> HTTP::Response
+    #: (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" })
     end

data/lib/amazon_ads/apis/profiles.rb

@@ -1,5 +1,4 @@
 # frozen_string_literal: true
-# rbs_inline: enabled
 
 module AmazonAds
   # Amazon Ads API - Profiles

data/lib/amazon_ads/apis/recommendation_types.rb

@@ -1,5 +1,4 @@
 # frozen_string_literal: true
-# rbs_inline: enabled
 
 module AmazonAds
   class RecommendationTypes < API

data/lib/amazon_ads/apis/recommendations.rb

@@ -1,5 +1,4 @@
 # frozen_string_literal: true
-# rbs_inline: enabled
 
 module AmazonAds
   class Recommendations < API

data/lib/amazon_ads/apis/reporting.rb

@@ -1,5 +1,4 @@
 # frozen_string_literal: true
-# rbs_inline: enabled
 
 module AmazonAds
   # Offline Report

data/lib/amazon_ads/apis/targets.rb

@@ -1,5 +1,4 @@
 # frozen_string_literal: true
-# rbs_inline: enabled
 
 module AmazonAds
   class Targets < API
@@ -16,7 +15,7 @@ module AmazonAds
     end
 
     # List target
-    #: (ad_product_filter: String, ?ad_group_id_filter: String?, ?campaign_id_filter: String?, ?keyword_filter: String?, ?marketplace_scope_filter: String?, ?match_type_filter: String?, ?max_results: Integer?, ?native_language_locale_filter: String?, ?negative_filter: String?, ?next_token: String?, ?product_id_filter: String?, ?state_filter: String?, ?target_id_filter: String?, ?target_type_filter: String?) -> HTTP::Response
+    #: (ad_product_filter: untyped, ?ad_group_id_filter: untyped?, ?campaign_id_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, 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, "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)
     end

data/lib/amazon_ads/error.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+require "http"
+
+module AmazonAds
+  # Raised when the API or LWA responds with a 4xx or 5xx
+  class Error < StandardError
+    # The failed response
+    attr_reader :response #: HTTP::Response?
+
+    #: (HTTP::Response) -> Error
+    def self.build(response)
+      response.flush # memoize the body while the connection is still readable
+      new(response.status.to_s, response)
+    end
+
+    #: (?String?, ?HTTP::Response?) -> void
+    def initialize(msg = nil, response = nil)
+      @response = response
+      super(msg)
+    end
+
+    #: () -> Integer?
+    def status
+      response&.status&.code
+    end
+
+    # Supports pattern matching on status
+    #
+    #   case error
+    #   in status: 429 then backoff
+    #   in status: 500..599 then retry
+    #   end
+    #
+    #: (Array[Symbol]?) -> Hash[Symbol, untyped]
+    def deconstruct_keys(keys)
+      hash = { status: status }
+      keys ? hash.slice(*keys) : hash
+    end
+  end
+end

data/lib/amazon_ads/lwa.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-# rbs_inline: enabled
-
 require "http"
 
 module AmazonAds
@@ -14,11 +12,9 @@ module AmazonAds
     # The OAuth refresh token
     attr_reader :refresh_token #: String
 
-    class << self
-      #: (**untyped) -> Hash[String, untyped]
-      def request(...)
-        new(...).request
-      end
+    #: (refresh_token: String, ?http: untyped) -> Hash[String, untyped]
+    def self.request(...)
+      new(...).request
     end
 
     #: (refresh_token: String, ?http: untyped) -> void
@@ -30,16 +26,14 @@ module AmazonAds
     # Requests a fresh access token from LWA
     #: () -> Hash[String, untyped]
     def request
-      http.post(URL, form: params).parse
+      response = @http.post(URL, form: params)
+      raise Error.build(response) if response.code >= 400
+
+      response.parse
     end
 
     private
 
-    #: () -> HTTP::Client
-    def http
-      @http.use(:raise_error)
-    end
-
     #: () -> Hash[Symbol, String]
     def params
       {

data/lib/amazon_ads/version.rb

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

data/lib/amazon_ads.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-# rbs_inline: enabled
-
 require "zeitwerk"
 
 loader = Zeitwerk::Loader.for_gem
@@ -13,38 +11,36 @@ loader.setup
 # Amazon Ads API client for Ruby
 module AmazonAds
   class << self
-    # Returns the client ID
-    # Falls back to the `AMAZON_ADS_CLIENT_ID` env var
-    #: () -> String?
-    def client_id
-      @client_id || ENV["AMAZON_ADS_CLIENT_ID"]
-    end
-
     # Sets the client ID
-    #: (String?) -> String?
-    attr_writer :client_id
-
-    # Returns the client ID or raises
-    #: () -> String
-    def client_id!
-      client_id or raise ArgumentError, "client id is required"
-    end
-
-    # Returns the client secret
-    # Falls back to the `AMAZON_ADS_CLIENT_SECRET` env var
-    #: () -> String?
-    def client_secret
-      @client_secret || ENV["AMAZON_ADS_CLIENT_SECRET"]
-    end
+    attr_writer :client_id #: String?
 
     # Sets the client secret
-    #: (String?) -> String?
-    attr_writer :client_secret
-
-    # Returns the client secret or raises
-    #: () -> String
-    def client_secret!
-      client_secret or raise ArgumentError, "client secret is required"
-    end
+    attr_writer :client_secret #: String?
+  end
+
+  # Returns the client ID
+  # Falls back to the `AMAZON_ADS_CLIENT_ID` env var
+  #: () -> String?
+  def self.client_id
+    @client_id || ENV["AMAZON_ADS_CLIENT_ID"]
+  end
+
+  # Returns the client ID or raises
+  #: () -> String
+  def self.client_id!
+    client_id or raise ArgumentError, "client id is required"
+  end
+
+  # Returns the client secret
+  # Falls back to the `AMAZON_ADS_CLIENT_SECRET` env var
+  #: () -> String?
+  def self.client_secret
+    @client_secret || ENV["AMAZON_ADS_CLIENT_SECRET"]
+  end
+
+  # Returns the client secret or raises
+  #: () -> String
+  def self.client_secret!
+    client_secret or raise ArgumentError, "client secret is required"
   end
 end