peddler 2.4.5 → 3.0.0

data/lib/peddler/api/amazon_warehousing_and_distribution_2024_05_09.rb

@@ -0,0 +1,92 @@
+# frozen_string_literal: true
+
+require "peddler/api"
+
+module Peddler
+  class << self
+    def amazon_warehousing_and_distribution_2024_05_09(...)
+      API::AmazonWarehousingAndDistribution20240509.new(...)
+    end
+  end
+
+  class API
+    # The Selling Partner API for Amazon Warehousing and Distribution
+    #
+    # The Selling Partner API for Amazon Warehousing and Distribution (AWD) provides programmatic access to information
+    # about AWD shipments and inventory.
+    class AmazonWarehousingAndDistribution20240509 < API
+      # Retrieves an AWD inbound shipment.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param shipment_id [String] ID for the shipment. A shipment contains the cases being inbounded.
+      # @param sku_quantities [String] If equal to `SHOW`, the response includes the shipment SKU quantity details.
+      #   Defaults to `HIDE`, in which case the response does not contain SKU quantities
+      # @param rate_limit [Float] Requests per second
+      # @return [Hash] The API response
+      def get_inbound_shipment(shipment_id, sku_quantities: nil, rate_limit: 2.0)
+        path = "/awd/2024-05-09/inboundShipments/#{shipment_id}"
+        params = {
+          "skuQuantities" => sku_quantities,
+        }.compact
+
+        meter(rate_limit).get(path, params:)
+      end
+
+      # Retrieves a summary of all the inbound AWD shipments associated with a merchant, with the ability to apply
+      # optional filters.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param sort_by [String] Field to sort results by. By default, the response will be sorted by UPDATED_AT.
+      # @param sort_order [String] Sort the response in ASCENDING or DESCENDING order. By default, the response will be
+      #   sorted in DESCENDING order.
+      # @param shipment_status [String] Filter by inbound shipment status.
+      # @param updated_after [String] List the inbound shipments that were updated after a certain time (inclusive). The
+      #   date must be in {https://developer-docs.amazon.com/sp-api/docs/iso-8601 ISO 8601} format.
+      # @param updated_before [String] List the inbound shipments that were updated before a certain time (inclusive).
+      #   The date must be in {https://developer-docs.amazon.com/sp-api/docs/iso-8601 ISO 8601} format.
+      # @param max_results [Integer] Maximum number of results to return.
+      # @param next_token [String] Token to retrieve the next set of paginated results.
+      # @param rate_limit [Float] Requests per second
+      # @return [Hash] The API response
+      def list_inbound_shipments(sort_by: nil, sort_order: nil, shipment_status: nil, updated_after: nil,
+        updated_before: nil, max_results: 25, next_token: nil, rate_limit: 1.0)
+        path = "/awd/2024-05-09/inboundShipments"
+        params = {
+          "sortBy" => sort_by,
+          "sortOrder" => sort_order,
+          "shipmentStatus" => shipment_status,
+          "updatedAfter" => updated_after,
+          "updatedBefore" => updated_before,
+          "maxResults" => max_results,
+          "nextToken" => next_token,
+        }.compact
+
+        meter(rate_limit).get(path, params:)
+      end
+
+      # Lists AWD inventory associated with a merchant with the ability to apply optional filters.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param sku [String] Filter by seller or merchant SKU for the item.
+      # @param sort_order [String] Sort the response in `ASCENDING` or `DESCENDING` order.
+      # @param details [String] Set to `SHOW` to return summaries with additional inventory details. Defaults to `HIDE,`
+      #   which returns only inventory summary totals.
+      # @param next_token [String] Token to retrieve the next set of paginated results.
+      # @param max_results [Integer] Maximum number of results to return.
+      # @param rate_limit [Float] Requests per second
+      # @return [Hash] The API response
+      def list_inventory(sku: nil, sort_order: nil, details: nil, next_token: nil, max_results: 25, rate_limit: 2.0)
+        path = "/awd/2024-05-09/inventory"
+        params = {
+          "sku" => sku,
+          "sortOrder" => sort_order,
+          "details" => details,
+          "nextToken" => next_token,
+          "maxResults" => max_results,
+        }.compact
+
+        meter(rate_limit).get(path, params:)
+      end
+    end
+  end
+end

