zendesk2 1.12.0 → 1.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: a61d3d90ed074ac942698a76c6032da01d98dc49
-  data.tar.gz: c7c9d087bc7d353345a15e02455b679c745d3a91
+SHA256:
+  metadata.gz: 976b953f93c756c82467fc000cf0ec1bbb81f7b8811592474e115aaba2395134
+  data.tar.gz: 4f6c9bb551ea4801c525c7925ead6aa331c97d549c32c4901ead32f60af2656d
 SHA512:
-  metadata.gz: 68410198ef99c316d62bb865a3f2d29e9975848972ee8b706d37bd0acb84ba547209efecbff793afdee1d85edccda4fdfc93f0a069675f0a5968472c922b6cd1
-  data.tar.gz: bf5cc95b1b2e4dc8e616112aabc0ade9419a1b68ef1223ff136209f470b3f1b0e986dc2c154fa69f898a73347eee04f17728a3d89a43f63999ab6a0c7f357b1c
+  metadata.gz: d0add53ea5c6a5d74d31adc1609b8cba4a8db75d3421695473e6543ec3269c84b37bc2ee946ba117fd3e63b26594f1337b7ecf168f32838556faf3b6158b70fb
+  data.tar.gz: d81940091f8df258e37f22ee46e408ef85dabb71c32b980dce14bc6a85f603820201eb7e79f9374acac21df25f17c1bfd7973f914def13ae9d7587a3095061bf

data/README.md

