amazon-ads 0.1.0 → 0.3.0

data/lib/amazon_ads/apis/marketing_stream.rb

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+module AmazonAds
+  # Amazon Marketing Stream
+  class MarketingStream < API
+    # Create a new subscription Note: trailing slash in request uri is not allowed
+    # @rbs client_request_token: String -- Unique value supplied by the caller used to track identical API requests. Should request be re-tried, the caller should supply the same value. We recommend using GUID.
+    # @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: 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
+
+    # Create a new subscription Note: trailing slash in request uri is not allowed
+    # @rbs client_request_token: String -- Unique value supplied by the caller used to track identical API requests. Should request be re-tried, the caller should supply the same value. We recommend using GUID.
+    # @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: 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
+
+    # Fetch a specific subscription by Id Note: trailing slash in request uri is not allowed
+    # @rbs subscription_id: String -- Unique subscription identifier
+    #: (String) -> HTTP::Response
+    def get_dsp_stream_subscription(subscription_id)
+      request(:get, "/dsp/streams/subscriptions/#{subscription_id}")
+    end
+
+    # Fetch a specific subscription by Id Note: trailing slash in request uri is not allowed
+    # @rbs subscription_id: String -- Unique subscription identifier
+    #: (String) -> HTTP::Response
+    def get_stream_subscription(subscription_id)
+      request(:get, "/streams/subscriptions/#{subscription_id}")
+    end
+
+    # List subscriptions Note: trailing slash in request uri is not allowed
+    # @rbs max_results: Numeric -- desired number of entries in the response, defaults to maximum value
+    # @rbs starting_token: String -- Token which can be used to get the next page of results, if more entries exist
+    #: (?max_results: Numeric?, ?starting_token: String?) -> HTTP::Response
+    def list_dsp_stream_subscriptions(max_results: nil, starting_token: nil)
+      request(:get, "/dsp/streams/subscriptions", params: { "maxResults" => max_results, "startingToken" => starting_token }.compact)
+    end
+
+    # List subscriptions Note: trailing slash in request uri is not allowed
+    # @rbs max_results: Numeric -- desired number of entries in the response, defaults to maximum value
+    # @rbs starting_token: String -- Token which can be used to get the next page of results, if more entries exist
+    #: (?max_results: Numeric?, ?starting_token: String?) -> HTTP::Response
+    def list_stream_subscriptions(max_results: nil, starting_token: nil)
+      request(:get, "/streams/subscriptions", params: { "maxResults" => max_results, "startingToken" => starting_token }.compact)
+    end
+
+    # 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: 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
+
+    # 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: 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
+  end
+end

data/lib/amazon_ads/apis/profiles.rb

@@ -1,28 +1,28 @@
 # frozen_string_literal: true
 
-# rbs_inline: enabled
-
 module AmazonAds
   # Amazon Ads API - Profiles
-  #
-  # @see https://advertising.amazon.com/API/docs/en-us/reference/profiles
   class Profiles < API
+    # Gets a profile specified by identifier.
+    #: (Integer) -> HTTP::Response
+    def get_profile_by_id(profile_id)
+      request(:get, "/v2/profiles/#{profile_id}")
+    end
+
     # Gets a list of profiles.
-    #: (?api_program: String?, ?access_level: String?, ?profile_type_filter: String?, ?valid_payment_method_filter: String?) -> untyped
+    # @rbs api_program: String -- Filters response to include profiles that have permissions for the specified Advertising API program only. Setting `apiProgram=billing` filters the response to include only profiles to which the user and application associated with the access token have permission to view or edit billing information.
+    # @rbs access_level: String -- Filters response to include profiles that have specified permissions for the specified Advertising API program only. Currently, the only supported access level is `view` and `edit`. Setting `accessLevel=view` filters the response to include only profiles to which the user and application associated with the access token have view permission to the provided api program.
+    # @rbs profile_type_filter: String -- Filters response to include profiles that are of the specified types in the comma-delimited list. Default is all types. Note that this filter performs an inclusive AND operation on the types.
+    # @rbs valid_payment_method_filter: String -- Filter response to include profiles that have valid payment methods. Default is to include all profiles. Setting this filter to `true` returns only profiles with either no `validPaymentMethod` field, or the `validPaymentMethod` field set to `true`. Setting this to `false` returns profiles with the `validPaymentMethod` field set to `false` only.
+    #: (?api_program: String?, ?access_level: String?, ?profile_type_filter: String?, ?valid_payment_method_filter: String?) -> HTTP::Response
     def list_profiles(api_program: nil, access_level: nil, profile_type_filter: nil, valid_payment_method_filter: nil)
