muffin_man 2.4.8 → 2.4.10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2f074702a508a2a37e3fa5da93518288415d5e0201dbb2d2a5ca635385e109ac
-  data.tar.gz: 5bb970ccb190c94d8aa6127a86bcda564253bef263ab76ebf6d1685eb53eb556
+  metadata.gz: 1d683b6dea44eb948c563cea144a00d0031713850062727bb7663d5cf246b6b9
+  data.tar.gz: 903e5e6dbe397e5add17d287408150f2bae13173082c21e2c9dc35d7ae46c4da
 SHA512:
-  metadata.gz: df8188be5ad13d9007abe6a5ea93942d77f663c256d7c1a4a3baac3539cd6ea98936d14409643abc14fc15569102eae7a328703aa6ba449ef37c2db3d511b657
-  data.tar.gz: 9225837cba3b50eaaa422c61d14d571eaf0cc25e3ad8f9bb045194ad000ca607e2f41eb9d0b60df77ef7cd7d98777c2aa8cda7af6180caa336d063fde8cb20d2
+  metadata.gz: 995df7ef1120cb444ea1476a071613e35de3170f23efcd9a82b0ad62fd17019ba41e1ada3103d58fe315287bbe9c6aae168c258d619b52c0a2fa60e0ce15e98d
+  data.tar.gz: 75fa638fe79049d64cac04601a5c10eaa828f5404087570917d352d667b28fa98dcfa6d79b31b3df49fc72c8c606650479cf72eac04712eaffcb1c5d0bd4a2d7

data/CHANGELOG.md

@@ -1,3 +1,8 @@
+# 2.4.10
+
+- Sellers API v1 [#87](https://github.com/patterninc/muffin_man/pull/87)
+- Listings API v20210801 searchListingsItem [#87](https://github.com/patterninc/muffin_man/pull/87)
+
 # 2.4.8
 
 - Customer Feedback v2024-06-01 [#80] (https://github.com/patterninc/muffin_man/pull/80)

data/README.md

@@ -25,6 +25,7 @@ As of now, this gem only supports portions of the following APIs with more to co
 - `Product Pricing API v0`
 - `Reports API v2021-06-30`
 - `Solicitations API v1`
+- `Sellers API v1`
 - `Tokens API v2021-03-01`
 - `Vendor Direct Fulfillment Transactions API v1`
 - `Vendor Direct Fulfillment Orders API v2021-12-28`
@@ -35,6 +36,8 @@ As of now, this gem only supports portions of the following APIs with more to co
 - `Vendor Orders API v1`
 - `Vendor Shipments API v1`
 - `Vendor Transaction Status API v1`
+- `Uploads API v2020-11-01`
+- `A+ API v2020-11-01`
 
 ## Installation
 

data/lib/muffin_man/aplus_content/v20201101.rb

@@ -0,0 +1,109 @@
+# frozen_string_literal: true
+
+module MuffinMan
+  module AplusContent
+    class V20201101 < SpApiClient
+      # Create content document
+      #
+      # This API is used to upload A+ Content documents.
+      # The content document is the container for all A+ modules in a specific language.
+      # It is required for creating content in A+ Content Manager.
+      # @param marketplace_id The identifier for the marketplace where the A+ Content is published.
+      # @param content_document_payload The content document request payload.
+      # Refer to the A+ Content API documentation for more information.
+      # @return [Hash]
+      #   The response from the API, which includes the signed upload URL and additional metadata.
+      # @raise [StandardError]
+      #   Raises an error if the API request fails.
+      #
+      # @example
+      #   client = MuffinMan::AplusContent::V20201101.new
+      #   response = client.create_content_documents(
+      #     "ATVPDKIKX0DER",
+      #     { "contentDocument" => {
+      #        "name" => "My Content Document",
+      #        "contentType" => "STANDARD",
+      #        "locale" => "en_US",
+      #        "contentModuleList" => "< ContentModule > array"
+      #        }
+      #     }
+      #   )
+      #   puts response
+      def create_content_documents(marketplace_id, content_document_payload)
+        @local_var_path = "/aplus/2020-11-01/contentDocuments"
+        @query_params = { "marketplaceId" => marketplace_id }
+        @request_body = content_document_payload
+        @request_type = "POST"
+
+        call_api
+      end
+
+      # Create content document asin relations
+      #
+      # This API is used to associate ASINs with a content document.
+      # The content document is the container for all A+ modules in a specific language.
+      # It is required for creating content in A+ Content Manager.
+      # @param marketplace_id The identifier for the marketplace where the A+ Content is published.
+      # @param content_reference_key The unique reference key for the content document.
+      # @param asin_set The set of ASINs.
+      # @return [Hash]
+      #   The response from the API, which includes the signed upload URL and additional metadata.
+      # @raise [StandardError]
+      #   Raises an error if the API request fails.
+      #
+      # @example
+      #   client = MuffinMan::AplusContent::V20201101.new
+      #   response = client.post_content_document_asin_relations(
+      #     "ATVPDKIKX0DER",
+      #     "contentReferenceKey",
+      #     ["B07H8QMZWV", "B07H8QMZWV"]
+      #   )
+      #   puts response
+      def post_content_document_asin_relations(marketplace_id, content_reference_key, asin_set)
+        @local_var_path = "/aplus/2020-11-01/contentDocuments/#{content_reference_key}/asins"
+        @query_params = { "marketplaceId" => marketplace_id }
+        @request_body = { "asinSet" => asin_set }
+        @request_type = "POST"
+
+        call_api
+      end
+
+      # validate content document asin relations
+      #
+      # This API is used to validate the content document ASINs.
+      # The content document is the container for all A+ modules in a specific language.
+      # It is required for creating content in A+ Content Manager.
+      # @param marketplace_id The identifier for the marketplace where the A+ Content is published.
+      # @param asin_set The set of ASINs.
+      # @param content_document_payload The content document request payload.
+      # Refer to the A+ Content API documentation for more information.
+      # @return [Hash]
+      #   The response from the API, which includes the signed upload URL and additional metadata.
+      # @raise [StandardError]
+      #   Raises an error if the API request fails.
+      #
+      # @example
+      #   client = MuffinMan::AplusContent::V20201101.new
+      #   response = client.validate_content_document_asin_relations(
+      #     "ATVPDKIKX0DER",
+      #     ["B07H8QMZWV", "B07H8QMZWV"],
+      #     { "contentDocument" => {
+      #        "name" => "My Content Document",
+      #        "contentType" => "STANDARD",
+      #        "locale" => "en_US",
+      #        "contentModuleList" => "< ContentModule > array"
+      #        }
+      #     }
+      #   )
+      #   puts response
+      def validate_content_document_asin_relations(marketplace_id, asin_set, content_document_payload)
+        @local_var_path = "/aplus/2020-11-01/contentAsinValidations"
+        @query_params = { "marketplaceId" => marketplace_id, "asinSet" => asin_set.join(",") }
+        @request_body = content_document_payload
+        @request_type = "POST"
+
+        call_api
+      end
+    end
+  end
+end

data/lib/muffin_man/listings/v20210801.rb

@@ -65,6 +65,21 @@ module MuffinMan
         @request_type = "PATCH"
         call_api
       end
+
+      def search_listings_items(seller_id, marketplace_ids, **optional_query)
+        @local_var_path = "/listings/2021-08-01/items/#{seller_id}"
+        @marketplace_ids = marketplace_ids.is_a?(Array) ? marketplace_ids : [marketplace_ids]
+        @query_params = {
+          "marketplaceIds" =>  @marketplace_ids.join(",")
+        }
+        optional_query.each do |key, value|
+          camel_key = key.to_s.camelize(:lower).to_sym
+          string_value = value.is_a?(Array) ? value.join(",") : value
+          @query_params[camel_key] = string_value
+        end
+        @request_type = "GET"
+        call_api
+      end
     end
   end
 end

data/lib/muffin_man/sellers/v1.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module MuffinMan
+  module Sellers
+    class V1 < SpApiClient
+      # This is only available in the EU region.
+      def account
+        @local_var_path = "/sellers/v1/account"
+        @request_type = "GET"
+        call_api
+      end
+
+      def marketplace_participations
+        @local_var_path = "/sellers/v1/marketplaceParticipations"
+        @request_type = "GET"
+        call_api
+      end
+    end
+  end
+end

data/lib/muffin_man/sp_api_client.rb

@@ -39,6 +39,10 @@ module MuffinMan
       @config = MuffinMan.configuration
     end
 
+    def request
+      Typhoeus::Request.new(canonical_uri, params: query_params)
+    end
+
     private
 
     def call_api
@@ -73,10 +77,6 @@ module MuffinMan
       "#{sp_api_url}#{local_var_path}"
     end
 
-    def request
-      Typhoeus::Request.new(canonical_uri, params: query_params)
-    end
-
     def retrieve_lwa_access_token
       return request_lwa_access_token["access_token"] unless use_cache?
 
@@ -108,7 +108,7 @@ module MuffinMan
           "Content-Type" => "application/x-www-form-urlencoded;charset=UTF-8"
         }
       )
-      raise SpApiAuthError, response if response.failure?
+      raise SpApiAuthError, response unless response.success?
 
       JSON.parse(response.body)
     end

data/lib/muffin_man/uploads/v20201101.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module MuffinMan
+  module Uploads
+    class V20201101 < SpApiClient
+      # Creates a new upload destination for a resource.
+      #
+      # This method generates a signed upload destination URL for a specific resource
+      # that you can use to upload files to Amazon SP-API.
+      #
+      # @param [String] marketplace_id
+      #   The identifier of the marketplace for the request (e.g., 'ATVPDKIKX0DER').
+      # @param [String] resource
+      #   The resource type and path, such as:
+      #   - `/messaging/v1/orders/{amazonOrderId}/messages/legalDisclosure`
+      #   - `aplus/2020-11-01/contentDocuments`.
+      # @param [String] content_md5
+      #   The MD5 hash of the file's content. Use `Digest::MD5.file(file_path).hexdigest` to calculate this.
+      # @param [String] content_type (optional)
+      #   The content type of the file (e.g., 'application/pdf').
+      # @return [Hash]
+      #   The response from the API, which includes the signed upload URL and additional metadata.
+      # @raise [StandardError]
+      #   Raises an error if the API request fails.
+      #
+      # @example
+      #   client = MuffinMan::Uploads::V20201101.new
+      #   response = client.create_upload_destination_for_resource(
+      #     "ATVPDKIKX0DER",
+      #     "aplus/2020-11-01/contentDocuments",
+      #     "510700ca1b152c729b62f2fd13c8dbbe",
+      #     "application/pdf"
+      #   )
+      #   puts response
+      def create_upload_destination_for_resource(marketplace_id, resource, content_md5, content_type: nil)
+        @local_var_path = "/uploads/2020-11-01/uploadDestinations/#{resource}"
+        @query_params = { "marketplaceIds" => marketplace_id, "contentMD5" => content_md5 }
+        @query_params["contentType"] = content_type if content_type
+        @request_type = "POST"
+
+        call_api
+      end
+    end
+  end
+end

data/lib/muffin_man/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module MuffinMan
-  VERSION = "2.4.8"
+  VERSION = "2.4.10"
 end

data/lib/muffin_man.rb

@@ -26,6 +26,7 @@ require "muffin_man/feeds/v20210630"
 require "muffin_man/notifications/v1"
 require "muffin_man/merchant_fulfillment/v0"
 require "muffin_man/awd/v20240509"
+require "muffin_man/sellers/v1"
 require "muffin_man/vendor_direct_fulfillment_inventory/v1"
 require "muffin_man/vendor_direct_fulfillment_orders/v20211228"
 require "muffin_man/vendor_direct_fulfillment_payments/v1"
@@ -36,6 +37,8 @@ require "muffin_man/vendor_orders/v1"
 require "muffin_man/vendor_shipments/v1"
 require "muffin_man/vendor_transaction_status/v1"
 require "muffin_man/customer_feedback/v20240601"
+require "muffin_man/uploads/v20201101"
+require "muffin_man/aplus_content/v20201101"
 
 module MuffinMan
   class Error < StandardError; end

metadata

@@ -1,16 +1,16 @@
 --- !ruby/object:Gem::Specification
 name: muffin_man
 version: !ruby/object:Gem::Version
-  version: 2.4.8
+  version: 2.4.10
 platform: ruby
 authors:
 - Gavin
 - Jason
 - Nate
-autorequire: 
+autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-11-11 00:00:00.000000000 Z
+date: 2025-01-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
@@ -130,7 +130,7 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description: 
+description:
 email:
 - gavin@pattern.com
 - jason@pattern.com
@@ -153,6 +153,7 @@ files:
 - bin/console
 - bin/setup
 - lib/muffin_man.rb
+- lib/muffin_man/aplus_content/v20201101.rb
 - lib/muffin_man/authorization/v1.rb
 - lib/muffin_man/awd/v20240509.rb
 - lib/muffin_man/catalog_items/base_api.rb
@@ -188,9 +189,11 @@ files:
 - lib/muffin_man/request_helpers/outbound_fulfillment/item.rb
 - lib/muffin_man/request_helpers/outbound_fulfillment/v20200701.rb
 - lib/muffin_man/sandbox_helpers/merchant_fulfillment/create_shipment_body.json
+- lib/muffin_man/sellers/v1.rb
 - lib/muffin_man/solicitations/v1.rb
 - lib/muffin_man/sp_api_client.rb
 - lib/muffin_man/tokens/v20210301.rb
+- lib/muffin_man/uploads/v20201101.rb
 - lib/muffin_man/vendor_direct_fulfillment_inventory/v1.rb
 - lib/muffin_man/vendor_direct_fulfillment_orders/v20211228.rb
 - lib/muffin_man/vendor_direct_fulfillment_payments/v1.rb
@@ -207,7 +210,7 @@ homepage: https://github.com/patterninc/muffin_man
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -222,8 +225,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3.1
-signing_key: 
+rubygems_version: 3.4.19
+signing_key:
 specification_version: 4
 summary: Amazon Selling Partner API client
 test_files: []