@@ -61,6 +61,7 @@ Zendesk2.new(url: "http://support.cloud.engineyard.com", username: "mate", token
 Currently support resources:
 
 * Audit Events
+* Brands
 * Categories
 * Forums
 * Groups
@@ -69,6 +70,7 @@ Currently support resources:
 * Ticket Audits
 * Ticket Fields
 * Tickets
+* Ticket Forms
 * Topic Comments
 * Topics
 * User Identities

data/lib/zendesk2.rb

@@ -59,12 +59,14 @@ require 'zendesk2/model'
 require 'zendesk2/collection'
 require 'zendesk2/help_center'
 
+require 'zendesk2/create_brand'
 require 'zendesk2/create_category'
 require 'zendesk2/create_forum'
 require 'zendesk2/create_group'
 require 'zendesk2/create_membership'
 require 'zendesk2/create_organization'
 require 'zendesk2/create_ticket'
+require 'zendesk2/create_ticket_form'
 require 'zendesk2/create_ticket_field'
 require 'zendesk2/create_topic'
 require 'zendesk2/create_topic_comment'
@@ -72,12 +74,14 @@ require 'zendesk2/create_user'
 require 'zendesk2/create_user_field'
 require 'zendesk2/create_user_identity'
 require 'zendesk2/create_view'
+require 'zendesk2/destroy_brand'
 require 'zendesk2/destroy_category'
 require 'zendesk2/destroy_forum'
 require 'zendesk2/destroy_group'
 require 'zendesk2/destroy_membership'
 require 'zendesk2/destroy_organization'
 require 'zendesk2/destroy_ticket'
+require 'zendesk2/destroy_ticket_form'
 require 'zendesk2/destroy_ticket_field'
 require 'zendesk2/destroy_topic'
 require 'zendesk2/destroy_topic_comment'
@@ -86,6 +90,8 @@ require 'zendesk2/destroy_user_field'
 require 'zendesk2/destroy_user_identity'
 require 'zendesk2/destroy_view'
 require 'zendesk2/get_assignable_groups'
+require 'zendesk2/get_brand'
+require 'zendesk2/get_brands'
 require 'zendesk2/get_categories'
 require 'zendesk2/get_category'
 require 'zendesk2/get_ccd_tickets'
@@ -109,6 +115,8 @@ require 'zendesk2/get_ticket_audits'
 require 'zendesk2/get_ticket_comments'
 require 'zendesk2/get_ticket_field'
 require 'zendesk2/get_ticket_fields'
+require 'zendesk2/get_ticket_form'
+require 'zendesk2/get_ticket_forms'
 require 'zendesk2/get_ticket_metric'
 require 'zendesk2/get_ticket_metrics'
 require 'zendesk2/get_tickets'
@@ -130,10 +138,12 @@ require 'zendesk2/get_views'
 require 'zendesk2/mark_membership_default'
 require 'zendesk2/mark_user_identity_primary'
 require 'zendesk2/update_category'
+require 'zendesk2/update_brand'
 require 'zendesk2/update_forum'
 require 'zendesk2/update_group'
 require 'zendesk2/update_organization'
 require 'zendesk2/update_ticket'
+require 'zendesk2/update_ticket_form'
 require 'zendesk2/update_ticket_field'
 require 'zendesk2/update_topic'
 require 'zendesk2/update_user'
@@ -147,6 +157,7 @@ require 'zendesk2/search_user'
 
 require 'zendesk2/audit_event'
 
+require 'zendesk2/brand'
 require 'zendesk2/category'
 require 'zendesk2/forum'
 require 'zendesk2/group'
@@ -156,6 +167,7 @@ require 'zendesk2/ticket'
 require 'zendesk2/ticket_audit'
 require 'zendesk2/ticket_comment'
 require 'zendesk2/ticket_field'
+require 'zendesk2/ticket_form'
 require 'zendesk2/topic'
 require 'zendesk2/topic_comment'
 require 'zendesk2/user'
@@ -163,6 +175,7 @@ require 'zendesk2/user_field'
 require 'zendesk2/user_identity'
 require 'zendesk2/view'
 
+require 'zendesk2/brands'
 require 'zendesk2/categories'
 require 'zendesk2/forums'
 require 'zendesk2/groups'
@@ -171,6 +184,7 @@ require 'zendesk2/organizations'
 require 'zendesk2/ticket_audits'
 require 'zendesk2/ticket_comments'
 require 'zendesk2/ticket_fields'
+require 'zendesk2/ticket_forms'
 require 'zendesk2/tickets'
 require 'zendesk2/topic_comments'
 require 'zendesk2/topics'

data/lib/zendesk2/brand.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+class Zendesk2::Brand
+  include Zendesk2::Model
+
+  extend Zendesk2::Attributes
+
+  # @return [integer] Automatically assigned upon creation
+  identity :id, type: :integer
+
+  # @return [String] The API url of this brand
+  attribute :url, type: :string
+  # @return [String] The name of the brand
+  attribute :name, type: :string
+  # @return [String] The url of the brand
+  attribute :brand_url, type: :string
+  # @return [Boolean] If the brand has a Help Center
+  attribute :has_help_center, type: :boolean
+  # @return [String] The state of the Help Center: enabled, disabled, or restricted
+  attribute :help_center_state, type: :string
+  # @return [Boolean] If the brand is set as active
+  attribute :active, type: :boolean
+  # @return [Boolean] Is the brand the default brand for this account
+  attribute :default, type: :boolean
+  # @return [Attachment] Logo image for this brand
+  attribute :logo, type: :Attachment
+  # @return [Array] The ids of ticket forms that are available for use by a brand
+  attribute :ticket_form_ids, type: :array
+  # @return [Date] The time the brand was created
+  attribute :created_at, type: :date
+  # @return [Date] The time of the last update of the brand
+  attribute :updated_at, type: :date
+  # @return [String] The subdomain of the brand
+  attribute :subdomain, type: :string
+  # @return [String] The hostmapping to this brand, if any (only admins view this key)
+  attribute :host_mapping, type: :string
+  # @return [String] The signature template for a brand
+  attribute :signature_template, type: :string
+
+  def save!
+    data = if new_record?
+             requires :name
+
+             cistern.create_brand('brand' => attributes)
+           else
+             requires :identity
+
+             cistern.update_brand('brand' => attributes)
+           end.body['brand']
+
+    merge_attributes(data)
+  end
+
+  def destroy!
+    requires :identity
+
+    cistern.destroy_brand('brand' => { 'id' => identity })
+  end
+end

data/lib/zendesk2/brands.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+class Zendesk2::Brands
+  include Zendesk2::Collection
+
+  model Zendesk2::Brand
+
+  attribute :count, type: :integer
+
+  self.collection_method = :get_brands
+  self.collection_root   = 'brands'
+  self.model_method      = :get_brand
+  self.model_root        = 'brand'
+end

data/lib/zendesk2/create_brand.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+class Zendesk2::CreateBrand
+  include Zendesk2::Request
+
+  request_method :post
+  request_path { |_| '/brands.json' }
+  request_body { |r| { 'brand' => r.brand_params } }
+
+  def self.accepted_attributes
+    %w(name brand_url has_help_center help_center_state active default ticket_form_ids
+       subdomain host_mapping signature_template)
+  end
+
+  def brand_params
+    Cistern::Hash.slice(params.fetch('brand'), *self.class.accepted_attributes)
+  end
+
+  def mock
+    identity = cistern.serial_id
+
+    record = {
+      'id'                   => identity,
+      'name'                 => params['name'],
+      'brand_url'            => '',
+      'has_help_center'      => true,
+      'help_center_state'    => true,
+      'active'               => true,
+      'end_user_visible'     => true,
+      'default'              => false,
+      'ticket_form_ids'      => params['ticket_form_ids'],
+      'subdomain'            => params['subdomain'],
+      'host_mapping'         => '',
+      'signature_template'   => '',
+      'url'                  => url_for("/brands/#{identity}.json"),
+    }.merge(brand_params)
+
+    data[:brands][identity] = record
+
+    mock_response('brand' => record)
+  end
+end

data/lib/zendesk2/create_ticket.rb

@@ -8,7 +8,7 @@ class Zendesk2::CreateTicket
 
   def self.accepted_attributes
     %w(external_id via priority requester requester_id submitter_id assignee_id organization_id subject description
-       custom_fields recipient status collaborator_ids collaborators tags)
+       custom_fields recipient status collaborator_ids collaborators tags ticket_form_id brand_id)
   end
 
   def ticket_params

