gitlab-customer-support-operations_zendesk 1.0.0

data/lib/support_ops_zendesk/zendesk/help_center_management_permission_groups.rb

@@ -0,0 +1,271 @@
+# frozen_string_literal: true
+
+# Defines the module SupportOps.
+module SupportOps
+  # Defines the module Zendesk
+  module Zendesk
+    ##
+    # Defines the class HelpCenterManagementPermissionGroups within the module {SupportOps::Zendesk}.
+    #
+    # @author Jason Colyer
+    # @since 1.0.0
+    # @attr [Boolean] built_in Whether the permission group is built-in; built-in permission groups cannot be modified
+    # @attr [String] created_at When the permission group was created
+    # @attr [Array] edit The ids of user segments that have edit privileges
+    # @attr [Integer] id Automatically assigned when the permission group is created
+    # @attr [String] name Permission group name
+    # @attr [Array] publish The ids of user segments that have publish privileges
+    # @attr [String] updated_at When the permission group was last updated
+    class HelpCenterManagementPermissionGroups < SupportOps::Zendesk::Base
+      # @!parse
+      #   # Creates/updates a management permission group
+      #   # 
+      #   # @author Jason Colyer
+      #   # @since 1.0.0
+      #   # @return [Object] Instance of {SupportOps::Zendesk::HelpCenterManagementPermissionGroups}
+      #   # @note This is inherited from {SupportOps::Zendesk::Base#save!}
+      #   # @see
+      #   #   https://developer.zendesk.com/api-reference/help_center/help-center-api/permission_groups/#create-permission-group
+      #   #   Zendesk API > Management Permission Groups > Create Permission Group
+      #   # @see
+      #   #   https://developer.zendesk.com/api-reference/help_center/help-center-api/permission_groups/#update-permission-group
+      #   #   Zendesk API > Management Permission Groups > Update Permission Group
+      #   # @example
+      #   #   require 'support_ops_zendesk'
+      #   #
+      #   #   SupportOps::Zendesk::Configuration.configure do |config|
+      #   #     config.url = 'https://gitlab.zendesk.com/api/v2'
+      #   #     config.username = 'jason@example.com'
+      #   #     config.token = 'abc123'
+      #   #   end
+      #   #
+      #   #   new_group = SupportOps::Zendesk::HelpCenterManagementPermissionGroups.new
+      #   #   new_group.name = 'Publisher'
+      #   #   new_group.edit = [123456]
+      #   #   new_group.publish = [123456]
+      #   #
+      #   #   new_group.save!
+      #   #
+      #   #   pp new_group.id
+      #   #   # => 122
+      #   # @example
+      #   #   require 'support_ops_zendesk'
+      #   #
+      #   #   SupportOps::Zendesk::Configuration.configure do |config|
+      #   #     config.url = 'https://gitlab.zendesk.com/api/v2'
+      #   #     config.username = 'jason@example.com'
+      #   #     config.token = 'abc123'
+      #   #   end
+      #   #
+      #   #   existing_group = SupportOps::Zendesk::HelpCenterManagementPermissionGroups.new
+      #   #   existing_group.name = 'Publishers'
+      #   #
+      #   #   existing_group.save!
+      #   #
+      #   #   pp existing_group.name
+      #   #   # => "Publishers"
+      #   def save!; end
+      # @!parse
+      #   # Deletes a management permission group
+      #   # 
+      #   # @author Jason Colyer
+      #   # @since 1.0.0
+      #   # @return [Boolean]
+      #   # @note This is inherited from {SupportOps::Zendesk::Base#delete!}
+      #   # @see
+      #   #   https://developer.zendesk.com/api-reference/help_center/help-center-api/permission_groups/#delete-permission-group
+      #   #   Zendesk API > Management Permission Groups > Delete Permission Group
+      #   # @example
+      #   #   require 'support_ops_zendesk'
+      #   #
+      #   #   SupportOps::Zendesk::Configuration.configure do |config|
+      #   #     config.url = 'https://gitlab.zendesk.com/api/v2'
+      #   #     config.username = 'jason@example.com'
+      #   #     config.token = 'abc123'
+      #   #   end
+      #   #
+      #   #   existing_group = SupportOps::Zendesk::HelpCenterManagementPermissionGroups.get!(122)
+      #   #   existing_group.delete!
+      #   def delete!; end
+      define_attributes :built_in, :created_at, :edit, :id, :name, :publish,
+                        :updated_at
+      readonly_attributes :built_in, :created_at, :id, :updated_at
+
+      ##
+      # Lists Help Center management permission groups in the Zendesk system
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @overload list(key: value)
+      #   @param limit [Integer optional] The limit to the number of user
+      #     segments returned. Default to 0 (i.e. no limit)
+      # @return [Array]
+      # @see
+      #   https://developer.zendesk.com/api-reference/help_center/help-center-api/permission_groups/#list-permission-groups
+      #   Zendesk API > Management Permission Groups > List Permission Groups
+      # @see SupportOps::Zendesk::Configuration Setting up a client
+      # @example
+      #   require 'support_ops_zendesk'
+      #
+      #   SupportOps::Zendesk::Configuration.configure do |config|
+      #     config.url = 'https://gitlab.zendesk.com/api/v2'
+      #     config.username = 'jason@example.com'
+      #     config.token = 'abc123'
+      #   end
+      #
+      #   groups = SupportOps::Zendesk::HelpCenterManagementPermissionGroups.list(limit: 10)
+      #   pp groups.count
+      #   # => 5
+      #   pp groups.last.name
+      #   # => "5th management permission group"
+      def self.list(**args)
+        args[:limit] = 0 unless args[:limit]
+        array = []
+        page = 1
+        loop do
+          response = client.connection.get("guide/permission_groups?page=#{page}")
+          body = Oj.load(response.body)
+          array += body['permission_groups'].map { |p| HelpCenterManagementPermissionGroups.new(p) }
+          break if args[:limit].to_i.positive? && array.count >= args[:limit].to_i
+          break unless body['permission_groups'].count == 100
+
+          page += 1
+        end
+        return array if args[:limit].to_i.zero?
+        
+        array.first(args[:limit].to_i)
+      end
+
+      ##
+      # Locates a management permission group within Zendesk by name. Can utilize a cache for quicker results
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @overload find_by_name(key: value)
+      #   @param name [String required] The name to search for
+      #   @param cache [Array] An Array of SupportOps::Zendesk::HelpCenterManagementPermissionGroups to use as a cache
+      # @return [Object] An instance of {SupportOps::Zendesk::HelpCenterManagementPermissionGroups}
+      # @example
+      #   require 'support_ops_zendesk'
+      #
+      #   SupportOps::Zendesk::Configuration.configure do |config|
+      #     config.url = 'https://gitlab.zendesk.com/api/v2'
+      #     config.username = 'jason@example.com'
+      #     config.token = 'abc123'
+      #   end
+      #
+      #   groups = SupportOps::Zendesk::HelpCenterManagementPermissionGroups.list
+      #   group = SupportOps::Zendesk::HelpCenterManagementPermissionGroups.find_by_name(name: 'Admins', cache: groups)
+      #   pp group.name
+      #   # => "Admins"
+      #   pp segment.id
+      #   # => 123456
+      def self.find_by_name(**args)
+        raise 'You have to provide a name' unless args[:name]
+        if args[:cache]
+          raise 'Provided cache is not an Array' unless args[:cache].is_a? Array
+          groups = args[:cache]
+        else
+          groups = list
+        end
+        groups.detect { |s| s.name.downcase == args[:name].to_s.downcase }
+      end
+
+      ##
+      # Locates a specific management permission group in the Zendesk system
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @see
+      #   https://developer.zendesk.com/api-reference/help_center/help-center-api/permission_groups/#show-permission-group
+      #   Zendesk API > Management Permission Groups > Show Permission Group
+      # @see SupportOps::Zendesk::Configuration Setting up a client
+      # @example
+      #   require 'support_ops_zendesk'
+      #
+      #   SupportOps::Zendesk::Configuration.configure do |config|
+      #     config.url = 'https://gitlab.zendesk.com/api/v2'
+      #     config.username = 'jason@example.com'
+      #     config.token = 'abc123'
+      #   end
+      #
+      #   group = SupportOps::Zendesk::HelpCenterManagementPermissionGroups.get(123456)
+      #   pp group.name
+      #   # => "Admins"
+      def self.get(object)
+        if object.is_a? HelpCenterManagementPermissionGroups
+          HelpCenterManagementPermissionGroups.new(id: id).find
+        else
+          HelpCenterManagementPermissionGroups.new(id: object).find
+        end
+      end
+
+      ##
+      # Locates a specific management permission group in the Zendesk system
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @see
+      #   https://developer.zendesk.com/api-reference/help_center/help-center-api/permission_groups/#show-permission-group
+      #   Zendesk API > Management Permission Groups > Show Permission Group
+      # @see SupportOps::Zendesk::Configuration Setting up a client
+      # @example
+      #   require 'support_ops_zendesk'
+      #
+      #   SupportOps::Zendesk::Configuration.configure do |config|
+      #     config.url = 'https://gitlab.zendesk.com/api/v2'
+      #     config.username = 'jason@example.com'
+      #     config.token = 'abc123'
+      #   end
+      #
+      #   group = SupportOps::Zendesk::HelpCenterManagementPermissionGroups.get!(123456)
+      #   pp group.name
+      #   # => "Admins"
+      def self.get!(object)
+        if object.is_a? HelpCenterManagementPermissionGroups
+          HelpCenterManagementPermissionGroups.new(id: id).find!
+        else
+          HelpCenterManagementPermissionGroups.new(id: object).find!
+        end
+      end
+
+      private
+
+      ##
+      # @private
+      def get_record
+        response = self.client.connection.get("guide/permission_groups/#{self.id}")
+        return nil if response.status != 200
+
+        Oj.load(response.body)['permission_group']
+      end
+
+      ##
+      # @private
+      def create_record
+        response = self.client.connection.post("guide/permission_groups", { permission_group: attributes_for_save }.to_json)
+        body = Oj.load(response.body)
+        raise "Failed to create management permission group => #{body}" if response.status != 201
+        body['permission_group']
+      end
+
+      ##
+      # @private
+      def update_record
+        raise "Failed to update user segment => You didn't change anything in the object" if attributes_for_save.keys == [:id]
+        response = self.client.connection.put("guide/permission_groups/#{self.id}", { permission_group: attributes_for_save }.to_json)
+        body = Oj.load(response.body)
+        raise "Failed to update management permission group #{self.id} => #{body}" if response.status != 200
+        body['permission_group']
+      end
+
+      ##
+      # @private
+      def delete_record
+        response = self.client.connection.delete("guide/permission_groups/#{self.id}")
+        raise "Failed to delete management permission group #{self.id} => #{body}" if response.status != 204
+        true
+      end
+    end
+  end
+end

