peddler 4.4.0 → 4.6.0

data/lib/peddler/apis/aplus_content_2020_11_01.rb

@@ -15,6 +15,8 @@ module Peddler
     # Use the A+ Content API to build applications that help selling partners add rich marketing content to their Amazon
     # product detail pages. Selling partners can use A+ content to share their brand and product story, which helps
     # buyers make informed purchasing decisions. Selling partners use content modules to add images and text.
+    #
+    # @see https://github.com/amzn/selling-partner-api-models/blob/main/models/aplusContent_2020-11-01.json
     class AplusContent20201101 < API
       # Returns a list of all A+ Content documents, including metadata, that are assigned to a selling partner. To get
       # the actual contents of the A+ Content documents, call the `getContentDocument` operation.
@@ -27,15 +29,13 @@ module Peddler
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] 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:)
+        parser = Peddler::Types::AplusContent20201101::SearchContentDocumentsResponse if typed?
+        meter(rate_limit).get(path, params:, parser:)
       end
 
       # Creates a new A+ Content document.
@@ -47,15 +47,13 @@ module Peddler
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] 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:)
+        parser = Peddler::Types::AplusContent20201101::PostContentDocumentResponse if typed?
+        meter(rate_limit).post(path, body:, params:, parser:)
       end
 
       # Returns an A+ Content document, if available.
@@ -70,15 +68,13 @@ module Peddler
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] 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/#{percent_encode(content_reference_key)}"
         params = {
           "marketplaceId" => marketplace_id,
           "includedDataSet" => stringify_array(included_data_set),
         }.compact
-
-        meter(rate_limit).get(path, params:)
+        parser = Peddler::Types::AplusContent20201101::GetContentDocumentResponse if typed?
+        meter(rate_limit).get(path, params:, parser:)
       end
 
       # Updates an existing A+ Content document.
@@ -94,15 +90,13 @@ module Peddler
       # @return [Peddler::Response] 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/#{percent_encode(content_reference_key)}"
         body = post_content_document_request
         params = {
           "marketplaceId" => marketplace_id,
         }.compact
-
-        meter(rate_limit).post(path, body:, params:)
+        parser = Peddler::Types::AplusContent20201101::PostContentDocumentResponse if typed?
+        meter(rate_limit).post(path, body:, params:, parser:)
       end
 
       # Returns a list of ASINs that are related to the specified A+ Content document, if available. If you don't
@@ -123,8 +117,6 @@ module Peddler
       # @return [Peddler::Response] 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/#{percent_encode(content_reference_key)}/asins"
         params = {
           "marketplaceId" => marketplace_id,
@@ -132,8 +124,8 @@ module Peddler
           "asinSet" => stringify_array(asin_set),
           "pageToken" => page_token,
         }.compact
-
-        meter(rate_limit).get(path, params:)
+        parser = Peddler::Types::AplusContent20201101::ListContentDocumentAsinRelationsResponse if typed?
+        meter(rate_limit).get(path, params:, parser:)
       end
 
       # Replaces all ASINs related to the specified A+ Content document, if available. This operation can add or remove
@@ -152,15 +144,13 @@ module Peddler
       # @return [Peddler::Response] 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/#{percent_encode(content_reference_key)}/asins"
         body = post_content_document_asin_relations_request
         params = {
           "marketplaceId" => marketplace_id,
         }.compact
-
-        meter(rate_limit).post(path, body:, params:)
+        parser = Peddler::Types::AplusContent20201101::PostContentDocumentAsinRelationsResponse if typed?
+        meter(rate_limit).post(path, body:, params:, parser:)
       end
 
       # Checks if the A+ Content document is valid for use on a set of ASINs.
@@ -174,16 +164,14 @@ module Peddler
       # @return [Peddler::Response] 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" => stringify_array(asin_set),
         }.compact
-
-        meter(rate_limit).post(path, body:, params:)
+        parser = Peddler::Types::AplusContent20201101::ValidateContentDocumentAsinRelationsResponse if typed?
+        meter(rate_limit).post(path, body:, params:, parser:)
       end
 
       # Searches for A+ Content publishing records, if available.