data/lib/zendesk2/create_ticket_field.rb

@@ -8,7 +8,7 @@ class Zendesk2::CreateTicketField
 
   def self.accepted_attributes
     %w(type title description position active required collapsed_for_agents regexp_for_validation title_in_portal
-       visible_in_portal editable_in_portal required_in_portal tag custom_field_options)
+       visible_in_portal editable_in_portal required_in_portal tag custom_field_options agent_description)
   end
 
   def ticket_field_params
@@ -35,6 +35,7 @@ class Zendesk2::CreateTicketField
       'updated_at'            => timestamp,
       'url'                   => url_for("/ticket_fields/#{identity}.json"),
       'visible_in_portal'     => false,
+      'agent_description'     => '',
     }.merge(ticket_field_params)
 
     data[:ticket_fields][identity] = record

data/lib/zendesk2/create_ticket_form.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+class Zendesk2::CreateTicketForm
+  include Zendesk2::Request
+
+  request_method :post
+  request_path { |_| '/ticket_forms.json' }
+  request_body { |r| { 'ticket_form' => r.ticket_form_params } }
+
+  def self.accepted_attributes
+    %w(name raw_name display_name raw_display_name position active end_user_visible default ticket_field_ids
+       in_all_brands restricted_brand_ids)
+  end
+
+  def ticket_form_params
+    Cistern::Hash.slice(params.fetch('ticket_form'), *self.class.accepted_attributes)
+  end
+
+  def mock
+    identity = cistern.serial_id
+
+    record = {
+      'id'                   => identity,
+      'name'                 => params['name'],
+      'raw_name'             => '',
+      'display_name'         => '',
+      'raw_display_name'     => '',
+      'position'             => 9999,
+      'active'               => true,
+      'end_user_visible'     => true,
+      'default'              => false,
+      'ticket_field_ids'     => params['ticket_field_ids'],
+      'in_all_brands'        => false,
+      'restricted_brand_ids' => params['restricted_brand_ids'],
+      'url'                  => url_for("/ticket_forms/#{identity}.json"),
+    }.merge(ticket_form_params)
+
+    data[:ticket_forms][identity] = record
+
+    mock_response('ticket_form' => record)
+  end
+end

data/lib/zendesk2/destroy_brand.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+class Zendesk2::DestroyBrand
+  include Zendesk2::Request
+
+  request_method :delete
+  request_path { |r| "/brands/#{r.brand_id}.json" }
+
+  def brand_id
+    params.fetch('brand').fetch('id')
+  end
+
+  def mock
+    delete!(:brands, brand_id)
+
+    mock_response(nil)
+  end
+end

data/lib/zendesk2/destroy_ticket_form.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+class Zendesk2::DestroyTicketForm
+  include Zendesk2::Request
+
+  request_method :delete
+  request_path { |r| "/ticket_forms/#{r.ticket_form_id}.json" }
+
+  def ticket_form_id
+    params.fetch('ticket_form').fetch('id')
+  end
+
+  def mock
+    delete!(:ticket_forms, ticket_form_id)
+
+    mock_response(nil)
+  end
+end