data/lib/peddler/api/aplus_content_2020_11_01.rb

@@ -0,0 +1,246 @@
+# frozen_string_literal: true
+
+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
+    #
+    # With the A+ Content API, you can build applications that help selling partners add rich marketing content to their
+    # Amazon product detail pages. A+ content helps selling partners share their brand and product story, which helps
+    # buyers make informed purchasing decisions. Selling partners assemble content by choosing from content modules and
+    # adding images and text.
+    class AplusContent20201101 < API
+      # Returns a list of all A+ Content documents assigned to a selling partner. This operation returns only the
+      # metadata of the A+ Content documents. Call the getContentDocument operation to get the actual contents of the A+
+      # Content documents.
+      #
+      # @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, rate_limit: 10.0)
+        cannot_sandbox!
+
+        path = "/aplus/2020-11-01/contentDocuments"
+        params = {
+          "marketplaceId" => marketplace_id,
+          "pageToken" => page_token,
+        }.compact
+
+        meter(rate_limit).get(path, params:)
+      end
+
+      # Creates a new A+ Content document.
+      #
+      # @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, rate_limit: 10.0)
+        cannot_sandbox!
+
+        path = "/aplus/2020-11-01/contentDocuments"
+        body = post_content_document_request
+        params = {
+          "marketplaceId" => marketplace_id,
+        }.compact
+
+        meter(rate_limit).post(path, body:, params:)
+      end
+
+      # Returns an A+ Content document, if available.
+      #
+      # @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 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, rate_limit: 10.0)
+        cannot_sandbox!
+
+        path = "/aplus/2020-11-01/contentDocuments/#{content_reference_key}"
+        params = {
+          "marketplaceId" => marketplace_id,
+          "includedDataSet" => included_data_set,
+        }.compact
+
+        meter(rate_limit).get(path, params:)
+      end
+
+      # Updates an existing A+ Content document.
+      #
+      # @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 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,
+        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
+
+        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 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 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 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, rate_limit: 10.0)
+        cannot_sandbox!
+
+        path = "/aplus/2020-11-01/contentDocuments/#{content_reference_key}/asins"
+        params = {
+          "marketplaceId" => marketplace_id,
+          "includedDataSet" => included_data_set,
+          "asinSet" => asin_set,
+          "pageToken" => page_token,
+        }.compact
+
+        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 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 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, 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
+
+        meter(rate_limit).post(path, body:, params:)
+      end
+
+      # Checks if the A+ Content document is valid for use on a set of ASINs.
+      #
+      # @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,
+        rate_limit: 10.0)
+        cannot_sandbox!
+
+        path = "/aplus/2020-11-01/contentAsinValidations"
+        body = post_content_document_request
+        params = {
+          "marketplaceId" => marketplace_id,
+          "asinSet" => asin_set,
+        }.compact
+
+        meter(rate_limit).post(path, body:, params:)
+      end
+
+      # Searches for A+ Content publishing records, if available.
+      #
+      # @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, rate_limit: 10.0)
+        cannot_sandbox!
+
+        path = "/aplus/2020-11-01/contentPublishRecords"
+        params = {
+          "marketplaceId" => marketplace_id,
+          "asin" => asin,
+          "pageToken" => page_token,
+        }.compact
+
+        meter(rate_limit).get(path, params:)
+      end
+
+      # Submits an A+ Content document for review, approval, and publishing.
+      #
+      # @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 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, rate_limit: 10.0)
+        cannot_sandbox!
+
+        path = "/aplus/2020-11-01/contentDocuments/#{content_reference_key}/approvalSubmissions"
+        params = {
+          "marketplaceId" => marketplace_id,
+        }.compact
+
+        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 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 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, rate_limit: 10.0)
+        cannot_sandbox!
+
+        path = "/aplus/2020-11-01/contentDocuments/#{content_reference_key}/suspendSubmissions"
+        params = {
+          "marketplaceId" => marketplace_id,
+        }.compact
+
+        meter(rate_limit).post(path, params:)
+      end
+    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

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+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
+    #
+    # The Selling Partner API for Application Management lets you programmatically update the client secret on
+    # registered applications.
+    class ApplicationManagement20231130 < API
+      # Rotates application client secrets for a developer application. Developers must register a destination queue in
+      # the developer console before calling this operation. When this operation is called a new client secret is
+      # 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(rate_limit: 0.0167)
+        cannot_sandbox!
+
+        path = "/applications/2023-11-30/clientSecret"
+
+        meter(rate_limit).post(path)
+      end
+    end
+  end
+end

