iterable-api-client 0.4.0 → 0.5.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d04be11184926b2bcffba1f777270fc08fbf83e676babb5c1e79756e33915464
-  data.tar.gz: 07723ae603767edd511e37a3c682f0348e6a9262ca435e881fd4d86a7e77b515
+  metadata.gz: dec75eb2ce6297758dd87c44acd79435578c29bb16f23402d133c2e24d1f6820
+  data.tar.gz: 45658c86e6448f1e75948fa150de1bb6133dacefb3d237cf1edc5504ee90591b
 SHA512:
-  metadata.gz: dc7f30727eaa45240f3a0f683e58128184397a305214e29e719ae34d0794ee04421bfb0bf496865a285f85edede66691d40e3f0e19a24652261efe38e1b6fa82
-  data.tar.gz: a90443045373add4a10ffd3ddbfb74114e71102b6be4f9f8392af1b179a02813e9432d15c3d743499ccb7ae27a8fcbb2e548fb43ec826aff3e1b4211b29a4e27
+  metadata.gz: 9dc86fb5a431fddc281eefb86e0ed597b535dad112e03ef53de5027dd723015d8f1ac791d1ba93c1086aef2cd382d619dafaca348147ada3e7d091ed30afc353
+  data.tar.gz: 8428f4dfd4bec851b1ed30ee7161dfa7f26848f4c210046fb29f8485a002a06c016473366774720f79855179b27f3e8f57793dfcb3203db82956dcef4d50cfd4

data/README.md

@@ -81,6 +81,10 @@ response.body
 # HTTP message
 response.message
 
+# Headers of response
+response['Content-Type']
+# => 'application/json; charset=utf-8'
+
 # The URI used to make the request for the response
 reponse.uri
 ```
@@ -124,6 +128,7 @@ reponse.uri
   - [Upsert](#email-templates-upsert)
 - [Events](#events)
   - [For Email](#events-for-email)
+  - [Bulk Track](#events-track-bulk)
   - [Track](#events-track)
   - [Track Push Open](#events-track-push-open)
 - [Experiments](#experiments)
@@ -133,6 +138,8 @@ reponse.uri
   - [CSV](#export-csv)
 - [In App](#in-app)
   - [Messages](#in-app-messages)
+  - [Target](#in-app-target)
+  - [Cancel](#in-app-cancel)
 - [Lists](#lists)
   - [All](#lists-all)
   - [Create](#lists-create)
@@ -149,6 +156,9 @@ reponse.uri
   - [Get Key](#metadata-get-key)
   - [Remove Key](#metadata-remove-key)
   - [Add Key](#metadata-add-key)
+- [Push](#push)
+  - [Target](#push-target)
+  - [Cancel](#push-cancel)
 - [Push Templates](#push-templates)
   - [Get](#push-templates-get)
   - [Update](#push-templates-update)
@@ -206,7 +216,7 @@ Endpoint: `DELETE /catalogs/{catalogName}/items`
 catalog = 'my-catalog'
 catalog_items = Iterable::BulkCatalogItems.new(catalog)
 item_ids = ['12345', '12346', '12347']
-response = catalog_items.create(item_ids)
+response = catalog_items.delete(item_ids)
 ```
 
 ### Campaigns
@@ -300,7 +310,8 @@ Endpoint: `GET /catalogs/{catalogName}/fieldMappings`
 ```ruby
 catalog = 'my-catalog'
 catalog_field_mappings = Iterable::CatalogFieldMappings.new(catalog)
-response = catalog_field_mappings.field_mappings
+response = catalog_field_mappings.get
+response.body['params']['definedMappings']
 ```
 
 #### Catalog Field Mappings Update