-      get("/v2/profiles", params: { "apiProgram" => api_program, "accessLevel" => access_level, "profileTypeFilter" => profile_type_filter, "validPaymentMethodFilter" => valid_payment_method_filter }.compact)
+      request(:get, "/v2/profiles", params: { "apiProgram" => api_program, "accessLevel" => access_level, "profileTypeFilter" => profile_type_filter, "validPaymentMethodFilter" => valid_payment_method_filter }.compact)
     end
 
     # Update the daily budget for one or more profiles.
-    #: (?body: Hash[String, untyped]) -> untyped
-    def update_profiles(body: {})
-      put("/v2/profiles", body: body)
-    end
-
-    # Gets a profile specified by identifier.
-    #: (Integer) -> untyped
-    def get_profile_by_id(profile_id)
-      get("/v2/profiles/#{profile_id}")
+    #: (?json: untyped) -> HTTP::Response
+    def update_profiles(json: {})
+      request(:put, "/v2/profiles", json: json)
     end
   end
 end

data/lib/amazon_ads/apis/recommendation_types.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module AmazonAds
+  class RecommendationTypes < API
+    # Query RecommendationTypes
+    #: (?max_results: Integer?, ?next_token: String?) -> HTTP::Response
+    def sb_query_recommendation_type(max_results: nil, next_token: nil)
+      request(:post, "/adsApi/v1/query/recommendationTypes/sb", json: { "maxResults" => max_results, "nextToken" => next_token }.compact)
+    end
+  end
+end

data/lib/amazon_ads/apis/recommendations.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module AmazonAds
+  class Recommendations < API
+    # Create recommendations
+    #: (?recommendations: Array[untyped]?) -> HTTP::Response
+    def sb_create_recommendation(recommendations: nil)
+      request(:post, "/adsApi/v1/create/recommendations/sb", json: { "recommendations" => recommendations }.compact)
+    end
+  end
+end

data/lib/amazon_ads/apis/reporting.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module AmazonAds
+  # Offline Report
+  class Reporting < API
+    # 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" })
+    end
+
+    # Deletes a report by id
+    # @rbs report_id: String -- The identifier of the requested report.
+    #: (String) -> HTTP::Response
+    def delete_async_report(report_id)
+      request(:delete, "/reporting/reports/#{report_id}")
+    end
+
+    # Gets a generation status of report by id
+    # @rbs report_id: String -- The identifier of the requested report.
+    #: (String) -> HTTP::Response
+    def get_async_report(report_id)
+      request(:get, "/reporting/reports/#{report_id}")
+    end
+  end
+end

data/lib/amazon_ads/apis/targets.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module AmazonAds
+  class Targets < API
+    # Create target
+    #: (?targets: Array[untyped]?) -> HTTP::Response
+    def create_target(targets: nil)
+      request(:post, "/adsApi/v1/create/targets", json: { "targets" => targets }.compact)
+    end
+
+    # Delete target
+    #: (?target_ids: Array[untyped]?) -> HTTP::Response
+    def delete_target(target_ids: nil)
+      request(:post, "/adsApi/v1/delete/targets", json: { "targetIds" => target_ids }.compact)
+    end
+
+    # List target
+    #: (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
+
+    # Update target
+    #: (?targets: Array[untyped]?) -> HTTP::Response
+    def update_target(targets: nil)
+      request(:post, "/adsApi/v1/update/targets", json: { "targets" => targets }.compact)
+    end
+  end
+end

data/lib/amazon_ads/lwa.rb

@@ -1,84 +1,59 @@
 # frozen_string_literal: true
 
-# rbs_inline: enabled
-
 require "http"
 
 module AmazonAds
-  # Requests Login with Amazon (LWA) access tokens for the Amazon Ads API.
-  # Handles token caching and automatic refresh when tokens expire.
-  #
-  # @see https://advertising.amazon.com/API/docs/en-us/info/api-overview
+  # Requests Login with Amazon (LWA) access tokens for the Amazon Ads API
+  # Stateless: each call to #request hits the token endpoint; the caller
+  # owns caching
   class LWA
     URL = "https://api.amazon.com/auth/o2/token" #: String
-    TOKEN_EXPIRY_BUFFER = 60 #: Integer
 
-    attr_reader :client_id #: String
-    attr_reader :client_secret #: String
+    # The OAuth refresh token
     attr_reader :refresh_token #: String
 