data/lib/peddler/api/catalog_items_2020_12_01.rb

@@ -0,0 +1,81 @@
+# frozen_string_literal: true
+
+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
+    # {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.
+      #
+      # @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 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 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 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 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: "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,
+          "marketplaceIds" => marketplace_ids,
+          "includedData" => included_data,
+          "brandNames" => brand_names,
+          "classificationIds" => classification_ids,
+          "pageSize" => page_size,
+          "pageToken" => page_token,
+          "keywordsLocale" => keywords_locale,
+          "locale" => locale,
+        }.compact
+
+        meter(rate_limit).get(path, params:)
+      end
+
+      # Retrieves details for an item in the Amazon catalog.
+      #
+      # @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 included_data [Array<String>] A comma-delimited list of data sets to include in the response. Default:
+      #   summaries.
+      # @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: "summaries", locale: nil, rate_limit: 2.0)
+        path = "/catalog/2020-12-01/items/#{asin}"
+        params = {
+          "marketplaceIds" => marketplace_ids,
+          "includedData" => included_data,
+          "locale" => locale,
+        }.compact
+
+        meter(rate_limit).get(path, params:)
+      end
+    end
+  end
+end

data/lib/peddler/api/catalog_items_2022_04_01.rb

@@ -0,0 +1,93 @@
+# frozen_string_literal: true
+
+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
+    # {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.
+      #
+      # @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 identifiers_type [String] Type of product identifiers to search the Amazon catalog for. **Note:**
+      #   Required when `identifiers` are provided.
+      # @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 locale [String] Locale for retrieving localized summaries. Defaults to the primary locale of the
+      #   marketplace.
+      # @param seller_id [String] A selling partner identifier, such as a seller account or vendor code. **Note:**
+      #   Required when `identifiersType` is `SKU`.
+      # @param keywords [Array<String>] A comma-delimited list of words to search the Amazon catalog for. **Note:**
+      #   Cannot be used with `identifiers`.
+      # @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 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 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: ["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,
+          "identifiersType" => identifiers_type,
+          "marketplaceIds" => marketplace_ids,
+          "includedData" => included_data,
+          "locale" => locale,
+          "sellerId" => seller_id,
+          "keywords" => keywords,
+          "brandNames" => brand_names,
+          "classificationIds" => classification_ids,
+          "pageSize" => page_size,
+          "pageToken" => page_token,
+          "keywordsLocale" => keywords_locale,
+        }.compact
+
+        meter(rate_limit).get(path, params:)
+      end
+
+      # Retrieves details for an item in the Amazon catalog.
+      #
+      # @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 included_data [Array<String>] A comma-delimited list of data sets to include in the response. Default:
+      #   `summaries`.
+      # @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: ["summaries"], locale: nil, rate_limit: 2.0)
+        path = "/catalog/2022-04-01/items/#{asin}"
+        params = {
+          "marketplaceIds" => marketplace_ids,
+          "includedData" => included_data,
+          "locale" => locale,
+        }.compact
+
+        meter(rate_limit).get(path, params:)
+      end
+    end
+  end
+end