data/lib/zendesk2/get_brand.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+class Zendesk2::GetBrand
+  include Zendesk2::Request
+
+  request_method :get
+  request_path { |r| "/brands/#{r.brand_id}.json" }
+
+  def brand_id
+    params.fetch('brand').fetch('id').to_i
+  end
+
+  def mock
+    mock_response('brand' => find!(:brands, brand_id))
+  end
+end

data/lib/zendesk2/get_brands.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+class Zendesk2::GetBrands
+  include Zendesk2::Request
+
+  request_method :get
+  request_path { |_r| '/brands.json' }
+
+  page_params!
+
+  def mock
+    page(:brands)
+  end
+end

data/lib/zendesk2/get_ticket_form.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+class Zendesk2::GetTicketForm
+  include Zendesk2::Request
+
+  request_method :get
+  request_path { |r| "/ticket_forms/#{r.ticket_form_id}.json" }
+
+  def ticket_form_id
+    params.fetch('ticket_form').fetch('id').to_i
+  end
+
+  def mock
+    mock_response('ticket_form' => find!(:ticket_forms, ticket_form_id))
+  end
+end

data/lib/zendesk2/get_ticket_forms.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+class Zendesk2::GetTicketForms
+  include Zendesk2::Request
+
+  request_method :get
+  request_path { |_| '/ticket_forms.json' }
+  request_params do |r|
+    result = {}
+    result['active'] = r.active unless r.active.nil?
+    result['end_user_visible'] = r.end_user_visible unless r.end_user_visible.nil?
+    result['fallback_to_default'] = r.fallback_to_default unless r.fallback_to_default.nil?
+    result['associated_to_brand'] = r.associated_to_brand unless r.associated_to_brand.nil?
+    result
+  end
+
+  page_params!
+
+  def active
+    params['active']
+  end
+
+  def end_user_visible
+    params['end_user_visible']
+  end
+
+  def fallback_to_default
+    params['fallback_to_default']
+  end
+
+  def associated_to_brand
+    params['associated_to_brand']
+  end
+
+  def mock
+    page(:ticket_forms)
+  end
+end

data/lib/zendesk2/help_center/article.rb

@@ -45,6 +45,10 @@ class Zendesk2::HelpCenter::Article
   attribute :vote_count, type: :integer # ro:yes required:no
   # @return [Integer] The total sum of votes on this article
   attribute :vote_sum, type: :integer # ro:yes required:no
+  # @return [Integer] The id of the user segment which defines who can see this article
+  attribute :user_segment_id, type: :integer, default: nil # ro:no required:yes
+  # @return [Integer] The id of the permission group which defines who can edit and publish this article
+  attribute :permission_group_id, type: :integer # ro:no required:yes
 
   assoc_accessor :section, collection: :help_center_sections
 
@@ -62,7 +66,7 @@ class Zendesk2::HelpCenter::Article
 
   def save!
     response = if new_record?
-                 requires :title, :locale, :section_id
+                 requires :title, :locale, :section_id, :permission_group_id
 
                  cistern.create_help_center_article('article' => attributes)
                else

data/lib/zendesk2/help_center/create_help_center_article.rb

@@ -14,7 +14,19 @@ class Zendesk2::CreateHelpCenterArticle
   end
 
   def self.accepted_attributes
-    %w(author_id body comments_disabled draft label_names locale position promoted section_id title)
+    %w(
+      author_id
+      body
+      comments_disabled
+      draft
+      label_names
+      locale
+      position
+      promoted
+      section_id
+      title user_segment_id
+      permission_group_id
+    )
   end
 
   def article_params