@@ -198,16 +186,14 @@ module Peddler
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] 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:)
+        parser = Peddler::Types::AplusContent20201101::SearchContentPublishRecordsResponse if typed?
+        meter(rate_limit).get(path, params:, parser:)
       end
 
       # Submits an A+ Content document for review, approval, and publishing.
@@ -221,14 +207,12 @@ module Peddler
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] 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/#{percent_encode(content_reference_key)}/approvalSubmissions"
         params = {
           "marketplaceId" => marketplace_id,
         }.compact
-
-        meter(rate_limit).post(path, params:)
+        parser = Peddler::Types::AplusContent20201101::PostContentDocumentApprovalSubmissionResponse if typed?
+        meter(rate_limit).post(path, params:, parser:)
       end
 
       # Submits a request to suspend visible A+ Content. This doesn't delete the content document or the ASIN relations.
@@ -242,14 +226,18 @@ module Peddler
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] 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/#{percent_encode(content_reference_key)}/suspendSubmissions"
         params = {
           "marketplaceId" => marketplace_id,
         }.compact
+        parser = Peddler::Types::AplusContent20201101::PostContentDocumentSuspendSubmissionResponse if typed?
+        meter(rate_limit).post(path, params:, parser:)
+      end
+
+      private
 
-        meter(rate_limit).post(path, params:)
+      def load_types
+        require "peddler/types/aplus_content_2020_11_01"
       end
     end
   end

data/lib/peddler/apis/application_integrations_2024_04_01.rb

@@ -14,6 +14,8 @@ module Peddler
     #
     # With the AppIntegrations API v2024-04-01, you can send notifications to Amazon Selling Partners and display the
     # notifications in Seller Central.
+    #
+    # @see https://github.com/amzn/selling-partner-api-models/blob/main/models/appIntegrations-2024-04-01.json
     class ApplicationIntegrations20240401 < API
       # Create a notification for sellers in Seller Central.
       #
@@ -23,8 +25,8 @@ module Peddler
       # @return [Peddler::Response] The API response
       def create_notification(body, rate_limit: 1.0)
         path = "/appIntegrations/2024-04-01/notifications"
-
-        meter(rate_limit).post(path, body:)
+        parser = Peddler::Types::ApplicationIntegrations20240401::CreateNotificationResponse if typed?
+        meter(rate_limit).post(path, body:, parser:)
       end
 
       # Remove your application's notifications from the Appstore notifications dashboard.
@@ -35,7 +37,6 @@ module Peddler
       # @return [Peddler::Response] 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
 
@@ -48,9 +49,14 @@ module Peddler
       # @return [Peddler::Response] The API response
       def record_action_feedback(notification_id, body, rate_limit: 1.0)
         path = "/appIntegrations/2024-04-01/notifications/#{percent_encode(notification_id)}/feedback"
-
         meter(rate_limit).post(path, body:)
       end
+
+      private
+
+      def load_types
+        require "peddler/types/application_integrations_2024_04_01"
+      end
     end
   end
 end

data/lib/peddler/apis/application_management_2023_11_30.rb

@@ -14,6 +14,8 @@ module Peddler
     #
     # The Selling Partner API for Application Management lets you programmatically update the client secret on
     # registered applications.
+    #
+    # @see https://github.com/amzn/selling-partner-api-models/blob/main/models/application_2023-11-30.json
     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
@@ -24,12 +26,15 @@ module Peddler
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] 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
+
+      private
+
+      def load_types
+        require "peddler/types/application_management_2023_11_30"
+      end
     end
   end
 end

data/lib/peddler/apis/catalog_items_2020_12_01.rb

@@ -13,9 +13,13 @@ module Peddler
     # 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.
+    #
+    # 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}.
+    #
+    # @see https://github.com/amzn/selling-partner-api-models/blob/main/models/catalogItems_2020-12-01.json
     class CatalogItems20201201 < API
       # Search for and return a list of Amazon catalog items and associated information.
       #
