mercadolibre 1.8.0 → 2.0.0

data/lib/mercadolibre/core/{locations_and_currencies.rb → locations.rb}

@@ -17,21 +17,15 @@ module Mercadolibre
         get_request("/cities/#{city_id}").body
       end
 
-      def get_currencies
-        get_request('/currencies').body
-      end
-
-      def get_currency(currency_id)
-        get_request("/currencies/#{currency_id}").body
-      end
-
-      def currency_convertion_rate(currency_from, currency_to)
-        filters = { from: currency_from, to: currency_to }
-        get_request('/currency_conversions/search', filters).body
+      def get_zip_code(country_id, zip_code)
+        get_request("/countries/#{country_id}/zip_codes/#{zip_code}").body
       end
 
-      def get_zip_code_info(country_id, zip_code)
-        get_request("/countries/#{country_id}/zip_codes/#{zip_code}").body
+      def search_zip_codes(country_id, zip_code_from, zip_code_to)
+        get_request("/countries/#{country_id}/zip_codes/search_between", {
+          zip_code_from: zip_code_from,
+          zip_code_to: zip_code_to
+        }).body
       end
     end
   end

data/lib/mercadolibre/core/messaging.rb

@@ -0,0 +1,55 @@
+module Mercadolibre
+  module Core
+    module Messaging
+      def get_order_messages(order_id, filters={})
+        filters.merge!({ access_token: @access_token })
+
+        get_request("/messages/orders/#{order_id}", filters).body
+      end
+
+      def get_unread_order_messages(filters={})
+        filters.merge!({ access_token: @access_token })
+
+        get_request("/messages/pending_read", filters).body
+      end
+
+      def get_order_message(message_id)
+        params = { access_token: @access_token }
+
+        get_request("/messages/#{message_id}", params).body
+      end
+
+      def create_order_message(message_data)
+        payload = message_data.to_json
+
+        headers = { content_type: :json }
+
+        post_request("/messages?access_token=#{@access_token}&application_id=#{@app_key}",
+          payload, headers).body
+      end
+
+      def mark_order_message_as_read(message_ids)
+        if message_ids.is_a?(Array)
+          message_ids_data = message_ids.join(',')
+        else
+          message_ids_data = message_ids
+        end
+
+        headers = { content_type: :json }
+
+        put_request("/messages/mark_as_read/#{message_ids_data}?access_token=#{@access_token}",
+          payload, headers).body
+      end
+
+      def create_attachment(path_to_file)
+        payload = { file: File.new(path_to_file, 'rb') }
+        post_request("/messages/attachments?access_token=#{@access_token}", payload).body
+      end
+
+      def get_attachment(attachment_id)
+        params = { access_token: @access_token }
+        get_request("/messages/attachments/#{attachment_id}", params, { api_response_kind: 'raw' }).body
+      end
+    end
+  end
+end

data/lib/mercadolibre/core/metrics.rb

@@ -1,6 +1,59 @@
 module Mercadolibre
   module Core
     module Metrics
