peddler 2.4.5 → 3.0.0.beta1

data/lib/peddler/access_token.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+require "http"
+
+module Peddler
+  # Requests a Login with Amazon (LWA) access token that authorizes your application to take actions on behalf of a
+  # selling partner. An LWA access token expires one hour after it is issued.
+  #
+  # @see https://developer-docs.amazon.com/sp-api/docs/connecting-to-the-selling-partner-api
+  class AccessToken
+    URL = "https://api.amazon.com/auth/o2/token"
+
+    attr_reader :client_id, :client_secret, :refresh_token, :scope
+
+    class << self
+      # Requests an access token
+      #
+      # @param client_id [String]
+      # @param client_secret [String]
+      # @param refresh_token [String]
+      # @param scope [String]
+      def request(client_id: ENV["LWA_CLIENT_ID"], client_secret: ENV["LWA_CLIENT_SECRET"], refresh_token: nil,
+        scope: nil)
+        new(client_id: client_id, client_secret: client_secret, refresh_token: refresh_token, scope: scope).request
+      end
+    end
+
+    # @param client_id [String]
+    # @param client_secret [String]
+    # @param refresh_token [String]
+    # @param scope [String]
+    def initialize(client_id: ENV["LWA_CLIENT_ID"], client_secret: ENV["LWA_CLIENT_SECRET"], refresh_token: nil,
+      scope: nil)
+      @client_id = client_id
+      @client_secret = client_secret
+      @refresh_token = refresh_token
+      @scope = scope
+
+      validate_lwa_credentials!
+      validate_exclusive_token_or_scope!
+    end
+
+    def request
+      response = HTTP.post(URL, form: params)
+      response.parse.fetch("access_token")
+    end
+
+    private
+
+    def validate_lwa_credentials!
+      if client_id.nil? || client_secret.nil?
+        raise ArgumentError, "Provide client_id and client_secret."
+      end
+    end
+
+    def validate_exclusive_token_or_scope!
+      if @refresh_token.nil? == @scope.nil?
+        raise ArgumentError, "Provide either refresh_token or scope, not both."
+      end
+    end
+
+    def params
+      {
+        grant_type: grant_type,
+        refresh_token: refresh_token,
+        scope: scope,
+        client_id: client_id,
+        client_secret: client_secret,
+      }.compact
+    end
+
+    def grant_type
+      scope ? "client_credentials" : "refresh_token"
+    end
+  end
+end

data/lib/peddler/api/amazon_warehousing_and_distribution_2024_05_09.rb

@@ -0,0 +1,80 @@
+# frozen_string_literal: true
+
+require "peddler/api"
+
+module Peddler
+  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.
+      #
+      # @param [String] shipment_id ID for the shipment. A shipment contains the cases being inbounded.
+      # @param [String] sku_quantities 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
+      # @return [Hash] The API response
+      def get_inbound_shipment(shipment_id, sku_quantities: nil)
+        path = "/awd/2024-05-09/inboundShipments/#{shipment_id}"
+        params = {
+          "skuQuantities" => sku_quantities,
+        }.compact
+
+        rate_limit(2.0).get(path, params:)
+      end
+
+      # Retrieves a summary of all the inbound AWD shipments associated with a merchant, with the ability to apply
+      # optional filters.
+      #
+      # @param [String] sort_by Field to sort results by. By default, the response will be sorted by UPDATED_AT.
+      # @param [String] sort_order Sort the response in ASCENDING or DESCENDING order. By default, the response will be
+      #   sorted in DESCENDING order.
+      # @param [String] shipment_status Filter by inbound shipment status.
+      # @param [String] updated_after List the inbound shipments that were updated after a certain time (inclusive). The
+      #   date must be in [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) format.
+      # @param [String] updated_before List the inbound shipments that were updated before a certain time (inclusive).
+      #   The date must be in [ISO 8601](https://developer-docs.amazon.com/sp-api/docs/iso-8601) format.
+      # @param [Integer] max_results Maximum number of results to return.
+      # @param [String] next_token Token to retrieve the next set of paginated results.
+      # @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: nil, next_token: nil)
+        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
+
+        rate_limit(1.0).get(path, params:)
+      end
+
+      # Lists AWD inventory associated with a merchant with the ability to apply optional filters.
+      #
+      # @param [String] sku Filter by seller or merchant SKU for the item.
+      # @param [String] sort_order Sort the response in `ASCENDING` or `DESCENDING` order.
+      # @param [String] details Set to `SHOW` to return summaries with additional inventory details. Defaults to `HIDE,`
+      #   which returns only inventory summary totals.
+      # @param [String] next_token Token to retrieve the next set of paginated results.
+      # @param [Integer] max_results Maximum number of results to return.
+      # @return [Hash] The API response
+      def list_inventory(sku: nil, sort_order: nil, details: nil, next_token: nil, max_results: nil)
+        path = "/awd/2024-05-09/inventory"
+        params = {
+          "sku" => sku,
+          "sortOrder" => sort_order,
+          "details" => details,
+          "nextToken" => next_token,
+          "maxResults" => max_results,
+        }.compact
+
+        rate_limit(2.0).get(path, params:)
+      end
+    end
+  end
+end