@@ -557,6 +568,19 @@ attrs = { campaignId: 42, dataFields: {} }
 response = events.track 'event-name', 'user@example.com', attrs
 ```
 
+#### Events Track Bulk
+
+Endpoint: `POST /events/trackBulk`
+
+```ruby
+events = Iterable::Events.new
+# Array of events to track
+events_attrs = [
+  { email: 'user@example.com', eventName: 'event-name', campaignId: 42, dataFields: {} }
+]
+response = iterable_events.track_bulk events_attrs
+```
+
 #### Events Track Push Open
 
 Endpoint: `GET /events/{email}`
@@ -639,7 +663,34 @@ response = in_app.messages_for_user_id 42, count: 2
 # Pass in query parameters
 email = 'user@example.com'
 attrs = { 'platform' => 'iOS' }
-response = in_app.messages_for_email: email, attrs
+response = in_app.messages_for_email email, attrs
+```
+
+#### In App Target
+
+Endpoint: `POST /inApp/target`
+
+```ruby
+in_app = Iterable::InApp.new
+
+# Needs campaign ID and an optional email
+email = 'user@example.com'
+attrs = { 'campaignId' => '123456asdf' }
+response = in_app.target attrs: attrs, email: email
+```
+
+#### In App Cancel
+
+Endpoint: `POST /push/cancel`
+
+```ruby
+in_app = Iterable::InApp.new
+
+# Needs campaign ID and an optional email and optional attrs for request
+email = 'user@example.com'
+campaign_id = '12345asdf'
+attrs = {}
+response = in_app.target campaign_id: campaign_id, attrs: attrs, email: email
 ```
 
 ### Lists
@@ -776,6 +827,32 @@ value = { foo: 'bar', data: 'stuffs' }
 response = metadata_table.add 'metadata-key', value
 ```
 
+### Push
+
+#### Push Target
+
+Endpoint: `POST /push/target`
+
+```ruby
+push = Iterable::Push.new
+campaign_id = '1234asdf'
+email = 'user@example.com' # optional
+attrs = {} # optional extra params for the request
+response = push.target campaign_id: campaign_id, email: email, attrs: attrs
+```
+
+#### Push Cancel
+
+Endpoint: `POST /push/cancel`
+
+```ruby
+push = Iterable::Push.new
+campaign_id = '1234asdf'
+email = 'user@example.com' # optional
+attrs = {} # optional extra params for the request
+response = push.cancel email: email, campaign_id: campaign_id, attrs: attrs
+```
+
 ### Push Templates
 
 #### Push Templates Get
@@ -854,10 +931,10 @@ Endpoint: `POST /users/bulkUpdate`
 users = Iterable::Users.new
 # Array of users to update by email with additional
 # fields if needed
-users = [
+users_attrs = [
 	{ email: 'user@example.com', userID: 'custom-id' }
 ]
-response = users.bulk_update users
+response = users.bulk_update users_attrs
 ```
 
 #### Users Update Subscriptions

data/lib/iterable/email.rb

@@ -18,11 +18,15 @@ module Iterable
     #
     # @param email [String] Email of user who received the message to view
     # @param message_id [String|Integer] Message id for message sent
+    # @param attrs [Hash] Hash of attributes to pass like dataFields with the requst
     #
     # @return [Iterable::Response] A response object
-    def view(email, message_id)
-      params = { email: email, messageId: message_id }
-      Iterable.request(conf, '/email/viewInBrowser', params).get
+    def view(email, message_id, attrs = {})
+      attrs['email'] = email
+      attrs['messageId'] = message_id
+      attrs.compact!
+
+      Iterable.request(conf, '/email/viewInBrowser', attrs).get
     end
 
     ##

data/lib/iterable/events.rb

@@ -39,6 +39,19 @@ module Iterable
       Iterable.request(conf, '/events/track').post(attrs)
     end
 
+    ##
+    #
+    # Bulk Track events
+    #
+    # @param events [Array[Hash]] Array of hashes of event details
+    #
+    # @return [Iterable::Response] A response object
+    #
+    # @note Event fields can be eventName [String], email [String], dataFields [Hash], or userId [String]
+    def track_bulk(events = [])
+      Iterable.request(conf, '/events/trackBulk').post(events: events)
+    end
+
     ##
     #
     # Track an event

data/lib/iterable/in_app.rb

@@ -41,6 +41,42 @@ module Iterable
       messages(attrs)
     end
 
+    ##
+    #
+    # Send an In-App notification to a specific user. User Email or ID along
+    # with campaign ID must be provided
+    #
+    # @param email [String] (optional) User email used to identify user
+    # @param campaign_id [Integer] Campaign ID
+    # @param attrs [Hash] Additional data to update or add
+    #
+    # @return [Iterable::Response] A response object
+    #
+    def target(campaign_id:, attrs: {}, email: nil)
+      attrs['recipientEmail'] = email if email
+      attrs['campaignId'] = campaign_id
+      Iterable.request(conf, '/inApp/target').post(attrs)
+    end
+
+    ##
+    #
+    # Cancel an In App notification sent to a specific user
+    # Must include either an email address AND campaignId, or
+    # just a scheduledMessageId provided in the attrs
+    #
+    # @param email [String] User email to cancel push
+    # @param campaignId [Integer] campaignID used to cancel push
+    # @param attrs [Hash] Additional data to update or add
+    #
+    # @return [Iterable::Response] A response object
+    #
+    # @note An email or UserId is required
+    def cancel(campaign_id: nil, attrs: {}, email: nil)
+      attrs['email'] = email if email
+      attrs['campaignId'] = campaign_id if campaign_id
+      Iterable.request(conf, '/push/cancel').post(attrs)
+    end
+
     private def messages(**attrs)
       Iterable.request(conf, '/inApp/getMessages', attrs).get
     end