-    #: (?client_id: String, ?client_secret: String, ?refresh_token: String) -> void
-    def initialize(
-      client_id: ENV.fetch("AMAZON_ADS_CLIENT_ID"),
-      client_secret: ENV.fetch("AMAZON_ADS_CLIENT_SECRET"),
-      refresh_token: ENV.fetch("AMAZON_ADS_REFRESH_TOKEN")
-    )
-      @client_id = client_id
-      @client_secret = client_secret
-      @refresh_token = refresh_token
-      @access_token = nil #: String?
-      @expires_at = nil #: Time?
-      @mutex = Mutex.new
-    end
-
-    # Returns a valid access token, refreshing if necessary.
-    #: () -> String
-    def access_token
-      @mutex.synchronize do
-        refresh! if token_expired?
-        @access_token or raise AmazonAds::AuthenticationError, "Failed to obtain access token"
-      end
+    #: (refresh_token: String, ?http: untyped) -> Hash[String, untyped]
+    def self.request(...)
+      new(...).request
     end
 
-    # Forces a token refresh regardless of expiry.
-    #: () -> String
-    def refresh!
-      response = HTTP.post(URL, form: params)
-
-      unless response.status.success?
-        body = begin
-          response.parse
-        rescue StandardError
-          {}
-        end
-        message = body["error_description"] || body["error"] || "Authentication failed"
-        raise AmazonAds::AuthenticationError.new(message, response: response)
-      end
-
-      data = response.parse
-      @access_token = data.fetch("access_token")
-      expires_in = data.fetch("expires_in", 3600)
-      @expires_at = Time.now + expires_in - TOKEN_EXPIRY_BUFFER
-
-      @access_token
+    #: (refresh_token: String, ?http: untyped) -> void
+    def initialize(refresh_token:, http: HTTP)
+      @refresh_token = refresh_token
+      @http = http
     end
 
-    # Returns true if the token is expired or not yet fetched.
-    #: () -> bool
-    def token_expired?
-      @access_token.nil? || @expires_at.nil? || Time.now >= @expires_at
+    # Requests a fresh access token from LWA
+    #: () -> Hash[String, untyped]
+    def request
+      http.post(URL, form: params).parse
     end
 
     private
 
-    #: () -> Hash[String, String]
+    #: () -> HTTP::Client
+    def http
+      @http.use(:raise_error)
+    end
+
+    #: () -> Hash[Symbol, String]
     def params
       {
-        "grant_type" => "refresh_token",
-        "client_id" => client_id,
-        "client_secret" => client_secret,
-        "refresh_token" => refresh_token,
+        grant_type: "refresh_token",
+        client_id:,
+        client_secret:,
+        refresh_token:,
       }
     end
+
+    #: () -> String
+    def client_id
+      AmazonAds.client_id!
+    end
+
+    #: () -> String
+    def client_secret
+      AmazonAds.client_secret!
+    end
   end
 end

data/lib/amazon_ads/version.rb

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

data/lib/amazon_ads.rb

@@ -1,37 +1,46 @@
 # frozen_string_literal: true
 
-# rbs_inline: enabled
-
 require "zeitwerk"
 
 loader = Zeitwerk::Loader.for_gem
 loader.inflector.inflect("api" => "API", "lwa" => "LWA")
 loader.collapse("#{__dir__}/amazon_ads/apis")
 loader.ignore("#{__dir__}/generator")
-loader.ignore("#{__dir__}/amazon_ads/errors.rb")
 loader.setup
 
-require_relative "amazon_ads/errors"
-
 # Amazon Ads API client for Ruby
 module AmazonAds
   class << self
-    # Returns the global configuration object.
-    #: () -> Configuration
-    def configuration
-      @configuration ||= Configuration.new
-    end
-
-    # Configures the AmazonAds library.
-    #: () { (Configuration) -> void } -> void
-    def configure
-      yield(configuration)
-    end
-
-    # Resets the configuration to defaults.
-    #: () -> void
-    def reset_configuration!
-      @configuration = Configuration.new
-    end
+    # Sets the client ID
+    attr_writer :client_id #: String?
+
+    # Sets the client secret
+    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

metadata

@@ -1,28 +1,42 @@
 --- !ruby/object:Gem::Specification
 name: amazon-ads
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Hakan Ensari
-bindir: exe
+bindir: bin
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: cgi
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: http
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.3'
+        version: '6.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.3'
+        version: '6.0'
 - !ruby/object:Gem::Dependency
   name: zeitwerk
   requirement: !ruby/object:Gem::Requirement