@@ -50,8 +54,8 @@ module Peddler
           "keywordsLocale" => keywords_locale,
           "locale" => locale,
         }.compact
-
-        meter(rate_limit).get(path, params:)
+        parser = Peddler::Types::CatalogItems20201201::ItemSearchResults if typed?
+        meter(rate_limit).get(path, params:, parser:)
       end
 
       # Retrieves details for an item in the Amazon catalog.
@@ -73,8 +77,14 @@ module Peddler
           "includedData" => stringify_array(included_data),
           "locale" => locale,
         }.compact
+        parser = Peddler::Types::CatalogItems20201201::Item if typed?
+        meter(rate_limit).get(path, params:, parser:)
+      end
+
+      private
 
-        meter(rate_limit).get(path, params:)
+      def load_types
+        require "peddler/types/catalog_items_2020_12_01"
       end
     end
   end

data/lib/peddler/apis/catalog_items_2022_04_01.rb

@@ -12,9 +12,12 @@ module Peddler
   module APIs
     # Selling Partner API for Catalog Items
     #
-    # Use the Selling Partner API for Catalog Items to retrieve information about items in the Amazon catalog. For more
-    # information, refer to the [Catalog Items API Use Case
+    # Use the Selling Partner API for Catalog Items to retrieve information about items in the Amazon catalog.
+    #
+    # For more information, refer to the [Catalog Items API Use Case
     # Guide](https://developer-docs.amazon.com/sp-api/docs/:catalog-items-api-v2022-04-01-use-case-guide).
+    #
+    # @see https://github.com/amzn/selling-partner-api-models/blob/main/models/catalogItems_2022-04-01.json
     class CatalogItems20220401 < API
       # Search for a list of Amazon catalog items and item-related information. You can search by identifier or by
       # keywords.
@@ -47,7 +50,7 @@ module Peddler
       # @return [Peddler::Response] 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: 5.0)
+        page_token: nil, keywords_locale: nil, rate_limit: 2.0)
         path = "/catalog/2022-04-01/items"
         params = {
           "identifiers" => stringify_array(identifiers),
@@ -63,8 +66,8 @@ module Peddler
           "pageToken" => page_token,
           "keywordsLocale" => keywords_locale,
         }.compact
-
-        meter(rate_limit).get(path, params:)
+        parser = Peddler::Types::CatalogItems20220401::ItemSearchResults if typed?
+        meter(rate_limit).get(path, params:, parser:)
       end
 
       # Retrieves details for an item in the Amazon catalog.
@@ -79,15 +82,21 @@ module Peddler
       #   locale of the marketplace.
       # @param rate_limit [Float] Requests per second
       # @return [Peddler::Response] The API response
-      def get_catalog_item(asin, marketplace_ids, included_data: ["summaries"], locale: nil, rate_limit: 5.0)
+      def get_catalog_item(asin, marketplace_ids, included_data: ["summaries"], locale: nil, rate_limit: 2.0)
         path = "/catalog/2022-04-01/items/#{percent_encode(asin)}"
         params = {
           "marketplaceIds" => stringify_array(marketplace_ids),
           "includedData" => stringify_array(included_data),
           "locale" => locale,
         }.compact
+        parser = Peddler::Types::CatalogItems20220401::Item if typed?
+        meter(rate_limit).get(path, params:, parser:)
+      end
+
+      private
 
-        meter(rate_limit).get(path, params:)
+      def load_types
+        require "peddler/types/catalog_items_2022_04_01"
       end
     end
   end

data/lib/peddler/apis/catalog_items_v0.rb

@@ -14,6 +14,8 @@ module Peddler
     #
     # The Selling Partner API for Catalog Items helps you programmatically retrieve item details for items in the
     # catalog.
+    #
+    # @see https://github.com/amzn/selling-partner-api-models/blob/main/models/catalogItemsV0.json
     class CatalogItemsV0 < API
       # Returns the parent categories to which an item belongs, based on the specified ASIN or SellerSKU.
       #
