peddler 3.0.0.beta1 → 3.0.0

data/lib/peddler/api/aplus_content_2020_11_01.rb

@@ -3,6 +3,12 @@
 require "peddler/api"
 
 module Peddler
+  class << self
+    def aplus_content_2020_11_01(...)
+      API::AplusContent20201101.new(...)
+    end
+  end
+
   class API
     # Selling Partner API for A+ Content Management
     #
@@ -15,92 +21,108 @@ module Peddler
       # metadata of the A+ Content documents. Call the getContentDocument operation to get the actual contents of the A+
       # Content documents.
       #
-      # @param [String] marketplace_id The identifier for the marketplace where the A+ Content is published.
-      # @param [String] page_token A page token from the nextPageToken response element returned by your previous call
+      # @param marketplace_id [String] The identifier for the marketplace where the A+ Content is published.
+      # @param page_token [String] A page token from the nextPageToken response element returned by your previous call
       #   to this operation. nextPageToken is returned when the results of a call exceed the page size. To get the next
       #   page of results, call the operation and include pageToken as the only parameter. Specifying pageToken with any
       #   other parameter will cause the request to fail. When no nextPageToken value is returned there are no more
       #   pages to return. A pageToken value is not usable across different operations.
+      # @param rate_limit [Float] Requests per second
       # @return [Hash] The API response
-      def search_content_documents(marketplace_id, page_token: nil)
+      def search_content_documents(marketplace_id, page_token: nil, rate_limit: 10.0)
+        cannot_sandbox!
+
         path = "/aplus/2020-11-01/contentDocuments"
         params = {
           "marketplaceId" => marketplace_id,
           "pageToken" => page_token,
         }.compact
 
-        rate_limit(10.0).get(path, params:)
+        meter(rate_limit).get(path, params:)
       end
 
       # Creates a new A+ Content document.
       #
-      # @param [String] marketplace_id The identifier for the marketplace where the A+ Content is published.
-      # @param [Hash] post_content_document_request The content document request details.
+      # @param marketplace_id [String] The identifier for the marketplace where the A+ Content is published.
+      # @param post_content_document_request [Hash] The content document request details.
+      # @param rate_limit [Float] Requests per second
       # @return [Hash] The API response
-      def create_content_document(marketplace_id, post_content_document_request)
+      def create_content_document(marketplace_id, post_content_document_request, rate_limit: 10.0)
+        cannot_sandbox!
+
         path = "/aplus/2020-11-01/contentDocuments"
         body = post_content_document_request
         params = {
           "marketplaceId" => marketplace_id,
         }.compact
 
-        rate_limit(10.0).post(path, body:, params:)
+        meter(rate_limit).post(path, body:, params:)
       end
 
       # Returns an A+ Content document, if available.
       #
-      # @param [String] content_reference_key The unique reference key for the A+ Content document. A content reference
+      # @param content_reference_key [String] The unique reference key for the A+ Content document. A content reference
       #   key cannot form a permalink and may change in the future. A content reference key is not guaranteed to match
       #   any A+ Content identifier.
-      # @param [String] marketplace_id The identifier for the marketplace where the A+ Content is published.
-      # @param [Array<String>] included_data_set The set of A+ Content data types to include in the response.
+      # @param marketplace_id [String] The identifier for the marketplace where the A+ Content is published.
+      # @param included_data_set [Array<String>] The set of A+ Content data types to include in the response.
+      # @param rate_limit [Float] Requests per second
       # @return [Hash] The API response
-      def get_content_document(content_reference_key, marketplace_id, included_data_set)
+      def get_content_document(content_reference_key, marketplace_id, included_data_set, rate_limit: 10.0)
+        cannot_sandbox!
+
         path = "/aplus/2020-11-01/contentDocuments/#{content_reference_key}"
         params = {
           "marketplaceId" => marketplace_id,
           "includedDataSet" => included_data_set,
         }.compact
 
-        rate_limit(10.0).get(path, params:)
+        meter(rate_limit).get(path, params:)
       end
 
       # Updates an existing A+ Content document.
       #