@@ -32,24 +44,26 @@ class Zendesk2::CreateHelpCenterArticle
     position = data[:help_center_articles].values.select { |a| a['section_id'] == section_id }.size
 
     record = {
-      'id'                => identity,
-      'url'               => url_for("/help_center/#{locale}/articles/#{identity}.json"),
-      'html_url'          => html_url_for("/hc/#{locale}/articles/#{identity}.json"),
-      'author_id'         => cistern.current_user['id'],
-      'comments_disabled' => false,
-      'label_names'       => [],
-      'draft'             => false,
-      'promoted'          => false,
-      'position'          => position,
-      'vote_sum'          => 0,
-      'vote_count'        => 0,
-      'section_id'        => section_id,
-      'created_at'        => timestamp,
-      'updated_at'        => timestamp,
-      'title'             => '',
-      'body'              => '',
-      'source_locale'     => locale,
-      'outdated'          => false,
+      'id'                  => identity,
+      'url'                 => url_for("/help_center/#{locale}/articles/#{identity}.json"),
+      'html_url'            => html_url_for("/hc/#{locale}/articles/#{identity}.json"),
+      'author_id'           => cistern.current_user['id'],
+      'comments_disabled'   => false,
+      'label_names'         => [],
+      'draft'               => false,
+      'promoted'            => false,
+      'position'            => position,
+      'vote_sum'            => 0,
+      'vote_count'          => 0,
+      'section_id'          => section_id,
+      'created_at'          => timestamp,
+      'updated_at'          => timestamp,
+      'title'               => '',
+      'body'                => '',
+      'source_locale'       => locale,
+      'outdated'            => false,
+      'user_segment_id'     => 0,
+      'permission_group_id' => 0,
     }.merge(article_params)
 
     data[:help_center_articles][identity] = record

data/lib/zendesk2/mock.rb