@@ -31,8 +33,14 @@ module Peddler
           "ASIN" => asin,
           "SellerSKU" => seller_sku,
         }.compact
+        parser = Peddler::Types::CatalogItemsV0::ListCatalogCategoriesResponse if typed?
+        meter(rate_limit).get(path, params:, parser:)
+      end
+
+      private
 
-        meter(rate_limit).get(path, params:)
+      def load_types
+        require "peddler/types/catalog_items_v0"
       end
     end
   end

data/lib/peddler/apis/customer_feedback_2024_06_01.rb

@@ -0,0 +1,151 @@
+# frozen_string_literal: true
+
+require "peddler/api"
+
+module Peddler
+  class << self
+    def customer_feedback_2024_06_01(...)
+      APIs::CustomerFeedback20240601.new(...)
+    end
+  end
+
+  module APIs
+    # The Selling Partner API for CustomerFeedback
+    #
+    # The Selling Partner API for Customer Feedback (Customer Feedback API) provides information about customer reviews
+    # and returns at both the item and browse node level.
+    #
+    # @see https://github.com/amzn/selling-partner-api-models/blob/main/models/customerFeedback_2024-06-01.json
+    class CustomerFeedback20240601 < API
+      # Retrieve an item's ten most positive and ten most negative review topics.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param asin [String] The Amazon Standard Identification Number (ASIN) is the unique identifier of a product
+      #   within a marketplace. The value must be a child ASIN.
+      # @param marketplace_id [String] The MarketplaceId is the globally unique identifier of a marketplace, you can
+      #   refer to the marketplaceId here : https://developer-docs.amazon.com/sp-api/docs/marketplace-ids.
+      # @param sort_by [String] The metric by which to sort data in the response.
+      # @return [Peddler::Response] The API response
+      def get_item_review_topics(asin, marketplace_id, sort_by)
+        path = "/customerFeedback/2024-06-01/items/#{percent_encode(asin)}/reviews/topics"
+        params = {
+          "marketplaceId" => marketplace_id,
+          "sortBy" => sort_by,
+        }.compact
+        parser = Peddler::Types::CustomerFeedback20240601::ItemReviewTopicsResponse if typed?
+        get(path, params:, parser:)
+      end
+
+      # This API returns the associated browse node of the requested ASIN. A browse node is a location in a browse tree
+      # that is used for navigation, product classification, and website content on the Amazon retail website.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param asin [String] The Amazon Standard Identification Number (ASIN) is the unique identifier of a product
+      #   within a marketplace.
+      # @param marketplace_id [String] The MarketplaceId is the globally unique identifier of a marketplace, you can
+      #   refer to the marketplaceId here : https://developer-docs.amazon.com/sp-api/docs/marketplace-ids.
+      # @return [Peddler::Response] The API response
+      def get_item_browse_node(asin, marketplace_id)
+        path = "/customerFeedback/2024-06-01/items/#{percent_encode(asin)}/browseNode"
+        params = {
+          "marketplaceId" => marketplace_id,
+        }.compact
+        parser = Peddler::Types::CustomerFeedback20240601::BrowseNodeResponse if typed?
+        get(path, params:, parser:)
+      end
+
+      # Retrieve a browse node's ten most positive and ten most negative review topics.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param browse_node_id [String] The ID of a browse node. A browse node is a named location in a browse tree that
+      #   is used for navigation, product classification, and website content.
+      # @param marketplace_id [String] The MarketplaceId is the globally unique identifier of a marketplace, you can
+      #   refer to the marketplaceId here : https://developer-docs.amazon.com/sp-api/docs/marketplace-ids.
+      # @param sort_by [String] The metric by which to sort the data in the response.
+      # @return [Peddler::Response] The API response
+      def get_browse_node_review_topics(browse_node_id, marketplace_id, sort_by)
+        path = "/customerFeedback/2024-06-01/browseNodes/#{percent_encode(browse_node_id)}/reviews/topics"
+        params = {
+          "marketplaceId" => marketplace_id,
+          "sortBy" => sort_by,
+        }.compact
+        parser = Peddler::Types::CustomerFeedback20240601::BrowseNodeReviewTopicsResponse if typed?
+        get(path, params:, parser:)
+      end
+
+      # Retrieve an item's positive and negative review trends for the past six months.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param asin [String] The Amazon Standard Identification Number (ASIN) is the unique identifier of a product
+      #   within a marketplace. This API takes child ASIN as an input.
+      # @param marketplace_id [String] The MarketplaceId is the globally unique identifier of a marketplace, you can
+      #   refer to the marketplaceId here : https://developer-docs.amazon.com/sp-api/docs/marketplace-ids.
+      # @return [Peddler::Response] The API response
+      def get_item_review_trends(asin, marketplace_id)
+        path = "/customerFeedback/2024-06-01/items/#{percent_encode(asin)}/reviews/trends"
+        params = {
+          "marketplaceId" => marketplace_id,
+        }.compact
+        parser = Peddler::Types::CustomerFeedback20240601::ItemReviewTrendsResponse if typed?
+        get(path, params:, parser:)
+      end
+
+      # Retrieve the positive and negative review trends of items in a browse node for the past six months.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param browse_node_id [String] A browse node ID is a unique identifier of a browse node. A browse node is a
+      #   named location in a browse tree that is used for navigation, product classification, and website content.
+      # @param marketplace_id [String] The marketplace ID is the globally unique identifier of a marketplace. For more
+      #   information, refer to [Marketplace IDs](https://developer-docs.amazon.com/sp-api/docs/marketplace-ids).
+      # @return [Peddler::Response] The API response
+      def get_browse_node_review_trends(browse_node_id, marketplace_id)
+        path = "/customerFeedback/2024-06-01/browseNodes/#{percent_encode(browse_node_id)}/reviews/trends"
+        params = {
+          "marketplaceId" => marketplace_id,
+        }.compact
+        parser = Peddler::Types::CustomerFeedback20240601::BrowseNodeReviewTrendsResponse if typed?
+        get(path, params:, parser:)
+      end
+
+      # Retrieve the topics that customers mention when they return items in a browse node.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param browse_node_id [String] A browse node ID is a unique identifier for a browse node. A browse node is a
+      #   named location in a browse tree that is used for navigation, product classification, and website content.
+      # @param marketplace_id [String] The MarketplaceId is the globally unique identifier of a marketplace, you can
+      #   refer to the marketplaceId here : https://developer-docs.amazon.com/sp-api/docs/marketplace-ids.
+      # @return [Peddler::Response] The API response
+      def get_browse_node_return_topics(browse_node_id, marketplace_id)
+        path = "/customerFeedback/2024-06-01/browseNodes/#{percent_encode(browse_node_id)}/returns/topics"
+        params = {
+          "marketplaceId" => marketplace_id,
+        }.compact
+        parser = Peddler::Types::CustomerFeedback20240601::BrowseNodeReturnTopicsResponse if typed?
+        get(path, params:, parser:)
+      end
+
+      # Retrieve the trends of topics that customers mention when they return items in a browse node.
+      #
+      # @note This operation can make a static sandbox call.
+      # @param browse_node_id [String] A browse node ID is a unique identifier of a browse node. A browse node is a
+      #   named location in a browse tree that is used for navigation, product classification, and website content.
+      # @param marketplace_id [String] The MarketplaceId is the globally unique identifier of a marketplace, you can
+      #   refer to the marketplaceId here : https://developer-docs.amazon.com/sp-api/docs/marketplace-ids.
+      # @return [Peddler::Response] The API response
+      def get_browse_node_return_trends(browse_node_id, marketplace_id)
+        path = "/customerFeedback/2024-06-01/browseNodes/#{percent_encode(browse_node_id)}/returns/trends"
+        params = {
+          "marketplaceId" => marketplace_id,
+        }.compact
+        parser = Peddler::Types::CustomerFeedback20240601::BrowseNodeReturnTrendsResponse if typed?
+        get(path, params:, parser:)
+      end
+
+      private
+
+      def load_types
+        require "peddler/types/customer_feedback_2024_06_01"
+      end
+    end
+  end
+end

