rav-meser-api 1.0.2 → 1.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 4761b16181712908553fbc2041d183fecff26740
-  data.tar.gz: f5245f697b4a48b974b210c729397b7f343753ca
+  metadata.gz: e9768fbcdb63add5ea51185a65c75105acab0357
+  data.tar.gz: 6c4a975617f575272a2920c2d38a07ad0d0e4a3c
 SHA512:
-  metadata.gz: 13d3e087768f3414afb4901a486f8565d685b97b6cb48272957c2e38e4dbdc373dfba9ecdb5030a0eba7080ccb20e61d89907e783f9bb0eaf144830dae8feced
-  data.tar.gz: bb15e8539a152d68c7bad1f9fb8de193959db5ab5af848c02671e68bfc56e28fb2905ae63cae2a21a8bd06485945b28ac6099b797f2f2b470fd1276610f4a37a
+  metadata.gz: 0321ef926979519f7c09384b61c09ba987876039e5ee675fa6c7fe994eebd6e7203efeb2b504fe132a6ba688113daae8a1f12c729221db1327cc7b1706a129bf
+  data.tar.gz: 27901ea9251593d2859c13b3997aaab5d83f55cb1b3da78667187e9c407f76e10ff1989cd8205f186fce66a76f953cf71077ab80b037b379d07b6a4b2ea106bb

data/lib/rav-meser-api.rb

@@ -4,6 +4,7 @@ require 'json'
 require 'optparse'
 require 'pp'
 require 'uri'
+require 'pry'
 
 # gem class name RavMeser
 class RavMeser
@@ -27,7 +28,7 @@ class RavMeser
   # get all the lists
   #
   # Example:
-  #   >> ה.get_lists()
+  #   >> RavMeser.get_lists()
   #   => { "LISTS" => [{}, {}, ... ] }
   #
   def get_lists
@@ -101,7 +102,7 @@ class RavMeser
   #
   # Example:
   #   >> RavMeser.create_subscribers(123456, {0 => {'EMAIL': "sub1@email.com", 'NAME': "sub1"}, 1 => {'EMAIL': "sub2@email.com", 'NAME': "sub2"}} )
-  #   => {"SUBSCRIBERS_CREATED": [], "EMAILS_INVALID": [], "EMAILS_EXISTING": ["johnsmith@gmail.com"], "EMAILS_BANNED": [], "PHONES_INVALID": [], "PHONES_EXISTING": [], "BAD_PERSONAL_FIELDS": {}, "ERRORS" : [] }
+  #   => {"SUBSCRIBERS_CREATED": [112233], "EMAILS_INVALID": [], "EMAILS_EXISTING": ["sub1@email.com"], "EMAILS_BANNED": [], "PHONES_INVALID": [], "PHONES_EXISTING": [], "BAD_PERSONAL_FIELDS": {}, "ERRORS" : [] }
   #
   # Arguments:
   #   id: (int)
@@ -114,7 +115,7 @@ class RavMeser
   #
   # Example:
   #   >> RavMeser.edit_subscribers(123456, {0 => {'IDENTIFIER': "sub1@email.com", 'NAME': "sub1NewName"}, 1 => {'IDENTIFIER': "sub2", 'NAME': "sub2"}} )
-  #   => {"SUBSCRIBERS_UPDATED": [], "INVALID_SUBSCRIBER_IDENTIFIERS": [], "EMAILS_INVALID": [], "EMAILS_EXISTED": ["johnsmith@gmail.com"], "EMAILS_BANNED": [], "PHONES_INVALID": [], "PHONES_EXISTING": [], "BAD_PERSONAL_FIELDS": {} }}
+  #   => {"SUBSCRIBERS_UPDATED": [112233], "INVALID_SUBSCRIBER_IDENTIFIERS": ["sub1@email.com"], "EMAILS_INVALID": [], "EMAILS_EXISTED": [], "EMAILS_BANNED": [], "PHONES_INVALID": [], "PHONES_EXISTING": [], "BAD_PERSONAL_FIELDS": {} }
   #
   # Arguments:
   #   id: (int)
@@ -136,6 +137,51 @@ class RavMeser
     send_request(:post, 'subscribers', '/' + id.to_s + '/subscribers?', %w[method delete], args)
   end
 