-      # @param [String] content_reference_key The unique reference key for the A+ Content document. A content reference
+      # @param content_reference_key [String] The unique reference key for the A+ Content document. A content reference
       #   key cannot form a permalink and may change in the future. A content reference key is not guaranteed to match
       #   any A+ Content identifier.
-      # @param [String] marketplace_id The identifier for the marketplace where the A+ Content is published.
-      # @param [Hash] post_content_document_request The content document request details.
+      # @param marketplace_id [String] The identifier for the marketplace where the A+ Content is published.
+      # @param post_content_document_request [Hash] The content document request details.
+      # @param rate_limit [Float] Requests per second
       # @return [Hash] The API response
-      def update_content_document(content_reference_key, marketplace_id, post_content_document_request)
+      def update_content_document(content_reference_key, marketplace_id, post_content_document_request,
+        rate_limit: 10.0)
+        cannot_sandbox!
+
         path = "/aplus/2020-11-01/contentDocuments/#{content_reference_key}"
         body = post_content_document_request
         params = {
           "marketplaceId" => marketplace_id,
         }.compact
 
-        rate_limit(10.0).post(path, body:, params:)
+        meter(rate_limit).post(path, body:, params:)
       end
 
       # Returns a list of ASINs related to the specified A+ Content document, if available. If you do not include the
       # asinSet parameter, the operation returns all ASINs related to the content document.
       #
-      # @param [String] content_reference_key The unique reference key for the A+ Content document. A content reference
+      # @param content_reference_key [String] The unique reference key for the A+ Content document. A content reference
       #   key cannot form a permalink and may change in the future. A content reference key is not guaranteed to match
       #   any A+ Content identifier.
-      # @param [String] marketplace_id The identifier for the marketplace where the A+ Content is published.
-      # @param [Array<String>] included_data_set The set of A+ Content data types to include in the response. If you do
+      # @param marketplace_id [String] The identifier for the marketplace where the A+ Content is published.
+      # @param included_data_set [Array<String>] The set of A+ Content data types to include in the response. If you do
       #   not include this parameter, the operation returns the related ASINs without metadata.
-      # @param [Array<String>] asin_set The set of ASINs.
-      # @param [String] page_token A page token from the nextPageToken response element returned by your previous call
+      # @param asin_set [Array<String>] The set of ASINs.
+      # @param page_token [String] A page token from the nextPageToken response element returned by your previous call
       #   to this operation. nextPageToken is returned when the results of a call exceed the page size. To get the next
       #   page of results, call the operation and include pageToken as the only parameter. Specifying pageToken with any
       #   other parameter will cause the request to fail. When no nextPageToken value is returned there are no more
       #   pages to return. A pageToken value is not usable across different operations.
+      # @param rate_limit [Float] Requests per second
       # @return [Hash] The API response
       def list_content_document_asin_relations(content_reference_key, marketplace_id, included_data_set: nil,
-        asin_set: nil, page_token: nil)
+        asin_set: nil, page_token: nil, rate_limit: 10.0)
+        cannot_sandbox!
+
         path = "/aplus/2020-11-01/contentDocuments/#{content_reference_key}/asins"
         params = {
           "marketplaceId" => marketplace_id,
@@ -109,37 +131,44 @@ module Peddler
           "pageToken" => page_token,
         }.compact
 
-        rate_limit(10.0).get(path, params:)
+        meter(rate_limit).get(path, params:)
       end
 
       # Replaces all ASINs related to the specified A+ Content document, if available. This may add or remove ASINs,
       # depending on the current set of related ASINs. Removing an ASIN has the side effect of suspending the content
       # document from that ASIN.
       #
-      # @param [String] content_reference_key The unique reference key for the A+ Content document. A content reference
+      # @param content_reference_key [String] The unique reference key for the A+ Content document. A content reference
       #   key cannot form a permalink and may change in the future. A content reference key is not guaranteed to match
       #   any A+ content identifier.