@@ -47,21 +61,30 @@ files:
 - README.md
 - lib/amazon_ads.rb
 - lib/amazon_ads/api.rb
+- lib/amazon_ads/apis/ad_associations.rb
+- lib/amazon_ads/apis/ad_extensions.rb
+- lib/amazon_ads/apis/ad_groups.rb
+- lib/amazon_ads/apis/ads.rb
+- lib/amazon_ads/apis/advertising_deal_targets.rb
+- lib/amazon_ads/apis/advertising_deals.rb
+- lib/amazon_ads/apis/brand_store_edition_publish_versions.rb
+- lib/amazon_ads/apis/brand_store_editions.rb
+- 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/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/keyword_reservation_validations.rb
+- lib/amazon_ads/apis/marketing_stream.rb
 - lib/amazon_ads/apis/profiles.rb
-- lib/amazon_ads/apis/sponsored_products.rb
-- lib/amazon_ads/client.rb
-- lib/amazon_ads/configuration.rb
-- lib/amazon_ads/errors.rb
+- lib/amazon_ads/apis/recommendation_types.rb
+- lib/amazon_ads/apis/recommendations.rb
+- lib/amazon_ads/apis/reporting.rb
+- lib/amazon_ads/apis/targets.rb
 - lib/amazon_ads/lwa.rb
 - lib/amazon_ads/version.rb
-- sig/generated/amazon_ads.rbs
-- sig/generated/amazon_ads/api.rbs
-- sig/generated/amazon_ads/apis/profiles.rbs
-- sig/generated/amazon_ads/apis/sponsored_products.rbs
-- sig/generated/amazon_ads/client.rbs
-- sig/generated/amazon_ads/configuration.rbs
-- sig/generated/amazon_ads/errors.rbs
-- sig/generated/amazon_ads/lwa.rbs
 homepage: https://github.com/lineofflight/amazon-ads-ruby
 licenses:
 - MIT
@@ -77,14 +100,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.2.0
+      version: '3.3'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.3
+rubygems_version: 4.0.16
 specification_version: 4
 summary: Amazon Ads API client for Ruby
 test_files: []

data/lib/amazon_ads/apis/sponsored_products.rb

@@ -1,76 +0,0 @@
-# frozen_string_literal: true
-
-# rbs_inline: enabled
-
-module AmazonAds
-  # Amazon Ads API - Sponsored Products
-  #
-  # @see https://advertising.amazon.com/API/docs/en-us/sponsored-products
-  class SponsoredProducts < API
-    # Gets a bid recommendation for an ad group. [PLANNED DEPRECATION 3/27/2024]
-    #: (Numeric) -> untyped
-    def get_ad_group_bid_recommendations(ad_group_id)
-      get("/v2/sp/adGroups/#{ad_group_id}/bidRecommendations")
-    end
-
-    # Gets a bid recommendation for a keyword. [PLANNED DEPRECATION 3/27/2024]
-    #: (Numeric) -> untyped
-    def get_keyword_bid_recommendations(keyword_id)
-      get("/v2/sp/keywords/#{keyword_id}/bidRecommendations")
-    end
-
-    # Gets bid recommendations for keywords. [PLANNED DEPRECATION 3/27/2024]
-    #: (?body: Hash[String, untyped]) -> untyped
-    def create_keyword_bid_recommendations(body: {})
-      post("/v2/sp/keywords/bidRecommendations", body: body)
-    end
-
-    # Gets suggested keywords for the specified ad group.
-    #: (Numeric, ?max_num_suggestions: Integer?, ?ad_state_filter: String?) -> untyped
-    def get_ad_group_suggested_keywords(ad_group_id, max_num_suggestions: nil, ad_state_filter: nil)
-      get("/v2/sp/adGroups/#{ad_group_id}/suggested/keywords", params: { "maxNumSuggestions" => max_num_suggestions, "adStateFilter" => ad_state_filter }.compact)
-    end
-
-    # Gets suggested keywords with extended data for the specified ad group.
-    #: (Numeric, ?max_num_suggestions: Integer?, ?suggest_bids: String?, ?ad_state_filter: String?) -> untyped
-    def get_ad_group_suggested_keywords_ex(ad_group_id, max_num_suggestions: nil, suggest_bids: nil, ad_state_filter: nil)
-      get("/v2/sp/adGroups/#{ad_group_id}/suggested/keywords/extended", params: { "maxNumSuggestions" => max_num_suggestions, "suggestBids" => suggest_bids, "adStateFilter" => ad_state_filter }.compact)
-    end
-
-    # Gets suggested keywords for the specified ASIN.
-    #: (String, ?max_num_suggestions: Integer?) -> untyped
-    def get_asin_suggested_keywords(asin_value, max_num_suggestions: nil)
-      get("/v2/sp/asins/#{asin_value}/suggested/keywords", params: { "maxNumSuggestions" => max_num_suggestions }.compact)
-    end
-
-    # Gets suggested keyword for a specified list of ASINs.
-    #: (?body: Hash[String, untyped]) -> untyped
-    def bulk_get_asin_suggested_keywords(body: {})
-      post("/v2/sp/asins/suggested/keywords", body: body)
-    end
-
-    # Gets a list of bid recommendations for keyword, product, or auto targeting expressions.
-    #: (?body: Hash[String, untyped]) -> untyped
-    def get_bid_recommendations(body: {})
-      post("/v2/sp/targets/bidRecommendations", body: body)
-    end
-
-    # Request a snapshot
-    #: (String, ?body: Hash[String, untyped]) -> untyped
-    def request_snapshot(record_type, body: {})
-      post("/v2/sp/#{record_type}/snapshot", body: body)
-    end
-
-    # Get the status of a requested snapshot
-    #: (Numeric) -> untyped
-    def get_snapshot_status(snapshot_id)
-      get("/v2/sp/snapshots/#{snapshot_id}")
-    end
-
-    # Download requested snapshot
-    #: (Numeric) -> untyped
-    def download_snapshot(snapshot_id)
-      get("/v2/sp/snapshots/#{snapshot_id}/download")
-    end
-  end
-end