data/lib/peddler/api/aplus_content_2020_11_01.rb

@@ -0,0 +1,208 @@
+# frozen_string_literal: true
+
+require "peddler/api"
+
+module Peddler
+  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 [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
+      #   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.
+      # @return [Hash] The API response
+      def search_content_documents(marketplace_id, page_token: nil)
+        path = "/aplus/2020-11-01/contentDocuments"
+        params = {
+          "marketplaceId" => marketplace_id,
+          "pageToken" => page_token,
+        }.compact
+
+        rate_limit(10.0).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.
+      # @return [Hash] The API response
+      def create_content_document(marketplace_id, post_content_document_request)
+        path = "/aplus/2020-11-01/contentDocuments"
+        body = post_content_document_request
+        params = {
+          "marketplaceId" => marketplace_id,
+        }.compact
+
+        rate_limit(10.0).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
+      #   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.
+      # @return [Hash] The API response
+      def get_content_document(content_reference_key, marketplace_id, included_data_set)
+        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:)
+      end
+
+      # Updates an existing A+ Content document.
+      #
+      # @param [String] content_reference_key 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.
+      # @return [Hash] The API response
+      def update_content_document(content_reference_key, marketplace_id, post_content_document_request)
+        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:)
+      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
+      #   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
+      #   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
+      #   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.
+      # @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)
+        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
+
+        rate_limit(10.0).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
+      #   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.
+      # @return [Hash] The API response
+      def post_content_document_asin_relations(content_reference_key, marketplace_id,
+        post_content_document_asin_relations_request)
+        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:)
+      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.
+      # @return [Hash] The API response
+      def validate_content_document_asin_relations(marketplace_id, post_content_document_request, asin_set: nil)
+        path = "/aplus/2020-11-01/contentAsinValidations"
+        body = post_content_document_request
+        params = {
+          "marketplaceId" => marketplace_id,
+          "asinSet" => asin_set,
+        }.compact
+
+        rate_limit(10.0).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
+      #   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.
+      # @return [Hash] The API response
+      def search_content_publish_records(marketplace_id, asin, page_token: nil)
+        path = "/aplus/2020-11-01/contentPublishRecords"
+        params = {
+          "marketplaceId" => marketplace_id,
+          "asin" => asin,
+          "pageToken" => page_token,
+        }.compact
+
+        rate_limit(10.0).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
+      #   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.
+      # @return [Hash] The API response
+      def post_content_document_approval_submission(content_reference_key, marketplace_id)
+        path = "/aplus/2020-11-01/contentDocuments/#{content_reference_key}/approvalSubmissions"
+        params = {
+          "marketplaceId" => marketplace_id,
+        }.compact
+
+        rate_limit(10.0).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
+      #   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.
+      # @return [Hash] The API response
+      def post_content_document_suspend_submission(content_reference_key, marketplace_id)
+        path = "/aplus/2020-11-01/contentDocuments/#{content_reference_key}/suspendSubmissions"
+        params = {
+          "marketplaceId" => marketplace_id,
+        }.compact
+
+        rate_limit(10.0).post(path, params:)
+      end
+    end
+  end
+end