-      # @param [String] marketplace_id The identifier for the marketplace where the A+ Content is published.
-      # @param [Hash] post_content_document_asin_relations_request The content document ASIN relations request details.
+      # @param marketplace_id [String] The identifier for the marketplace where the A+ Content is published.
+      # @param post_content_document_asin_relations_request [Hash] The content document ASIN relations request details.
+      # @param rate_limit [Float] Requests per second
       # @return [Hash] The API response
       def post_content_document_asin_relations(content_reference_key, marketplace_id,
-        post_content_document_asin_relations_request)
+        post_content_document_asin_relations_request, rate_limit: 10.0)
+        cannot_sandbox!
+
         path = "/aplus/2020-11-01/contentDocuments/#{content_reference_key}/asins"
         body = post_content_document_asin_relations_request
         params = {
           "marketplaceId" => marketplace_id,
         }.compact
 
-        rate_limit(10.0).post(path, body:, params:)
+        meter(rate_limit).post(path, body:, params:)
       end
 
       # Checks if the A+ Content document is valid for use on a set of ASINs.
       #
-      # @param [String] marketplace_id The identifier for the marketplace where the A+ Content is published.
-      # @param [Array<String>] asin_set The set of ASINs.
-      # @param [Hash] post_content_document_request The content document request details.
+      # @param marketplace_id [String] The identifier for the marketplace where the A+ Content is published.
+      # @param asin_set [Array<String>] The set of ASINs.
+      # @param post_content_document_request [Hash] The content document request details.
+      # @param rate_limit [Float] Requests per second
       # @return [Hash] The API response
-      def validate_content_document_asin_relations(marketplace_id, post_content_document_request, asin_set: nil)
+      def validate_content_document_asin_relations(marketplace_id, post_content_document_request, asin_set: nil,
+        rate_limit: 10.0)
+        cannot_sandbox!
+
         path = "/aplus/2020-11-01/contentAsinValidations"
         body = post_content_document_request
         params = {
@@ -147,20 +176,23 @@ module Peddler
           "asinSet" => asin_set,
         }.compact
 
-        rate_limit(10.0).post(path, body:, params:)
+        meter(rate_limit).post(path, body:, params:)
       end
 
       # Searches for A+ Content publishing records, if available.
       #
-      # @param [String] marketplace_id The identifier for the marketplace where the A+ Content is published.
-      # @param [String] asin The Amazon Standard Identification Number (ASIN).
-      # @param [String] page_token A page token from the nextPageToken response element returned by your previous call
+      # @param marketplace_id [String] The identifier for the marketplace where the A+ Content is published.
+      # @param asin [String] The Amazon Standard Identification Number (ASIN).
+      # @param page_token [String] A page token from the nextPageToken response element returned by your previous call
       #   to this operation. nextPageToken is returned when the results of a call exceed the page size. To get the next
       #   page of results, call the operation and include pageToken as the only parameter. Specifying pageToken with any
       #   other parameter will cause the request to fail. When no nextPageToken value is returned there are no more
       #   pages to return. A pageToken value is not usable across different operations.
+      # @param rate_limit [Float] Requests per second
       # @return [Hash] The API response
-      def search_content_publish_records(marketplace_id, asin, page_token: nil)
+      def search_content_publish_records(marketplace_id, asin, page_token: nil, rate_limit: 10.0)
+        cannot_sandbox!
+
         path = "/aplus/2020-11-01/contentPublishRecords"
         params = {
           "marketplaceId" => marketplace_id,
@@ -168,40 +200,46 @@ module Peddler
           "pageToken" => page_token,
         }.compact
 
-        rate_limit(10.0).get(path, params:)
+        meter(rate_limit).get(path, params:)
       end
 
       # Submits an A+ Content document for review, approval, and publishing.
       #
-      # @param [String] content_reference_key The unique reference key for the A+ Content document. A content reference
+      # @param content_reference_key [String] The unique reference key for the A+ Content document. A content reference
       #   key cannot form a permalink and may change in the future. A content reference key is not guaranteed to match
       #   any A+ content identifier.
-      # @param [String] marketplace_id The identifier for the marketplace where the A+ Content is published.
+      # @param marketplace_id [String] The identifier for the marketplace where the A+ Content is published.
+      # @param rate_limit [Float] Requests per second
       # @return [Hash] The API response