+      def get_user_visits(user_id, args)
+        get_request("/users/#{user_id}/items_visits", args).body
+      end
+
+      def get_user_visits_tw(user_id, args)
+        get_request("/users/#{user_id}/items_visits/time_window", args).body
+      end
+
+      def get_user_question_quantities(user_id, args)
+        get_request("/users/#{user_id}/contacts/questions", args).body
+      end
+
+      def get_user_question_quantities_tw(user_id, args)
+        get_request("/users/#{user_id}/contacts/questions/time_window", args).body
+      end
+
+      def get_user_see_phone_clicked_quantities(user_id, args)
+        get_request("/users/#{user_id}/contacts/phone_views", args).body
+      end
+
+      def get_user_see_phone_clicked_quantities_tw(user_id, args)
+        get_request("/users/#{user_id}/contacts/phone_views/time_window", args).body
+      end
+
+      def get_items_visits(item_ids, args)
+        item_ids_desc = (item_ids.is_a?(Array) ? item_ids.join(',') : item_ids)
+        get_request("/items/visits", args.merge(ids: item_ids_desc)).body
+      end
+
+      def get_item_visits_tw(item_id, args)
+        get_request("/items/#{item_id}/visits/time_window", args).body
+      end
+
+      def get_total_items_visits(item_ids)
+        if item_ids.is_a? Array
+          result = { }
+
+          item_ids.each_slice(50) do |ids_group|
+            filters = { ids: ids_group.join(',') }
+            result.merge!(get_request('/visits/items', filters, { api_response_kind: 'hash' }).body)
+          end
+
+          result
+        else
+          filters = { ids: ids_group.join(',') }
+          get_request('/visits/items', filters, { api_response_kind: 'hash' }).body[item_ids]
+        end
+      end
+
+      def get_user_items_see_phone_clicked_quantities_tw(item_ids, args)
+        item_ids_desc = (item_ids.is_a?(Array) ? item_ids.join(',') : item_ids)
+        get_request("/items/contacts/phone_views/time_window", args.merge(ids: item_ids_desc)).body
+      end
     end
   end
 end

data/lib/mercadolibre/core/money.rb

@@ -0,0 +1,21 @@
+module Mercadolibre
+  module Core
+    module Money
+      def get_collection(collection_id)
+        filters = { access_token: @access_token }
+
+        get_request("/collections/#{collection_id}", filters).body
+      end
+
+      def get_payment(payment_id)
+        get_request("/payments/#{payment_id}", { access_token: @access_token }).body
+      end
+
+      def get_user_mercadopago_balance(user_id)
+        params = { access_token: @access_token }
+
+        get_request("/users/#{user_id}/mercadopago_account/balance", params).body
+      end
+    end
+  end
+end

data/lib/mercadolibre/core/order_blacklist.rb

@@ -0,0 +1,25 @@
+module Mercadolibre
+  module Core
+    module OrderBlacklist
+      def get_orders_blacklist(user_id)
+        results = get_request("/users/#{user_id}/order_blacklist?access_token=#{@access_token}")
+        results.body.map { |r| r.user.id }
+      end
+
+      def add_user_to_orders_blacklist(seller_id, user_id)
+        payload = { user_id: user_id }.to_json
+
+        headers = { content_type: :json }
+
+        url = "/users/#{seller_id}/order_blacklist?access_token=#{@access_token}"
+        post_request(url, payload, headers).status_code == 200
+      end
+
+      def remove_user_from_orders_blacklist(seller_id, user_id)
+        url = "/users/#{seller_id}/order_blacklist/#{user_id}?access_token=#{@access_token}"
+
+        delete_request(url).status_code == 200
+      end
+    end
+  end
+end

data/lib/mercadolibre/core/order_notes.rb

@@ -0,0 +1,33 @@
+module Mercadolibre
+  module Core
+    module OrderNotes
+      def get_order_notes(order_id)
+        filters = { access_token: @access_token }
+        get_request("/orders/#{order_id}/notes", filters).body
+      end
+
+      def create_order_note(order_id, text)
+        payload = { note: text }.to_json
+
+        headers = { content_type: :json, accept: :json }
+
+        result = post_request("/orders/#{order_id}/notes?access_token=#{@access_token}", payload, headers)
+        result.body.note
+      end
+
+      def update_order_note(order_id, note_id, text)
+        payload = { note: text }.to_json
+
+        headers = { content_type: :json, accept: :json }
+
+        result = put_request("/orders/#{order_id}/notes/#{note_id}?access_token=#{@access_token}", payload, headers)
+        result.body.note
+      end
+
+      def delete_order_note(order_id, note_id)
+        result = delete_request("/orders/#{order_id}/notes/#{note_id}?access_token=#{@access_token}")
+        result.status_code == 200
+      end
+    end
+  end
+end

data/lib/mercadolibre/core/orders.rb