data/lib/peddler/apis/data_kiosk_2023_11_15.rb

@@ -14,6 +14,8 @@ module Peddler
     #
     # The Selling Partner API for Data Kiosk lets you submit GraphQL queries from a variety of schemas to help selling
     # partners manage their businesses.
+    #
+    # @see https://github.com/amzn/selling-partner-api-models/blob/main/models/dataKiosk_2023-11-15.json
     class DataKiosk20231115 < API
       # Returns details for the Data Kiosk queries that match the specified filters. See the `createQuery` operation for
       # details about query retention.
@@ -42,15 +44,16 @@ module Peddler
           "createdUntil" => created_until,
           "paginationToken" => pagination_token,
         }.compact
-
-        meter(rate_limit).get(path, params:)
+        parser = Peddler::Types::DataKiosk20231115::GetQueriesResponse if typed?
+        meter(rate_limit).get(path, params:, parser:)
       end
 
-      # Creates a Data Kiosk query request. **Note:** The retention of a query varies based on the fields requested.
-      # Each field within a schema is annotated with a `@resultRetention` directive that defines how long a query
-      # containing that field will be retained. When a query contains multiple fields with different retentions, the
-      # shortest (minimum) retention is applied. The retention of a query's resulting documents always matches the
-      # retention of the query.
+      # Creates a Data Kiosk query request.
+      #
+      # **Note:** The retention of a query varies based on the fields requested. Each field within a schema is annotated
+      # with a `@resultRetention` directive that defines how long a query containing that field will be retained. When a
+      # query contains multiple fields with different retentions, the shortest (minimum) retention is applied. The
+      # retention of a query's resulting documents always matches the retention of the query.
       #
       # @note This operation can make a static sandbox call.
       # @param body [Hash] The body of the request.