-      def post_content_document_approval_submission(content_reference_key, marketplace_id)
+      def post_content_document_approval_submission(content_reference_key, marketplace_id, rate_limit: 10.0)
+        cannot_sandbox!
+
         path = "/aplus/2020-11-01/contentDocuments/#{content_reference_key}/approvalSubmissions"
         params = {
           "marketplaceId" => marketplace_id,
         }.compact
 
-        rate_limit(10.0).post(path, params:)
+        meter(rate_limit).post(path, params:)
       end
 
       # Submits a request to suspend visible A+ Content. This neither deletes the content document nor the ASIN
       # relations.
       #
-      # @param [String] content_reference_key The unique reference key for the A+ Content document. A content reference
+      # @param content_reference_key [String] The unique reference key for the A+ Content document. A content reference
       #   key cannot form a permalink and may change in the future. A content reference key is not guaranteed to match
       #   any A+ content identifier.
-      # @param [String] marketplace_id The identifier for the marketplace where the A+ Content is published.
+      # @param marketplace_id [String] The identifier for the marketplace where the A+ Content is published.
+      # @param rate_limit [Float] Requests per second
       # @return [Hash] The API response
-      def post_content_document_suspend_submission(content_reference_key, marketplace_id)
+      def post_content_document_suspend_submission(content_reference_key, marketplace_id, rate_limit: 10.0)
+        cannot_sandbox!
+
         path = "/aplus/2020-11-01/contentDocuments/#{content_reference_key}/suspendSubmissions"
         params = {
           "marketplaceId" => marketplace_id,
         }.compact
 
-        rate_limit(10.0).post(path, params:)
+        meter(rate_limit).post(path, params:)
       end
     end
   end

data/lib/peddler/api/application_integrations_2024_04_01.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+require "peddler/api"
+
+module Peddler
+  class << self
+    def application_integrations_2024_04_01(...)
+      API::ApplicationIntegrations20240401.new(...)
+    end
+  end
+
+  class API
+    # The Selling Partner API for third party application integrations.
+    #
+    # With the AppIntegrations API v2024-04-01, you can send notifications to Amazon Selling Partners and display the
+    # notifications in Seller Central.
+    class ApplicationIntegrations20240401 < API
+      # Create a notification for sellers in Seller Central.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param body [Hash] The request body for the `createNotification` operation.
+      # @param rate_limit [Float] Requests per second
+      # @return [Hash] The API response
+      def create_notification(body, rate_limit: 1.0)
+        path = "/appIntegrations/2024-04-01/notifications"
+
+        meter(rate_limit).post(path, body:)
+      end
+
+      # Remove your application's notifications from the Appstore notifications dashboard.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param body [Hash] The request body for the `deleteNotifications` operation.
+      # @param rate_limit [Float] Requests per second
+      # @return [Hash] The API response
+      def delete_notifications(body, rate_limit: 1.0)
+        path = "/appIntegrations/2024-04-01/notifications/deletion"
+
+        meter(rate_limit).post(path, body:)
+      end
+
+      # Records the seller's response to a notification.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param notification_id [String] A `notificationId` uniquely identifies a notification.
+      # @param body [Hash] The request body for the `recordActionFeedback` operation.
+      # @param rate_limit [Float] Requests per second
+      # @return [Hash] The API response
+      def record_action_feedback(notification_id, body, rate_limit: 1.0)
+        path = "/appIntegrations/2024-04-01/notifications/#{notification_id}/feedback"
+
+        meter(rate_limit).post(path, body:)
+      end
+    end
+  end
+end

data/lib/peddler/api/application_management_2023_11_30.rb

@@ -3,6 +3,12 @@
 require "peddler/api"
 
 module Peddler
+  class << self
+    def application_management_2023_11_30(...)
+      API::ApplicationManagement20231130.new(...)
+    end
+  end
+
   class API
     # Selling Partner API for Application Management
     #