data/lib/support_ops_zendesk/zendesk/help_center_sections.rb

@@ -0,0 +1,378 @@
+# frozen_string_literal: true
+
+# Defines the module SupportOps.
+module SupportOps
+  # Defines the module Zendesk
+  module Zendesk
+    ##
+    # Defines the class HelpCenterSections within the module {SupportOps::Zendesk}.
+    #
+    # @author Jason Colyer
+    # @since 1.0.0
+    # @attr [Integer] category_id The id of the category to which this section belongs
+    # @attr [String] created_at The time at which the section was created
+    # @attr [String] description The description of the section
+    # @attr [String] html_url 	The url of this section in HC
+    # @attr [Integer] id Automatically assigned when creating subscriptions
+    # @attr [String] locale The locale in which the section is displayed
+    # @attr [String] name The name of the section
+    # @attr [Boolean] outdated Whether the section is out of date
+    # @attr [Integer] parent_section_id The id of the section to which this section belongs
+    # @attr [Integer] position The position of this section in the section list; used when sorting is set to 'manual'; by default the section is added to the end of the list
+    # @attr [String] source_locale The source (default) locale of the section
+    # @attr [String] theme_template The theme template name used to display this section in Help Center
+    # @attr [String] updated_at The time at which the section was last updated
+    # @todo Update Section Source Locale > https://developer.zendesk.com/api-reference/help_center/help-center-api/sections/#update-section-source-locale
+    class HelpCenterSections < SupportOps::Zendesk::Base
+      # @!parse
+      #   # Creates/updates a section
+      #   # 
+      #   # @author Jason Colyer
+      #   # @since 1.0.0
+      #   # @return [Object] Instance of {SupportOps::Zendesk::HelpCenterSections}
+      #   # @note This is inherited from {SupportOps::Zendesk::Base#save!}
+      #   # @see
+      #   #   https://developer.zendesk.com/api-reference/help_center/help-center-api/sections/#create-section
+      #   #   Zendesk API > Sections > Create Section
+      #   # @see
+      #   #   https://developer.zendesk.com/api-reference/help_center/help-center-api/sections/#update-section
+      #   #   Zendesk API > Sections > Update Section
+      #   # @example
+      #   #   require 'support_ops_zendesk'
+      #   #
+      #   #   SupportOps::Zendesk::Configuration.configure do |config|
+      #   #     config.url = 'https://gitlab.zendesk.com/api/v2'
+      #   #     config.username = 'jason@example.com'
+      #   #     config.token = 'abc123'
+      #   #   end
+      #   #
+      #   #   new_section = SupportOps::Zendesk::HelpCenterSections.new
+      #   #   new_section.name = 'Docker'
+      #   #   new_section.category_id = 456
+      #   #   new_section.locale = 'en-us'
+      #   #   new_section.position = 4
+      #   #   new_section.description = 'This is for Docker articles'
+      #   #
+      #   #   new_section.save!
+      #   #
+      #   #   pp new_section.id
+      #   #   # => 122
+      #   # @example
+      #   #   require 'support_ops_zendesk'
+      #   #
+      #   #   SupportOps::Zendesk::Configuration.configure do |config|
+      #   #     config.url = 'https://gitlab.zendesk.com/api/v2'
+      #   #     config.username = 'jason@example.com'
+      #   #     config.token = 'abc123'
+      #   #   end
+      #   #
+      #   #   existing_section = SupportOps::Zendesk::HelpCenterSections.get!(122)
+      #   #   existing_section.position = existing_section.position + 1
+      #   #
+      #   #   existing_section.save!
+      #   #
+      #   #   pp existing_section.position
+      #   #   # => 5
+      #   def save!; end
+      # @!parse
+      #   # Deletes a section
+      #   # 
+      #   # @author Jason Colyer
+      #   # @since 1.0.0
+      #   # @return [Boolean]
+      #   # @note This is inherited from {SupportOps::Zendesk::Base#delete!}
+      #   # @see
+      #   #   https://developer.zendesk.com/api-reference/help_center/help-center-api/sections/#delete-section
+      #   #   Zendesk API > Sections > Delete Section
+      #   # @example
+      #   #   require 'support_ops_zendesk'
+      #   #
+      #   #   SupportOps::Zendesk::Configuration.configure do |config|
+      #   #     config.url = 'https://gitlab.zendesk.com/api/v2'
+      #   #     config.username = 'jason@example.com'
+      #   #     config.token = 'abc123'
+      #   #   end
+      #   #
+      #   #   existing_section = SupportOps::Zendesk::HelpCenterSections.get!(122)
+      #   #   existing_section.delete!
+      #   def delete!; end
+      # @!parse
+      #   # Shows info on the parent section (if one exists)
+      #   # 
+      #   # @author Jason Colyer
+      #   # @since 1.0.0
+      #   # @note This is inherited from {SupportOps::Zendesk::Base#parent}
+      #   # @see
+      #   #   https://developer.zendesk.com/api-reference/help_center/help-center-api/sections/#show-section
+      #   #   Zendesk API > Sections > Show Section
+      #   # @example
+      #   #   require 'support_ops_zendesk'
+      #   #
+      #   #   SupportOps::Zendesk::Configuration.configure do |config|
+      #   #     config.url = 'https://gitlab.zendesk.com/api/v2'
+      #   #     config.username = 'jason@example.com'
+      #   #     config.token = 'abc123'
+      #   #   end
+      #   #
+      #   #   existing_section = SupportOps::Zendesk::HelpCenterSections.get!(122)
+      #   #   parent = existing_section.parent
+      #   #   pp parent.name
+      #   #   # => "Support Pages"
+      #   def parent; end
+      # @!parse
+      #   # Lists translations
+      #   # 
+      #   # @author Jason Colyer
+      #   # @since 1.0.0
+      #   # @note This is inherited from {SupportOps::Zendesk::Base#translations}
+      #   # @see
+      #   #   https://developer.zendesk.com/api-reference/help_center/help-center-api/translations/#list-translations
+      #   #   Zendesk API > Translations > Show Translations
+      #   # @example
+      #   #   require 'support_ops_zendesk'
+      #   #
+      #   #   SupportOps::Zendesk::Configuration.configure do |config|
+      #   #     config.url = 'https://gitlab.zendesk.com/api/v2'
+      #   #     config.username = 'jason@example.com'
+      #   #     config.token = 'abc123'
+      #   #   end
+      #   #
+      #   #   existing_section = SupportOps::Zendesk::HelpCenterSections.get!(122)
+      #   #   translations = existing_section.translations
+      #   #   pp translations.count
+      #   #   # => 2
+      #   def parent; end
+      define_attributes :category_id, :created_at, :description, :html_url, :id,
+                        :locale, :name, :outdated, :parent_section_id,
+                        :position, :source_locale, :theme_template, :updated_at
+      readonly_attributes :created_at, :html_url, :id, :outdated,
+                          :source_locale, :updated_at
+
+      ##
+      # Lists Help Center sections in the Zendesk system
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @overload list(key: value)
+      #   @param locale [String optional] Filter sections by a specific locale
+      #   @param category_id [Integer optional] Filter sections by a category
+      #   @param sort_by [String optional] Possible values are "position",
+      #     "created_at", "updated_at" (defauls to "position")
+      #   @param sort_order [String optional] One of "asc" or "desc"
+      #   @param limit [Integer optional] The limit to the number of sections
+      #     returned. Default to 0 (i.e. no limit)
+      # @return [Array]
+      # @see
+      #   https://developer.zendesk.com/api-reference/help_center/help-center-api/sections/#list-sections
+      #   Zendesk API > Sections > List Sections
+      # @see SupportOps::Zendesk::Configuration Setting up a client
+      # @example
+      #   require 'support_ops_zendesk'
+      #
+      #   SupportOps::Zendesk::Configuration.configure do |config|
+      #     config.url = 'https://gitlab.zendesk.com/api/v2'
+      #     config.username = 'jason@example.com'
+      #     config.token = 'abc123'
+      #   end
+      #
+      #   sections = SupportOps::Zendesk::HelpCenterSections.list(limit: 10)
+      #   pp sections.count
+      #   # => 10
+      #   pp sections.last.name
+      #   # => "I'm the 10th section"
+      def self.list(**args)
+        args[:limit] = 0 unless args[:limit]
+        array = []
+        opts = 'page[size]=100'
+        opts += "&sort_by=#{args[:sort_by]}" if args[:sort_by]
+        opts += "&sort_order=#{args[:sort_order]}" if args[:sort_order]
+        locale = if args[:locale].to_s != ''
+                   "#{args[:locale].to_s}/"
+                 else
+                  ''
+                 end
+        category = if args[:category_id].to_i != 0
+                     "categories/#{args[:category_id].to_i}/"
+                   else
+                    ''
+                   end
+        url = "help_center/#{locale}#{category}sections"
+        loop do
+          response = client.connection.get("#{url}?#{opts}")
+          body = Oj.load(response.body)
+          array += body['sections'].map { |s| HelpCenterSections.new(s) }
+          break if args[:limit].to_i.positive? && array.count >= args[:limit].to_i
+          break unless body['meta']['has_more']
+
+          opts = body['links']['next'].split('?').last
+        end
+        return array if args[:limit].to_i.zero?
+        
+        array.first(args[:limit].to_i)
+      end
+
+      ##
+      # Locates a section within Zendesk by name. Can utilize a cache for quicker results
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @overload find_by_name(key: value)
+      #   @param name [String required] The name to search for
+      #   @param cache [Array] An Array of SupportOps::Zendesk::HelpCenterSections to use as a cache
+      # @return [Object] An instance of {SupportOps::Zendesk::HelpCenterSections}
+      # @example
+      #   require 'support_ops_zendesk'
+      #
+      #   SupportOps::Zendesk::Configuration.configure do |config|
+      #     config.url = 'https://gitlab.zendesk.com/api/v2'
+      #     config.username = 'jason@example.com'
+      #     config.token = 'abc123'
+      #   end
+      #
+      #   sections = SupportOps::Zendesk::HelpCenterSections.list
+      #   section = SupportOps::Zendesk::HelpCenterSections.find_by_name(name: 'Test Section', cache: sections)
+      #   pp section.name
+      #   # => "Test Section"
+      #   pp section.id
+      #   # => 123456
+      def self.find_by_name(**args)
+        raise 'You have to provide a name' unless args[:name]
+        if args[:cache]
+          raise 'Provided cache is not an Array' unless args[:cache].is_a? Array
+          sections = args[:cache]
+        else
+          sections = list
+        end
+        sections.detect { |s| s.name.downcase == args[:name].to_s.downcase }
+      end
+
+      ##
+      # Locates a specific section in the Zendesk system
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @see
+      #   https://developer.zendesk.com/api-reference/help_center/help-center-api/sections/#show-section
+      #   Zendesk API > Sections > Show Section
+      # @see SupportOps::Zendesk::Configuration Setting up a client
+      # @example
+      #   require 'support_ops_zendesk'
+      #
+      #   SupportOps::Zendesk::Configuration.configure do |config|
+      #     config.url = 'https://gitlab.zendesk.com/api/v2'
+      #     config.username = 'jason@example.com'
+      #     config.token = 'abc123'
+      #   end
+      #
+      #   section = SupportOps::Zendesk::HelpCenterSections.get(123456)
+      #   pp section.name
+      #   # => "Test Section"
+      def self.get(object)
+        if object.is_a? HelpCenterSections
+          HelpCenterSections.new(id: id).find
+        else
+          HelpCenterSections.new(id: object).find
+        end
+      end
+
+      ##
+      # Locates a specific section in the Zendesk system
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @see
+      #   https://developer.zendesk.com/api-reference/help_center/help-center-api/sections/#show-section
+      #   Zendesk API > Sections > Show Section
+      # @see SupportOps::Zendesk::Configuration Setting up a client
+      # @example
+      #   require 'support_ops_zendesk'
+      #
+      #   SupportOps::Zendesk::Configuration.configure do |config|
+      #     config.url = 'https://gitlab.zendesk.com/api/v2'
+      #     config.username = 'jason@example.com'
+      #     config.token = 'abc123'
+      #   end
+      #
+      #   section = SupportOps::Zendesk::HelpCenterSections.get!(123456)
+      #   pp section.name
+      #   # => "Test Section"
+      def self.get!(object)
+        if object.is_a? HelpCenterSections
+          HelpCenterSections.new(id: id).find!
+        else
+          HelpCenterSections.new(id: object).find!
+        end
+      end
+
+      private
+
+      ##
+      # @private
+      def get_record
+        response = self.client.connection.get("help_center/sections/#{self.id}")
+        return nil if response.status != 200
+
+        Oj.load(response.body)['section']
+      end
+
+      ##
+      # @private
+      def create_record
+        data = {
+          'name' => self.name,
+          'description' => self.description,
+          'position' => self.position,
+          'locale' => self.locale,
+          'parent_section_id' => self.parent_section_id,
+          'theme_template' => self.theme_template
+        }
+        data.delete('position') if data['position'].nil?
+        response = self.client.connection.post("help_center/categories/#{self.category_id}/sections", { section: data }.to_json)
+        body = Oj.load(response.body)
+        raise "Failed to create section => #{body}" if response.status != 201
+        body['section']
+      end
+
+      ##
+      # @private
+      def update_record
+        raise "Failed to update section => You didn't change anything in the object" if attributes_for_save.keys == [:id]
+        data = {
+          'name' => self.name,
+          'description' => self.description,
+          'position' => self.position,
+          'category_id' => self.category_id,
+          'parent_section_id' => self.parent_section_id,
+          'theme_template' => self.theme_template
+        }
+        data.delete('position') if data['position'].nil?
+        response = self.client.connection.put("help_center/#{self.locale}/sections/#{self.id}", { section: data }.to_json)
+        body = Oj.load(response.body)
+        raise "Failed to update section #{self.id} => #{body}" if response.status != 200
+        body['section']
+      end
+
+      ##
+      # @private
+      def delete_record
+        response = self.client.connection.delete("help_center/sections/#{self.id}")
+        raise "Failed to delete section #{self.id} => #{body}" if response.status != 204
+        true
+      end
+
+      ##
+      # @private
+      def parent_record
+        return nil if self.parent_section_id.nil?
+
+        HelpCenterSections.get(self.parent_section_id)
+      end
+
+      ##
+      # @private
+      def translations_record
+        Translations.list(self)
+      end
+    end
+  end
+end