@@ -58,8 +61,8 @@ module Peddler
       # @return [Peddler::Response] The API response
       def create_query(body, rate_limit: 0.0167)
         path = "/dataKiosk/2023-11-15/queries"
-
-        meter(rate_limit).post(path, body:)
+        parser = Peddler::Types::DataKiosk20231115::CreateQueryResponse if typed?
+        meter(rate_limit).post(path, body:, parser:)
       end
 
       # Cancels the query specified by the `queryId` parameter. Only queries with a non-terminal `processingStatus`
@@ -74,7 +77,6 @@ module Peddler
       # @return [Peddler::Response] The API response
       def cancel_query(query_id, rate_limit: 0.0222)
         path = "/dataKiosk/2023-11-15/queries/#{percent_encode(query_id)}"
-
         meter(rate_limit).delete(path)
       end
 
@@ -87,8 +89,8 @@ module Peddler
       # @return [Peddler::Response] The API response
       def get_query(query_id, rate_limit: 2.0)
         path = "/dataKiosk/2023-11-15/queries/#{percent_encode(query_id)}"
-
-        meter(rate_limit).get(path)
+        parser = Peddler::Types::DataKiosk20231115::Query if typed?
+        meter(rate_limit).get(path, parser:)
       end
 
       # Returns the information required for retrieving a Data Kiosk document's contents. See the `createQuery`
@@ -100,8 +102,14 @@ module Peddler
       # @return [Peddler::Response] The API response
       def get_document(document_id, rate_limit: 0.0167)
         path = "/dataKiosk/2023-11-15/documents/#{percent_encode(document_id)}"
+        parser = Peddler::Types::DataKiosk20231115::GetDocumentResponse if typed?
+        meter(rate_limit).get(path, parser:)
+      end
+
+      private
 
-        meter(rate_limit).get(path)
+      def load_types
+        require "peddler/types/data_kiosk_2023_11_15"
       end
     end
   end