@@ -14,11 +20,15 @@ module Peddler
       # generated and sent to the developer-registered queue. For more information, refer to [Rotate your application
       # client
       # secret](https://developer-docs.amazon.com/sp-api/v0/docs/application-management-api-v2023-11-30-use-case-guide#tutorial-rotate-your-applications-client-secret).
+      #
+      # @param rate_limit [Float] Requests per second
       # @return [Hash] The API response
-      def rotate_application_client_secret
+      def rotate_application_client_secret(rate_limit: 0.0167)
+        cannot_sandbox!
+
         path = "/applications/2023-11-30/clientSecret"
 
-        rate_limit(0.0167).post(path)
+        meter(rate_limit).post(path)
       end
     end
   end

data/lib/peddler/api/catalog_items_2020_12_01.rb

@@ -3,32 +3,41 @@
 require "peddler/api"
 
 module Peddler
+  class << self
+    def catalog_items_2020_12_01(...)
+      API::CatalogItems20201201.new(...)
+    end
+  end
+
   class API
     # Selling Partner API for Catalog Items
     #
     # The Selling Partner API for Catalog Items provides programmatic access to information about items in the Amazon
-    # catalog. For more information, see the [Catalog Items API Use Case
-    # Guide](doc:catalog-items-api-v2020-12-01-use-case-guide).
+    # catalog. For more information, see the
+    # {https://developer-docs.amazon.com/sp-api/docs/catalog-items-api-v2020-12-01-use-case-guide Catalog Items API Use
+    # Case Guide}.
     class CatalogItems20201201 < API
       # Search for and return a list of Amazon catalog items and associated information.
       #
-      # @param [Array<String>] keywords A comma-delimited list of words or item identifiers to search the Amazon catalog
+      # @note This operation can make a static sandbox call.
+      # @param keywords [Array<String>] A comma-delimited list of words or item identifiers to search the Amazon catalog
       #   for.
-      # @param [Array<String>] marketplace_ids A comma-delimited list of Amazon marketplace identifiers for the request.
-      # @param [Array<String>] included_data A comma-delimited list of data sets to include in the response. Default:
+      # @param marketplace_ids [Array<String>] A comma-delimited list of Amazon marketplace identifiers for the request.
+      # @param included_data [Array<String>] A comma-delimited list of data sets to include in the response. Default:
       #   summaries.
-      # @param [Array<String>] brand_names A comma-delimited list of brand names to limit the search to.
-      # @param [Array<String>] classification_ids A comma-delimited list of classification identifiers to limit the
+      # @param brand_names [Array<String>] A comma-delimited list of brand names to limit the search to.
+      # @param classification_ids [Array<String>] A comma-delimited list of classification identifiers to limit the
       #   search to.
-      # @param [Integer] page_size Number of results to be returned per page.
-      # @param [String] page_token A token to fetch a certain page when there are multiple pages worth of results.
-      # @param [String] keywords_locale The language the keywords are provided in. Defaults to the primary locale of the
+      # @param page_size [Integer] Number of results to be returned per page.
+      # @param page_token [String] A token to fetch a certain page when there are multiple pages worth of results.
+      # @param keywords_locale [String] The language the keywords are provided in. Defaults to the primary locale of the
       #   marketplace.
-      # @param [String] locale Locale for retrieving localized summaries. Defaults to the primary locale of the
+      # @param locale [String] Locale for retrieving localized summaries. Defaults to the primary locale of the
       #   marketplace.
+      # @param rate_limit [Float] Requests per second
       # @return [Hash] The API response
-      def search_catalog_items(keywords, marketplace_ids, included_data: nil, brand_names: nil,
-        classification_ids: nil, page_size: nil, page_token: nil, keywords_locale: nil, locale: nil)
+      def search_catalog_items(keywords, marketplace_ids, included_data: "summaries", brand_names: nil,
+        classification_ids: nil, page_size: 10, page_token: nil, keywords_locale: nil, locale: nil, rate_limit: 2.0)
         path = "/catalog/2020-12-01/items"
         params = {
           "keywords" => keywords,
@@ -42,20 +51,22 @@ module Peddler
           "locale" => locale,
         }.compact
 