+  # create new subscribers in specific list and update subscribers that exists
+  #
+  # Example:
+  #   >> RavMeser.upsert_subscribers(123456, {0 => {'EMAIL': "sub1@email.com", 'NAME': "sub1"}, 1 => {'EMAIL': "sub2@email.com", 'NAME': "sub2"}} )
+  #   => [{"SUBSCRIBERS_CREATED": [112233], "EMAILS_INVALID": [], "EMAILS_EXISTING": ["sub1@email.com"], "EMAILS_BANNED": [], "PHONES_INVALID": [], "PHONES_EXISTING": [], "BAD_PERSONAL_FIELDS": {}, "ERRORS" : [] },
+  #      {"SUBSCRIBERS_UPDATED": [223344], "INVALID_SUBSCRIBER_IDENTIFIERS": [], "EMAILS_INVALID": [], "EMAILS_EXISTED": [], "EMAILS_BANNED": [], "PHONES_INVALID": [], "PHONES_EXISTING": [], "BAD_PERSONAL_FIELDS": {} }]
+  #
+  # Arguments:
+  #   id: (int)
+  #   args: (Hash)
+  def upsert_subscribers(id, args = {})
+    create_response = send_request(:post, 'subscribers', '/' + id.to_s + '/subscribers', [], args)
+
+    update_args = {}
+    create_response['EMAILS_EXISTING'].each_with_index do |email, index|
+      update_args[index] = get_subscriber_args_and_set_identifier(args, email)
+    end
+    edit_response = send_request(:put, 'subscribers', '/' + id.to_s + '/subscribers', [], update_args)
+
+    [create_response, edit_response]
+  end
+
+  # create new subscriber in specific list - update the subscriber if already exists
+  #
+  # Example:
+  #   >> RavMeser.upsert_subscriber(123456, {0 => {'EMAIL': "sub1@email.com", 'NAME': "sub1"} )
+  #   => [{"SUBSCRIBERS_CREATED": [], "EMAILS_INVALID": [], "EMAILS_EXISTING": ["sub1@email.com"], "EMAILS_BANNED": [], "PHONES_INVALID": [], "PHONES_EXISTING": [], "BAD_PERSONAL_FIELDS": {}, "ERRORS" : [] },
+  #      {"SUBSCRIBERS_UPDATED": [223344], "INVALID_SUBSCRIBER_IDENTIFIERS": [], "EMAILS_INVALID": [], "EMAILS_EXISTED": [], "EMAILS_BANNED": [], "PHONES_INVALID": [], "PHONES_EXISTING": [], "BAD_PERSONAL_FIELDS": {} }]
+  #
+  # Arguments:
+  #   id: (int)
+  #   args: (Hash)
+  def upsert_subscriber(id, args = {})
+    return { error: 'Too many subscribers' } unless args.length == 1
+
+    create_response = send_request(:post, 'subscribers', '/' + id.to_s + '/subscribers', [], args)
+    if create_response['EMAILS_EXISTING'].length == 1
+      args[0][:IDENTIFIER] = args[0].delete(:EMAIL)
+      edit_response = send_request(:put, 'subscribers', '/' + id.to_s + '/subscribers', [], args)
+    end
+
+    [create_response, edit_response || {}]
+  end
+
+
   # <!----------- PERSONAL FIELDS -----------!>
 
   # get personal fields from specific list
@@ -226,10 +272,12 @@ class RavMeser
   #   args: (Hash)
   def create_and_send_message(id, msg)
     res = create_message(id, msg)
-    send_message(id, res["MESSAGE_ID"])
+    send_message(id, res['MESSAGE_ID'])
   end
 
-  # privare method
+  private
+
+  # private method
   # common code to send the requests
   #
   # Example:
@@ -255,5 +303,12 @@ class RavMeser
     response
   end
 
-  private :send_request
+  def get_subscriber_args_and_set_identifier(args, email)
+    args.each do |_, v|
+      if v[:EMAIL] == email
+        v[:IDENTIFIER] = v.delete(:EMAIL)
+        return v
+      end
+    end
+  end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rav-meser-api
 version: !ruby/object:Gem::Version
-  version: 1.0.2
+  version: 1.0.3
 platform: ruby
 authors:
 - Itamar Davidyan
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-11-25 00:00:00.000000000 Z
+date: 2019-09-24 00:00:00.000000000 Z
 dependencies: []
 description: Rav Meser API Ruby
 email: itamardavidyan@gmail.com