data/lib/iterable/push.rb

@@ -0,0 +1,46 @@
+module Iterable
+  ##
+  #
+  # Interact with /push API endpoints
+  #
+  # @example Creating push endpoint object
+  #   # With default config
+  #   templates = Iterable::Push.new
+  #   templates.target campaign_id: '12345'
+  #
+  class Push < ApiResource
+    ##
+    #
+    # Send a push notification to a specific user
+    #
+    # @param email [String] (optional) User email used to identify user
+    # @param campaign_id [Integer] Campaign ID
+    # @param attrs [Hash] Additional data to update or add
+    #
+    # @return [Iterable::Response] A response object
+    def target(campaign_id:, email: nil, attrs: {})
+      attrs['recipientEmail'] = email if email
+      attrs['campaignId'] = campaign_id
+      Iterable.request(conf, '/push/target').post(attrs)
+    end
+
+    ##
+    #
+    # Cancel a push notification to a specific user
+    # Must include either an email address AND campaignId, or
+    # just a scheduledMessageId provided in the attrs
+    #
+    # @param email [String] User email to cancel push
+    # @param campaignId [Integer] campaignID used to cancel push
+    # @param attrs [Hash] Additional data to update or add
+    #
+    # @return [Iterable::Response] A response object
+    #
+    # @note An email or UserId is required
+    def cancel(email: nil, campaign_id: nil, attrs: {})
+      attrs['email'] = email if email
+      attrs['campaignId'] = campaign_id if campaign_id
+      Iterable.request(conf, '/push/cancel').post(attrs)
+    end
+  end
+end

data/lib/iterable/response.rb

@@ -7,7 +7,7 @@ module Iterable
   class Response
     extend Forwardable
 
-    def_delegators :@resp, :code, :message, :uri
+    def_delegators :@resp, :code, :message, :uri, :[]
 
     attr_reader :body
 

data/lib/iterable.rb

@@ -22,6 +22,7 @@ files = %w[
   templates
   email_templates
   push_templates
+  push
   users
   workflows
   metadata

metadata

@@ -1,41 +1,41 @@
 --- !ruby/object:Gem::Specification
 name: iterable-api-client
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.1
 platform: ruby
 authors:
 - Chavez
-autorequire:
+autorequire: 
 bindir: bin
 cert_chain:
 - |
   -----BEGIN CERTIFICATE-----
   MIIEeDCCAuCgAwIBAgIBATANBgkqhkiG9w0BAQsFADBBMRAwDgYDVQQDDAdjb250
   YWN0MRkwFwYKCZImiZPyLGQBGRYJZWwtY2hhdmV6MRIwEAYKCZImiZPyLGQBGRYC
-  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
+  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
-  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
+  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
   -----END CERTIFICATE-----
-date: 2022-06-08 00:00:00.000000000 Z
+date: 2023-11-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: multi_json
@@ -219,6 +219,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 0.21.2
+- !ruby/object:Gem::Dependency
+  name: simplecov-cobertura
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.1.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 2.1.0
 - !ruby/object:Gem::Dependency
   name: typhoeus
   requirement: !ruby/object:Gem::Requirement
@@ -308,6 +322,7 @@ files:
 - lib/iterable/message_types.rb
 - lib/iterable/metadata.rb
 - lib/iterable/metadata_table.rb
+- lib/iterable/push.rb
 - lib/iterable/push_templates.rb
 - lib/iterable/request.rb
 - lib/iterable/response.rb
@@ -320,7 +335,7 @@ licenses:
 - MIT
 metadata:
   rubygems_mfa_required: 'true'
-post_install_message:
+post_install_message: 
 rdoc_options:
 - "--charset=UTF-8"
 - "--main=README.md"
@@ -337,8 +352,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
-signing_key:
+rubygems_version: 3.1.6
+signing_key: 
 specification_version: 4
 summary: Iterable REST API Client
 test_files: []