-        rate_limit(2.0).get(path, params:)
+        meter(rate_limit).get(path, params:)
       end
 
       # Retrieves details for an item in the Amazon catalog.
       #
-      # @param [String] asin The Amazon Standard Identification Number (ASIN) of the item.
-      # @param [Array<String>] marketplace_ids A comma-delimited list of Amazon marketplace identifiers. Data sets in
+      # @note This operation can make a static sandbox call.
+      # @param asin [String] The Amazon Standard Identification Number (ASIN) of the item.
+      # @param marketplace_ids [Array<String>] A comma-delimited list of Amazon marketplace identifiers. Data sets in
       #   the response contain data only for the specified marketplaces.
-      # @param [Array<String>] included_data A comma-delimited list of data sets to include in the response. Default:
+      # @param included_data [Array<String>] A comma-delimited list of data sets to include in the response. Default:
       #   summaries.
-      # @param [String] locale Locale for retrieving localized summaries. Defaults to the primary locale of the
+      # @param locale [String] Locale for retrieving localized summaries. Defaults to the primary locale of the
       #   marketplace.
+      # @param rate_limit [Float] Requests per second
       # @return [Hash] The API response
-      def get_catalog_item(asin, marketplace_ids, included_data: nil, locale: nil)
+      def get_catalog_item(asin, marketplace_ids, included_data: "summaries", locale: nil, rate_limit: 2.0)
         path = "/catalog/2020-12-01/items/#{asin}"
         params = {
           "marketplaceIds" => marketplace_ids,
@@ -63,7 +74,7 @@ module Peddler
           "locale" => locale,
         }.compact
 
-        rate_limit(2.0).get(path, params:)
+        meter(rate_limit).get(path, params:)
       end
     end
   end

data/lib/peddler/api/catalog_items_2022_04_01.rb

@@ -3,42 +3,50 @@
 require "peddler/api"
 
 module Peddler
+  class << self
+    def catalog_items_2022_04_01(...)
+      API::CatalogItems20220401.new(...)
+    end
+  end
+
   class API
     # Selling Partner API for Catalog Items
     #
     # The Selling Partner API for Catalog Items provides programmatic access to information about items in the Amazon
-    # catalog. For more information, refer to the [Catalog Items API Use Case
-    # Guide](doc:catalog-items-api-v2022-04-01-use-case-guide).
+    # catalog. For more information, refer to the
+    # {https://developer-docs.amazon.com/sp-api/docs/catalog-items-api-v2022-04-01-use-case-guide Catalog Items API Use
+    # Case Guide}.
     class CatalogItems20220401 < API
       # Search for and return a list of Amazon catalog items and associated information either by identifier or by
       # keywords.
       #
-      # @param [Array<String>] identifiers A comma-delimited list of product identifiers to search the Amazon catalog
+      # @note This operation can make a static sandbox call.
+      # @param identifiers [Array<String>] A comma-delimited list of product identifiers to search the Amazon catalog
       #   for. **Note:** Cannot be used with `keywords`.
-      # @param [String] identifiers_type Type of product identifiers to search the Amazon catalog for. **Note:**
+      # @param identifiers_type [String] Type of product identifiers to search the Amazon catalog for. **Note:**
       #   Required when `identifiers` are provided.
-      # @param [Array<String>] marketplace_ids A comma-delimited list of Amazon marketplace identifiers for the request.
-      # @param [Array<String>] included_data A comma-delimited list of data sets to include in the response. Default:
+      # @param marketplace_ids [Array<String>] A comma-delimited list of Amazon marketplace identifiers for the request.
+      # @param included_data [Array<String>] A comma-delimited list of data sets to include in the response. Default:
       #   `summaries`.
-      # @param [String] locale Locale for retrieving localized summaries. Defaults to the primary locale of the
+      # @param locale [String] Locale for retrieving localized summaries. Defaults to the primary locale of the
       #   marketplace.
-      # @param [String] seller_id A selling partner identifier, such as a seller account or vendor code. **Note:**
+      # @param seller_id [String] A selling partner identifier, such as a seller account or vendor code. **Note:**
       #   Required when `identifiersType` is `SKU`.