@@ -7,6 +7,7 @@ class Zendesk2::Mock
   def self.data
     @data ||= Hash.new do |h, k|
       h[k] = {
+        brands: {},
         categories: {},
         forums: {},
         groups: {},
@@ -24,6 +25,7 @@ class Zendesk2::Mock
         ticket_audits: {},
         ticket_comments: {},
         ticket_fields: {},
+        ticket_forms: {},
         ticket_metrics: {},
         tickets: {},
         topic_comments: {},

data/lib/zendesk2/ticket.rb

@@ -57,6 +57,10 @@ class Zendesk2::Ticket
   attribute :url, type: :string
   # @return [Hash] This object explains how the ticket was created
   attribute :via
+  # @return [Integer] Enterprise only. The id of the ticket form to render for the ticket
+  attribute :ticket_form_id
+  # @return [Integer] Enterprise only. The id of the brand this ticket is associated with
+  attribute :brand_id
 
   # @return [Zendesk2::Organization] organization assigned to ticket
   assoc_reader :organization

data/lib/zendesk2/ticket_field.rb

@@ -45,6 +45,8 @@ class Zendesk2::TicketField
   attribute :url, type: :string
   # @return [Boolean] Whether this field is available to end users
   attribute :visible_in_portal, type: :boolean
+  # @return [String] A description of the ticket field that only agents can see
+  attribute :agent_description, type: :string
 
   def save!
     data = if new_record?

data/lib/zendesk2/ticket_form.rb

@@ -0,0 +1,52 @@
+# frozen_string_literal: true
+class Zendesk2::TicketForm
+  include Zendesk2::Model
+
+  extend Zendesk2::Attributes
+
+  # @return [integer] Automatically assigned upon creation
+  identity :id, type: :integer
+
+  # @return [String] The name of the form
+  attribute :name, type: :string
+  # @return [String] The dynamic content placeholder, if present, or the "name" value, if not
+  attribute :raw_name, type: :string
+  # @return [String] The name of the form that is displayed to an end user
+  attribute :display_name, type: :string
+  # @return [String] The dynamic content placeholder, if present, or the "display_name" value, if not
+  attribute :raw_display_name, type: :string
+  # @return [Integer] The position of this form among other forms in the account, i.e. dropdown
+  attribute :position, type: :integer
+  # @return [Boolean] If the form is set as active
+  attribute :active, type: :boolean
+  # @return [Boolean] Is the form visible to the end user
+  attribute :end_user_visible, type: :boolean
+  # @return [Boolean] Is the form the default form for this account
+  attribute :default, type: :boolean
+  # @return [Array] ids of all ticket fields which are in this ticket form
+  attribute :ticket_field_ids, type: :array
+  # @return [Boolean] Is the form available for use in all brands on this account
+  attribute :in_all_brands, type: :boolean
+  # @return [Array] ids of all brands that this ticket form is restricted to
+  attribute :restricted_brand_ids, type: :array
+
+  def save!
+    data = if new_record?
+             requires :name
+
+             cistern.create_ticket_form('ticket_form' => attributes)
+           else
+             requires :identity
+
+             cistern.update_ticket_form('ticket_form' => attributes)
+           end.body['ticket_form']
+
+    merge_attributes(data)
+  end
+
+  def destroy!
+    requires :identity
+
+    cistern.destroy_ticket_form('ticket_form' => { 'id' => identity })
+  end
+end

data/lib/zendesk2/ticket_forms.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+class Zendesk2::TicketForms
+  include Zendesk2::Collection
+
+  include Zendesk2::Searchable
+
+  model Zendesk2::TicketForm
+
+  attribute :count, type: :integer
+
+  self.collection_method = :get_ticket_forms
+  self.collection_root   = 'ticket_forms'
+  self.model_method      = :get_ticket_form
+  self.model_root        = 'ticket_form'
+  self.search_type       = 'ticket_form'
+end

data/lib/zendesk2/update_brand.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+class Zendesk2::UpdateBrand
+  include Zendesk2::Request
+
+  request_method :put
+  request_path { |r| "/brands/#{r.brand_id}.json" }
+  request_body { |r| { 'brand' => r.brand_params } }
+
+  def brand_id
+    params.fetch('brand').fetch('id')
+  end
+
+  def brand_params
+    Cistern::Hash.slice(params.fetch('brand'), *Zendesk2::CreateTicketForm.accepted_attributes)
+  end
+
+  def mock
+    mock_response('brand' => find!(:brands, brand_id).merge!(brand_params))
+  end
+end

data/lib/zendesk2/update_ticket_form.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+class Zendesk2::UpdateTicketForm
+  include Zendesk2::Request
+
+  request_method :put
+  request_path { |r| "/ticket_forms/#{r.ticket_form_id}.json" }
+  request_body { |r| { 'ticket_form' => r.ticket_form_params } }
+
+  def ticket_form_id
+    params.fetch('ticket_form').fetch('id')
+  end
+
+  def ticket_form_params
+    Cistern::Hash.slice(params.fetch('ticket_form'), *Zendesk2::CreateTicketForm.accepted_attributes)
+  end
+
+  def mock
+    mock_response('ticket_form' => find!(:ticket_forms, ticket_form_id).merge!(ticket_form_params))
+  end
+end

data/lib/zendesk2/version.rb

@@ -1,4 +1,4 @@
 # frozen_string_literal: true
 module Zendesk2
-  VERSION = '1.12.0'.freeze
+  VERSION = '1.13.0'.freeze
 end

data/spec/brands_spec.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+require 'spec_helper'
+
+describe 'brands' do
+  let(:client) { create_client }
+
+  include_examples 'zendesk#resource', collection: -> { client.brands },
+                                       create_params: -> { { name: mock_uuid } },
+                                       update_params: -> { { name: mock_uuid } },
+                                       paged: false,
+                                       search: false
+end

data/spec/help_center/articles_spec.rb

@@ -13,7 +13,8 @@ describe 'help_center/articles' do
 
   include_examples 'zendesk#resource',
                    collection: -> { client.help_center_articles },
-                   create_params: -> { { title: mock_uuid, locale: 'en-us', section: section } },
+                   create_params:
+                     -> { { title: mock_uuid, locale: 'en-us', section: section, permission_group_id: 0 } },
                    update_params: -> { { title: mock_uuid } },
                    search_params: -> { Cistern::Hash.slice(create_params, :title) },
                    search: true

data/spec/help_center/categories_spec.rb

@@ -13,11 +13,14 @@ describe 'help_center/categories' do
   context 'with a category, sections, and articles' do
     let!(:category) { client.help_center_categories.create!(name: mock_uuid, locale: 'en-us') }
     let!(:section)  { category.sections.create!(name: mock_uuid, locale: 'en-us') }
-    let!(:articles) { Array.new(2) { section.articles.create(title: mock_uuid, locale: 'en-us') } }
+    let!(:articles) do
+      Array.new(2) { section.articles.create(title: mock_uuid, locale: 'en-us', permission_group_id: 0) }
+    end
 
     before do
       client.help_center_categories.create!(name: mock_uuid, locale: 'en-us')
-            .sections.create!(name: mock_uuid, locale: 'en-us').articles.create!(title: mock_uuid, locale: 'en-us')
+            .sections.create!(name: mock_uuid, locale: 'en-us')
+            .articles.create!(title: mock_uuid, locale: 'en-us', permission_group_id: 0)
     end
 
     it 'lists sections within a category' do

data/spec/help_center/sections_spec.rb

@@ -18,11 +18,14 @@ describe 'help_center/sections' do
 
   context 'with a category, sections, and articles' do
     let!(:section)  { category.sections.create!(name: mock_uuid, locale: 'en-us') }
-    let!(:articles) { Array.new(2) { section.articles.create(title: mock_uuid, locale: 'en-us') } }
+    let!(:articles) do
+      Array.new(2) { section.articles.create(title: mock_uuid, locale: 'en-us', permission_group_id: 0) }
+    end
 
     before do
       client.help_center_categories.create!(name: mock_uuid, locale: 'en-us')
-            .sections.create!(name: mock_uuid, locale: 'en-us').articles.create!(title: mock_uuid, locale: 'en-us')
+            .sections.create!(name: mock_uuid, locale: 'en-us')
+            .articles.create!(title: mock_uuid, locale: 'en-us', permission_group_id: 0)
     end
 
     it 'lists articles within a section' do

data/spec/help_center/subscriptions_spec.rb

@@ -14,7 +14,8 @@ describe 'help_center/subscriptions' do
     let!(:article) do
       client.help_center_articles.create!(title: mock_uuid,
                                           locale: 'en-us',
-                                          section: section)
+                                          section: section,
+                                          permission_group_id: 0)
     end
 
     include_examples 'zendesk#resource',