data/lib/amazon_ads/client.rb

@@ -1,38 +0,0 @@
-# frozen_string_literal: true
-
-# rbs_inline: enabled
-
-module AmazonAds
-  # High-level client for Amazon Ads API.
-  # Provides convenient access to all API endpoints with automatic authentication.
-  class Client
-    attr_reader :lwa #: LWA
-    attr_reader :region #: Symbol
-    attr_reader :profile_id #: String?
-
-    #: (?region: Symbol, ?profile_id: String?, ?lwa: LWA?) -> void
-    def initialize(region: AmazonAds.configuration.region, profile_id: AmazonAds.configuration.profile_id, lwa: nil)
-      @lwa = lwa || AmazonAds.configuration.lwa
-      @region = region
-      @profile_id = profile_id
-    end
-
-    # Access Profiles API
-    #: () -> Profiles
-    def profiles
-      @profiles ||= Profiles.new(region: region, lwa: lwa, profile_id: profile_id)
-    end
-
-    # Access Sponsored Products API
-    #: () -> SponsoredProducts
-    def sponsored_products
-      @sponsored_products ||= SponsoredProducts.new(region: region, lwa: lwa, profile_id: profile_id)
-    end
-
-    # Creates a new client with a different profile ID
-    #: (String) -> Client
-    def with_profile(profile_id)
-      Client.new(region: region, profile_id: profile_id, lwa: lwa)
-    end
-  end
-end

data/lib/amazon_ads/configuration.rb

@@ -1,34 +0,0 @@
-# frozen_string_literal: true
-
-# rbs_inline: enabled
-
-module AmazonAds
-  # Configuration for the AmazonAds library.
-  # Centralizes settings for authentication and API access.
-  class Configuration
-    attr_accessor :client_id #: String?
-    attr_accessor :client_secret #: String?
-    attr_accessor :refresh_token #: String?
-    attr_accessor :region #: Symbol
-    attr_accessor :profile_id #: String?
-
-    #: () -> void
-    def initialize
-      @client_id = ENV["AMAZON_ADS_CLIENT_ID"]
-      @client_secret = ENV["AMAZON_ADS_CLIENT_SECRET"]
-      @refresh_token = ENV["AMAZON_ADS_REFRESH_TOKEN"]
-      @region = :na
-      @profile_id = nil
-    end
-
-    # Builds an LWA instance from the configuration.
-    #: () -> LWA
-    def lwa
-      LWA.new(
-        client_id: client_id || raise(ArgumentError, "client_id is required"),
-        client_secret: client_secret || raise(ArgumentError, "client_secret is required"),
-        refresh_token: refresh_token || raise(ArgumentError, "refresh_token is required"),
-      )
-    end
-  end
-end