-      # @param [Array<String>] keywords A comma-delimited list of words to search the Amazon catalog for. **Note:**
+      # @param keywords [Array<String>] A comma-delimited list of words to search the Amazon catalog for. **Note:**
       #   Cannot be used with `identifiers`.
-      # @param [Array<String>] brand_names A comma-delimited list of brand names to limit the search for
+      # @param brand_names [Array<String>] A comma-delimited list of brand names to limit the search for
       #   `keywords`-based queries. **Note:** Cannot be used with `identifiers`.
-      # @param [Array<String>] classification_ids A comma-delimited list of classification identifiers to limit the
+      # @param classification_ids [Array<String>] A comma-delimited list of classification identifiers to limit the
       #   search for `keywords`-based queries. **Note:** Cannot be used with `identifiers`.
-      # @param [Integer] page_size Number of results to be returned per page.
-      # @param [String] page_token A token to fetch a certain page when there are multiple pages worth of results.
-      # @param [String] keywords_locale The language of the keywords provided for `keywords`-based queries. Defaults to
+      # @param page_size [Integer] Number of results to be returned per page.
+      # @param page_token [String] A token to fetch a certain page when there are multiple pages worth of results.
+      # @param keywords_locale [String] The language of the keywords provided for `keywords`-based queries. Defaults to
       #   the primary locale of the marketplace. **Note:** Cannot be used with `identifiers`.
+      # @param rate_limit [Float] Requests per second
       # @return [Hash] The API response
-      def search_catalog_items(
-        marketplace_ids, identifiers: nil, identifiers_type: nil, included_data: nil, locale: nil, seller_id: nil,
-        keywords: nil, brand_names: nil, classification_ids: nil, page_size: nil, page_token: nil, keywords_locale: nil
-      )
+      def search_catalog_items(marketplace_ids, identifiers: nil, identifiers_type: nil, included_data: ["summaries"],
+        locale: nil, seller_id: nil, keywords: nil, brand_names: nil, classification_ids: nil, page_size: 10,
+        page_token: nil, keywords_locale: nil, rate_limit: 2.0)
         path = "/catalog/2022-04-01/items"
         params = {
           "identifiers" => identifiers,
@@ -55,20 +63,22 @@ module Peddler
           "keywordsLocale" => keywords_locale,
         }.compact
 
-        rate_limit(2.0).get(path, params:)
+        meter(rate_limit).get(path, params:)
       end
 
       # Retrieves details for an item in the Amazon catalog.
       #
-      # @param [String] asin The Amazon Standard Identification Number (ASIN) of the item.
-      # @param [Array<String>] marketplace_ids A comma-delimited list of Amazon marketplace identifiers. Data sets in
+      # @note This operation can make a static sandbox call.
+      # @param asin [String] The Amazon Standard Identification Number (ASIN) of the item.
+      # @param marketplace_ids [Array<String>] A comma-delimited list of Amazon marketplace identifiers. Data sets in
       #   the response contain data only for the specified marketplaces.
-      # @param [Array<String>] included_data A comma-delimited list of data sets to include in the response. Default:
+      # @param included_data [Array<String>] A comma-delimited list of data sets to include in the response. Default:
       #   `summaries`.
-      # @param [String] locale Locale for retrieving localized summaries. Defaults to the primary locale of the
+      # @param locale [String] Locale for retrieving localized summaries. Defaults to the primary locale of the
       #   marketplace.
+      # @param rate_limit [Float] Requests per second
       # @return [Hash] The API response
-      def get_catalog_item(asin, marketplace_ids, included_data: nil, locale: nil)
+      def get_catalog_item(asin, marketplace_ids, included_data: ["summaries"], locale: nil, rate_limit: 2.0)
         path = "/catalog/2022-04-01/items/#{asin}"
         params = {
           "marketplaceIds" => marketplace_ids,
@@ -76,7 +86,7 @@ module Peddler
           "locale" => locale,
         }.compact
 
-        rate_limit(2.0).get(path, params:)
+        meter(rate_limit).get(path, params:)
       end
     end
   end