data/spec/help_center/translations_spec.rb

@@ -29,7 +29,9 @@ describe 'help_center/translations' do
   end
 
   describe 'by article' do
-    let!(:article) { client.help_center_articles.create!(title: mock_uuid, locale: 'en-us', section: section) }
+    let!(:article) do
+      client.help_center_articles.create!(title: mock_uuid, locale: 'en-us', section: section, permission_group_id: 0)
+    end
 
     include_examples 'zendesk#resource',
                      collection: -> { article.translations },

data/spec/ticket_fields_spec.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 require 'spec_helper'
 
-describe 'ticket_fields' do
+describe '  ticket_fields' do
   let(:client) { create_client }
 
   include_examples 'zendesk#resource', collection: -> { client.ticket_fields },

data/spec/ticket_forms_spec.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+require 'spec_helper'
+
+describe 'ticket_forms' do
+  let(:client) { create_client }
+
+  include_examples 'zendesk#resource', collection: -> { client.ticket_forms },
+                                       create_params: -> { { name: mock_uuid } },
+                                       update_params: -> { { name: mock_uuid } },
+                                       paged: false
+end

data/spec/tickets_spec.rb

@@ -122,6 +122,22 @@ describe 'Zendesk2' do
       expect(ticket.priority).to eq('urgent')
       expect(client.tickets.get!(ticket.id).priority).to eq(priority)
     end
+
+    it 'should set ticket_form_id' do
+      ticket_form_id = 42
+
+      ticket = client.tickets.create!(subject: mock_uuid, description: mock_uuid, ticket_form_id: ticket_form_id)
+
+      expect(ticket.ticket_form_id).to eq(42)
+    end
+
+    it 'should set brand_id' do
+      brand_id = 42
+
+      ticket = client.tickets.create!(subject: mock_uuid, description: mock_uuid, brand_id: brand_id)
+
+      expect(ticket.brand_id).to eq(42)
+    end
   end
 
   describe 'with a created ticket' do

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: zendesk2
 version: !ruby/object:Gem::Version
-  version: 1.12.0
+  version: 1.13.0
 platform: ruby
 authors:
 - Josh Lane
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-10-25 00:00:00.000000000 Z
+date: 2019-08-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: cistern
@@ -106,10 +106,13 @@ files:
 - lib/zendesk2.rb
 - lib/zendesk2/attributes.rb
 - lib/zendesk2/audit_event.rb
+- lib/zendesk2/brand.rb
+- lib/zendesk2/brands.rb
 - lib/zendesk2/categories.rb
 - lib/zendesk2/category.rb
 - lib/zendesk2/client.rb
 - lib/zendesk2/collection.rb
+- lib/zendesk2/create_brand.rb
 - lib/zendesk2/create_category.rb
 - lib/zendesk2/create_forum.rb
 - lib/zendesk2/create_group.rb
@@ -117,12 +120,14 @@ files:
 - lib/zendesk2/create_organization.rb
 - lib/zendesk2/create_ticket.rb
 - lib/zendesk2/create_ticket_field.rb
+- lib/zendesk2/create_ticket_form.rb
 - lib/zendesk2/create_topic.rb
 - lib/zendesk2/create_topic_comment.rb
 - lib/zendesk2/create_user.rb
 - lib/zendesk2/create_user_field.rb
 - lib/zendesk2/create_user_identity.rb
 - lib/zendesk2/create_view.rb