@@ -0,0 +1,39 @@
+module Mercadolibre
+  module Core
+    module Orders
+      def search_orders(filters={})
+        if filters[:seller_id].present?
+          seller_id = filters[:seller_id]
+        else
+          seller_id = get_my_user.id
+        end
+
+        orders_suffix = filters.delete(:orders_suffix).to_s
+
+        filters.merge!({
+          seller: seller_id,
+          access_token: @access_token
+        })
+
+        get_request("/orders/search#{orders_suffix}", filters).body
+      end
+
+      def search_archived_orders(filters={})
+        search_orders(filters.merge(orders_suffix: '/archived'))
+      end
+
+      def search_pending_orders(filters={})
+        search_orders(filters.merge(orders_suffix: '/pending'))
+      end
+
+      def search_recent_orders(filters={})
+        search_orders(filters.merge(orders_suffix: '/recent'))
+      end
+
+      def get_order(order_id)
+        filters = { access_token: @access_token }
+        get_request("/orders/#{order_id}", filters).body
+      end
+    end
+  end
+end

data/lib/mercadolibre/core/pictures.rb

@@ -0,0 +1,33 @@
+module Mercadolibre
+  module Core
+    module Pictures
+      def create_picture(path_to_file)
+        payload = { file: File.new(path_to_file, 'rb') }
+        post_request("/pictures?access_token=#{@access_token}", payload).body
+      end
+
+      def get_pictures(picture_id)
+        get_request("/pictures/#{picture_id}").body
+      end
+
+      def delete_picture(picture_id)
+        delete_request("/pictures/#{picture_id}?access_token=#{@access_token}").body
+      end
+
+      def add_item_picture(picture_id, item_id)
+        curl -X POST -H "Content-Type: application/json" -H "Accept: application/json" -d
+        '{"id":"MLA430387888_032012"}'
+
+        https://api.mercadolibre.com/items/MLA421101451/pictures?access_token=$ACCESS_TOKEN
+      end
+
+      def replace_item_pictures(item_id, images)
+        payload = images.to_json
+
+        headers = { content_type: :json }
+
+        put_request("/items/#{item_id}?access_token=#{@access_token}", payload, headers).body
+      end
+    end
+  end
+end

data/lib/mercadolibre/core/projects.rb

@@ -0,0 +1,42 @@
+module Mercadolibre
+  module Core
+    module Projects
+      def get_user_project(project_id)
+        get_request("/projects/#{project_id}", { access_token: @access_token }).body
+      end
+
+      def create_user_project(attrs)
+        payload = attrs.to_json
+
+        headers = { content_type: :json }
+
+        post_request("/projects?access_token=#{@access_token}", payload, headers).body
+      end
+
+      def update_user_project(project_id, attrs)
+        payload = attrs.to_json
+
+        headers = { content_type: :json }
+
+        put_request("/projects/#{project_id}?access_token=#{@access_token}", payload, headers).body
+      end
+
+      def delete_user_project(project_id)
+        delete_request("/projects/#{project_id}?access_token=#{@access_token}").body
+      end
+
+      def add_application_to_project(application_id, project_id)
+        payload = { application_id: application_id }.to_json
+
+        headers = { content_type: :json }
+
+        post_request("/projects/#{project_id}/applications?access_token=#{@access_token}",
+          payload, headers).body
+      end
+
+      def remove_application_from_project(application_id, project_id)
+        delete_request("/projects/#{project_id}/applications/#{application_id}?access_token=#{@access_token}").body
+      end
+    end
+  end
+end

data/lib/mercadolibre/core/question_blacklist.rb

@@ -0,0 +1,27 @@
+module Mercadolibre
+  module Core
+    module QuestionBlacklist
+      def get_questions_blacklist(seller_id, args)
+        result = get_request("/users/#{seller_id}/questions_blacklist", args.merge({
+          access_token: @access_token
+        })).body
+      end
+
+      def add_user_to_questions_blacklist(seller_id, user_id)
+        payload = { user_id: user_id }.to_json
+
+        headers = { content_type: :json }
+
+        url = "/users/#{seller_id}/questions_blacklist?access_token=#{@access_token}"
+
+        post_request(url, payload, headers).status_code == 200
+      end
+
+      def remove_user_from_questions_blacklist(seller_id, user_id)
+        url = "/users/#{seller_id}/questions_blacklist/#{user_id}?access_token=#{@access_token}"
+
+        delete_request(url).status_code == 200
+      end
+    end
+  end
+end

data/lib/mercadolibre/core/{questions_and_answers.rb → questions.rb}

@@ -1,18 +1,7 @@
 module Mercadolibre
   module Core
-    module QuestionsAndAnswers
-      def get_my_questions(filters={})
-        filters.merge!({ access_token: @access_token })
-
-        get_request('/my/received_questions/search', filters).body
-      end
-
-      def get_my_questions_count(filters={})
-        filters.merge!({ access_token: @access_token, limit: 1, offset: 0 })
-        get_request('/my/received_questions/search', filters).body.total.to_i
-      end
-
-      def get_questions(filters={})
+    module Questions
+      def search_questions(filters={})
         if @access_token.present?
           filters.merge!({ access_token: @access_token })
         end
@@ -20,7 +9,7 @@ module Mercadolibre
         get_request('/questions/search', filters).body
       end
 
-      def get_questions_count(filters={})
+      def search_questions_total(filters={})
         if @access_token.present?
           filters.merge!({ access_token: @access_token })
         end
@@ -47,7 +36,7 @@ module Mercadolibre
 
         headers = { content_type: :json }
 
-        post_request("/questions?access_token=#{@access_token}", payload, headers).body
+        post_request("/questions/#{item_id}?access_token=#{@access_token}", payload, headers).body
       end
 
       def answer_question(question_id, text)
@@ -58,25 +47,15 @@ module Mercadolibre
         post_request("/answers?access_token=#{@access_token}", payload, headers).body
       end
 
-      def get_questions_blacklist(seller_id)
-        result = get_request("/users/#{seller_id}/questions_blacklist?access_token=#{@access_token}")
-        result.body.map { |r| r.user.id }
-      end
-
-      def add_user_to_questions_blacklist(seller_id, user_id)
-        payload = { user_id: user_id }.to_json
-
-        headers = { content_type: :json }
-
-        url = "/users/#{seller_id}/questions_blacklist?access_token=#{@access_token}"
+      def search_my_questions(filters={})
+        filters.merge!({ access_token: @access_token })
 
-        post_request(url, payload, headers).status_code == 200
+        get_request('/my/received_questions/search', filters).body
       end
 
-      def remove_user_from_questions_blacklist(seller_id, user_id)
-        url = "/users/#{seller_id}/questions_blacklist/#{user_id}?access_token=#{@access_token}"
-
-        delete_request(url).status_code == 200
+      def search_my_questions_total(filters={})
+        filters.merge!({ access_token: @access_token, limit: 1, offset: 0 })
+        get_request('/my/received_questions/search', filters).body.total.to_i
       end
     end
   end

data/lib/mercadolibre/core/searching.rb

@@ -0,0 +1,33 @@
+module Mercadolibre
+  module Core
+    module Searching
+      def search_items(filters={})
+        get_request("/sites/#{@site}/search", filters).body
+      end
+
+      def search_item_ids(filters={})
+        get_request("/sites/#{@site}/search", filters).body.results.map(&:id)
+      end
+
+      def search_my_item_ids(filters={})
+        user_id = filters[:user_id] || get_my_user.id
+
+        filters.merge!({ access_token: @access_token, limit: 50, offset: 0 })
+
+        get_request("/users/#{user_id}/items/search", filters).body
+      end
+
+      def get_search_url(site_id, q)
+        get_request("/sites/#{site_id}/searchUrl?q=#{q}").body
+      end
+
+      def get_hot_items(site_id, category_id, limit=15)
+        get_request("/sites/#{site_id}/hot_items/search?category=#{category_id}&limit=#{limit}").body
+      end
+
+      def get_featured_items(site_id, pool_id)
+        get_request("/sites/#{site_id}/featured_items/#{pool_id}").body
+      end
+    end
+  end
+end