data/lib/peddler/api/application_management_2023_11_30.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+require "peddler/api"
+
+module Peddler
+  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).
+      # @return [Hash] The API response
+      def rotate_application_client_secret
+        path = "/applications/2023-11-30/clientSecret"
+
+        rate_limit(0.0167).post(path)
+      end
+    end
+  end
+end

data/lib/peddler/api/catalog_items_2020_12_01.rb

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+require "peddler/api"
+
+module Peddler
+  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).
+    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
+      #   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:
+      #   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
+      #   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
+      #   marketplace.
+      # @param [String] locale Locale for retrieving localized summaries. Defaults to the primary locale of the
+      #   marketplace.
+      # @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)
+        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
+
+        rate_limit(2.0).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
+      #   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:
+      #   summaries.
+      # @param [String] locale Locale for retrieving localized summaries. Defaults to the primary locale of the
+      #   marketplace.
+      # @return [Hash] The API response
+      def get_catalog_item(asin, marketplace_ids, included_data: nil, locale: nil)
+        path = "/catalog/2020-12-01/items/#{asin}"
+        params = {
+          "marketplaceIds" => marketplace_ids,
+          "includedData" => included_data,
+          "locale" => locale,
+        }.compact
+
+        rate_limit(2.0).get(path, params:)
+      end
+    end
+  end
+end

data/lib/peddler/api/catalog_items_2022_04_01.rb

@@ -0,0 +1,83 @@
+# frozen_string_literal: true
+
+require "peddler/api"
+
+module Peddler
+  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).
+    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
+      #   for. **Note:** Cannot be used with `keywords`.
+      # @param [String] identifiers_type 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:
+      #   `summaries`.
+      # @param [String] locale 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:**
+      #   Required when `identifiersType` is `SKU`.
+      # @param [Array<String>] keywords 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
+      #   `keywords`-based queries. **Note:** Cannot be used with `identifiers`.
+      # @param [Array<String>] classification_ids 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
+      #   the primary locale of the marketplace. **Note:** Cannot be used with `identifiers`.
+      # @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
+      )
+        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
+
+        rate_limit(2.0).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
+      #   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:
+      #   `summaries`.
+      # @param [String] locale Locale for retrieving localized summaries. Defaults to the primary locale of the
+      #   marketplace.
+      # @return [Hash] The API response
+      def get_catalog_item(asin, marketplace_ids, included_data: nil, locale: nil)
+        path = "/catalog/2022-04-01/items/#{asin}"
+        params = {
+          "marketplaceIds" => marketplace_ids,
+          "includedData" => included_data,
+          "locale" => locale,
+        }.compact
+
+        rate_limit(2.0).get(path, params:)
+      end
+    end
+  end
+end

data/lib/peddler/api/catalog_items_v0.rb

@@ -0,0 +1,90 @@
+# frozen_string_literal: true
+
+require "peddler/api"
+
+module Peddler
+  class API
+    # Selling Partner API for Catalog Items
+    #
+    # The Selling Partner API for Catalog Items helps you programmatically retrieve item details for items in the
+    # catalog.
+    class CatalogItemsV0 < API
+      # Effective September 30, 2022, the `listCatalogItems` operation will no longer be available in the Selling
+      # Partner API for Catalog Items v0. As an alternative, `searchCatalogItems` is available in the latest version of
+      # the [Selling Partner API for Catalog Items v2022-04-01](doc:catalog-items-api-v2022-04-01-reference).
+      # Integrations that rely on the `listCatalogItems` operation should migrate to the `searchCatalogItems`operation
+      # to avoid service disruption. _Note:_ The [`listCatalogCategories`](#get-catalogv0categories) operation is not
+      # being deprecated and you can continue to make calls to it.
+      #
+      # @param [String] marketplace_id A marketplace identifier. Specifies the marketplace for which items are returned.
+      # @param [String] query Keyword(s) to use to search for items in the catalog. Example: 'harry potter books'.
+      # @param [String] query_context_id An identifier for the context within which the given search will be performed.
+      #   A marketplace might provide mechanisms for constraining a search to a subset of potential items. For example,
+      #   the retail marketplace allows queries to be constrained to a specific category. The QueryContextId parameter
+      #   specifies such a subset. If it is omitted, the search will be performed using the default context for the
+      #   marketplace, which will typically contain the largest set of items.
+      # @param [String] seller_sku Used to identify an item in the given marketplace. SellerSKU is qualified by the
+      #   seller's SellerId, which is included with every operation that you submit.
+      # @param [String] upc A 12-digit bar code used for retail packaging.
+      # @param [String] ean A European article number that uniquely identifies the catalog item, manufacturer, and its
+      #   attributes.
+      # @param [String] isbn The unique commercial book identifier used to identify books internationally.
+      # @param [String] jan A Japanese article number that uniquely identifies the product, manufacturer, and its
+      #   attributes.
+      # @return [Hash] The API response
+      def list_catalog_items(marketplace_id, query: nil, query_context_id: nil, seller_sku: nil, upc: nil, ean: nil,
+        isbn: nil, jan: nil)
+        path = "/catalog/v0/items"
+        params = {
+          "MarketplaceId" => marketplace_id,
+          "Query" => query,
+          "QueryContextId" => query_context_id,
+          "SellerSKU" => seller_sku,
+          "UPC" => upc,
+          "EAN" => ean,
+          "ISBN" => isbn,
+          "JAN" => jan,
+        }.compact
+
+        get(path, params:)
+      end
+
+      # Effective September 30, 2022, the `getCatalogItem` operation will no longer be available in the Selling Partner
+      # API for Catalog Items v0. This operation is available in the latest version of the [Selling Partner API for
+      # Catalog Items v2022-04-01](doc:catalog-items-api-v2022-04-01-reference). Integrations that rely on this
+      # operation should migrate to the latest version to avoid service disruption. _Note:_ The
+      # [`listCatalogCategories`](#get-catalogv0categories) operation is not being deprecated and you can continue to
+      # make calls to it.
+      #
+      # @param [String] marketplace_id A marketplace identifier. Specifies the marketplace for the item.
+      # @param [String] asin The Amazon Standard Identification Number (ASIN) of the item.
+      # @return [Hash] The API response
+      def get_catalog_item(marketplace_id, asin)
+        path = "/catalog/v0/items/#{asin}"
+        params = {
+          "MarketplaceId" => marketplace_id,
+        }.compact
+
+        get(path, params:)
+      end
+
+      # Returns the parent categories to which an item belongs, based on the specified ASIN or SellerSKU.
+      #
+      # @param [String] marketplace_id A marketplace identifier. Specifies the marketplace for the item.
+      # @param [String] asin The Amazon Standard Identification Number (ASIN) of the item.
+      # @param [String] seller_sku Used to identify items in the given marketplace. SellerSKU is qualified by the
+      #   seller's SellerId, which is included with every operation that you submit.
+      # @return [Hash] The API response
+      def list_catalog_categories(marketplace_id, asin: nil, seller_sku: nil)
+        path = "/catalog/v0/categories"
+        params = {
+          "MarketplaceId" => marketplace_id,
+          "ASIN" => asin,
+          "SellerSKU" => seller_sku,
+        }.compact
+
+        rate_limit(1.0).get(path, params:)
+      end
+    end
+  end
+end