+- lib/zendesk2/destroy_brand.rb
 - lib/zendesk2/destroy_category.rb
 - lib/zendesk2/destroy_forum.rb
 - lib/zendesk2/destroy_group.rb
@@ -130,6 +135,7 @@ files:
 - lib/zendesk2/destroy_organization.rb
 - lib/zendesk2/destroy_ticket.rb
 - lib/zendesk2/destroy_ticket_field.rb
+- lib/zendesk2/destroy_ticket_form.rb
 - lib/zendesk2/destroy_topic.rb
 - lib/zendesk2/destroy_topic_comment.rb
 - lib/zendesk2/destroy_user.rb
@@ -140,6 +146,8 @@ files:
 - lib/zendesk2/forum.rb
 - lib/zendesk2/forums.rb
 - lib/zendesk2/get_assignable_groups.rb
+- lib/zendesk2/get_brand.rb
+- lib/zendesk2/get_brands.rb
 - lib/zendesk2/get_categories.rb
 - lib/zendesk2/get_category.rb
 - lib/zendesk2/get_ccd_tickets.rb
@@ -163,6 +171,8 @@ files:
 - lib/zendesk2/get_ticket_comments.rb
 - lib/zendesk2/get_ticket_field.rb
 - lib/zendesk2/get_ticket_fields.rb
+- lib/zendesk2/get_ticket_form.rb
+- lib/zendesk2/get_ticket_forms.rb
 - lib/zendesk2/get_ticket_metric.rb
 - lib/zendesk2/get_ticket_metrics.rb
 - lib/zendesk2/get_tickets.rb
@@ -270,6 +280,8 @@ files:
 - lib/zendesk2/ticket_create.rb
 - lib/zendesk2/ticket_field.rb
 - lib/zendesk2/ticket_fields.rb
+- lib/zendesk2/ticket_form.rb
+- lib/zendesk2/ticket_forms.rb
 - lib/zendesk2/ticket_metric.rb
 - lib/zendesk2/ticket_metrics.rb
 - lib/zendesk2/ticket_notification.rb
@@ -279,6 +291,7 @@ files:
 - lib/zendesk2/topic_comment.rb
 - lib/zendesk2/topic_comments.rb
 - lib/zendesk2/topics.rb
+- lib/zendesk2/update_brand.rb
 - lib/zendesk2/update_category.rb
 - lib/zendesk2/update_forum.rb
 - lib/zendesk2/update_group.rb
@@ -286,6 +299,7 @@ files:
 - lib/zendesk2/update_request.rb
 - lib/zendesk2/update_ticket.rb
 - lib/zendesk2/update_ticket_field.rb
+- lib/zendesk2/update_ticket_form.rb
 - lib/zendesk2/update_topic.rb
 - lib/zendesk2/update_user.rb
 - lib/zendesk2/update_user_field.rb
@@ -300,6 +314,7 @@ files:
 - lib/zendesk2/version.rb
 - lib/zendesk2/view.rb
 - lib/zendesk2/views.rb
+- spec/brands_spec.rb
 - spec/categories_spec.rb
 - spec/client_spec.rb
 - spec/forums_spec.rb
@@ -320,6 +335,7 @@ files:
 - spec/support/client_helper.rb
 - spec/support/data_helper.rb
 - spec/ticket_fields_spec.rb
+- spec/ticket_forms_spec.rb
 - spec/tickets_spec.rb
 - spec/topic_comments_spec.rb
 - spec/topics_spec.rb
@@ -348,12 +364,12 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.5.1
+rubygems_version: 3.0.1
 signing_key: 
 specification_version: 4
 summary: Zendesk V2 API client
 test_files:
+- spec/brands_spec.rb
 - spec/categories_spec.rb
 - spec/client_spec.rb
 - spec/forums_spec.rb
@@ -374,6 +390,7 @@ test_files:
 - spec/support/client_helper.rb
 - spec/support/data_helper.rb
 - spec/ticket_fields_spec.rb
+- spec/ticket_forms_spec.rb
 - spec/tickets_spec.rb
 - spec/topic_comments_spec.rb
 - spec/topics_spec.rb
@@ -382,4 +399,3 @@ test_files:
 - spec/users_spec.rb
 - spec/views_spec.rb
 - spec/zendesk2_spec.rb
-has_rdoc: