cloudinary 1.18.0 → 1.21.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c9179fe1c8105281b33780687c2bed49db41a35fca2d33ff15bd7fd4635d119f
-  data.tar.gz: 7b3bd01f71f1012bc7f315f707450ebb65537064e004fad615d713f489c4316c
+  metadata.gz: fbc5f576707d33b684e97610585e92838695cbd373cace7c16b0078021b46871
+  data.tar.gz: a5fc7e5d8f0930223cb03b4ca07910ba3b8a6e8ac18b5d6028f9a8963311f8d8
 SHA512:
-  metadata.gz: 347fc122e9a31aa241afa194c09cdc3c0d19e63c5a206cc7751f4939de7c273769d648c7fd33af2cc4e7505fba0a5be9d555f1c3db1e2b41d45cfb58082e1cc3
-  data.tar.gz: 4f04b59256afe8f23c27625d94d761e9802e2ccd91d3c3dc992eb263e3430a7a053467c203d416d379815e317924f042c9310ac0f2b4ca185630307268aa66ca
+  metadata.gz: 888d693726c91cba5113ca6d4e13f89b859fc01fde5603ace994eb13a907881d4d5e84a7150501c970b1792c47286ae4a9d889f61b1e41408e25a4aea20cf11d
+  data.tar.gz: 6a76cfcc6187c87314f1676a769b8fbfcfda08a5a22d00403f689056a680e4acb15d7360b919a2132c254295c8439e2072be74a8a2891362920f217d387d14ef

data/.github/ISSUE_TEMPLATE/bug_report.md

@@ -3,7 +3,7 @@ name: Bug report
 about: Bug report for Cloudinary Ruby SDK
 title: ''
 labels: ''
-assignees: const-cloudinary
+assignees: ''
 
 ---
 
@@ -14,11 +14,11 @@ Before proceeding, please update to latest version and test if the issue persist
 …
 
 ## Issue Type (Can be multiple)
-[ ] Build - Can’t install or import the SDK
-[ ] Performance - Performance issues
-[ ] Behaviour - Functions aren’t working as expected (Such as generate URL)
-[ ] Documentation - Inconsistency between the docs and behaviour
-[ ] Other (Specify)
+- [ ] Build - Cannot install or import the SDK
+- [ ] Performance - Performance issues
+- [ ] Behaviour - Functions are not working as expected (such as generate URL)
+- [ ] Documentation - Inconsistency between the docs and behaviour
+- [ ] Other (Specify)
 
 ## Steps to reproduce
 … if applicable
@@ -27,16 +27,17 @@ Before proceeding, please update to latest version and test if the issue persist
 …
 
 ## Operating System
-[ ] Linux
-[ ] Windows
-[ ] OSX
-[ ] All
+- [ ] Linux
+- [ ] Windows
+- [ ] macOS
+- [ ] All
 
 ## Environment and Libraries (fill in the version numbers)
-Cloudinary Ruby SDK version - 0.0.0
-Ruby Version - 0.0.0
-Rails Version - 0.0.0 
-Other Libraries (Carrierwave, ActiveStorage, etc) - 0.0.0
+- Cloudinary Ruby SDK version - 0.0.0
+- Ruby Version - 0.0.0
+- Rails Version - 0.0.0 
+- Other Libraries (Carrierwave, ActiveStorage, etc) - 0.0.0
 
 ## Repository
+
 If possible, please provide a link to a reproducible repository that showcases the problem

data/.github/ISSUE_TEMPLATE/feature_request.md

@@ -3,7 +3,7 @@ name: Feature request
 about: Feature request for Cloudinary Ruby SDK
 title: ''
 labels: ''
-assignees: const-cloudinary
+assignees: ''
 
 ---
 

data/.github/pull_request_template.md

@@ -4,21 +4,28 @@ Provide some context as to what was changed, from an implementation standpoint.
 -->
 
 #### What does this PR address?
-[ ] Gitub issue (Add reference - #XX)
-[ ] Refactoring
-[ ] New feature
-[ ] Bug fix
-[ ] Adds more tests
+- [ ] GitHub issue (Add reference - #XX)
+- [ ] Refactoring
+- [ ] New feature
+- [ ] Bug fix
+- [ ] Adds more tests
 
 #### Are tests included?
-[ ] Yes
-[ ] No
+- [ ] Yes
+- [ ] No
 
-#### Reviewer, Please Note:
+#### Reviewer, please note:
 <!--
 List anything here that the reviewer should pay special attention to. This might
 include, for example:
-• Dependence on other PRs
-• Reference to other Cloudinary SDKs
-• Changes that seem arbitrary without further explanations
+* Dependence on other PRs
+* Reference to other Cloudinary SDKs
+* Changes that seem arbitrary without further explanations
 -->
+
+#### Checklist:
+<!--- Go over all the following points, and put an `x` in all the boxes that apply. -->
+<!--- If you're unsure about any of these, don't hesitate to ask. We're here to help! -->
+- [ ] My code follows the code style of this project.
+- [ ] My change requires a change to the documentation.
+- [ ] I ran the full test suite before pushing the changes and all the tests pass.

data/CHANGELOG.md

@@ -1,3 +1,72 @@
+1.21.0 / 2021-08-23
+==================
+
+New functionality and features
+------------------------------
+
+  * Add support for `create_slideshow` Upload API
+  * Add support for variables in text style
+  * Add support for `context` and `metadata` in `rename` Upload API
+  * Add support for `reorder_metadata_field_datasource` Admin API
+  * Add `verify_api_response_signature` and `verify_notification_signature` helpers
+  * Add `download_generated_sprite` and `download_multi` methods
+  * Add support for `urls` in multi and sprite APIs
+  * Add support for `live` parameter in upload presets
+  * Add support for `metadata` parameter in `resources` Admin APIs
+
+Other Changes
+-------------
+
+  * Fix `transformations` API call
+  * Fix named parameters normalization issue
+  * Remove duplicates in Search Api fields
+  * Improve configuration tests
+  * Add tests for Provisioning API
+  * Refactor metadata usage in tests
+  * Update GitHub templates
+
+1.20.0 / 2021-03-26
+==================
+
+New functionality and features
+------------------------------
+
+  * Add support for `download_backedup_asset` helper method
+  * Add support for `filename_override` upload parameter
+  * Add support for `SHA-256` algorithm in auth signatures
+    
+Other Changes
+-------------
+
+* Fix `type` parameter support in ActiveStorage service
+* Fix expression normalization in advanced cases
+* Add test for context metadata as user variables
+* Improve validation of auth token generation
+
+
+1.19.0 / 2021-03-05
+==================
+
+New functionality and features
+------------------------------
+
+* Add Account Provisioning API
+* Add support for `api_proxy` parameter
+* Add support for `date` parameter in `usage`  Admin API
+
+Other Changes
+-------------
+
+* Fix direct upload of raw files
+* Improve unit testing of add-ons
+* Change test for `eval` upload parameter
+* Bump vulnerable version of rubyzip
+* Fix `cloudinary.gemspec` glob issue
+
+1.18.1 / 2020-09-30
+===================
+
+  * Update embedded `jquery.cloudinary.js` to fix ES5 compatibility issue
 
 1.18.0 / 2020-09-27
 ===================

data/cloudinary.gemspec

@@ -15,12 +15,17 @@ Gem::Specification.new do |s|
 
   s.rubyforge_project = "cloudinary"
 
-  s.files         = (`git ls-files`.split("\n") - `git ls-files {test,spec,features,samples}/*`.split("\n")) + Dir.glob("vendor/assets/javascripts/*/*") + Dir.glob("vendor/assets/html/*")
+  s.files         = `git ls-files`.split("\n").select { |f| !f.start_with?("test", "spec", "features", "samples") } + Dir.glob("vendor/assets/javascripts/*/*") + Dir.glob("vendor/assets/html/*")
   s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
   s.require_paths = ["lib"]
 
   s.add_dependency "aws_cf_signer"
-  s.add_dependency "rest-client"
+
+  if RUBY_VERSION >= "2.0.0"
+    s.add_dependency "rest-client", ">= 2.0.0"
+  else
+    s.add_dependency "rest-client"
+  end
 
   s.add_development_dependency "actionpack"
   s.add_development_dependency "nokogiri"
@@ -39,7 +44,7 @@ Gem::Specification.new do |s|
   s.add_development_dependency "railties", "<= 4.2.7" if RUBY_VERSION <= "1.9.3"
   s.add_development_dependency "rspec-rails"
 
-  s.add_development_dependency "rubyzip", "<=1.2.0" # support testing Ruby 1.9
+  s.add_development_dependency "rubyzip"
 
   if RUBY_VERSION <= "2.4.0"
     s.add_development_dependency "simplecov", "<= 0.17.1" # support testing Ruby 1.9

data/lib/active_storage/service/cloudinary_service.rb

@@ -72,6 +72,14 @@ module ActiveStorage
       instrument :url, key: key do |payload|
         options = {:resource_type => resource_type(nil, key)}.merge(@options.merge(options.symbolize_keys))
         options[:public_id] = public_id_internal(key)
+        # Provide file format for raw files, since js client does not include original file name.
+        #
+        # When the file is uploaded from the server, the request includes original filename. That allows Cloudinary
+        # to identify file extension and append it to the public id of the file (raw files include file extension
+        # in their public id, opposed to transformable assets (images/video) that use only basename). When uploading
+        # through direct upload (client side js), filename is missing, and that leads to inconsistent/broken URLs.
+        # To avoid that, we explicitly pass file format in options.
+        options[:format] = ext_for_file(key) if options[:resource_type] == "raw"
         options[:context] = {active_storage_key: key}
         options.delete(:file)
         payload[:url] = api_uri("upload", options)
@@ -87,7 +95,12 @@ module ActiveStorage
 
     def delete(key)
       instrument :delete, key: key do
-        Cloudinary::Uploader.destroy public_id(key), resource_type: resource_type(nil, key)
+        options = {
+          resource_type: resource_type(nil, key),
+          type: @options[:type]
+        }.compact
+
+        Cloudinary::Uploader.destroy public_id(key), **options
       end
     end
 
@@ -99,7 +112,12 @@ module ActiveStorage
     def exist?(key)
       instrument :exist, key: key do |payload|
         begin
-          Cloudinary::Api.resource public_id(key), resource_type: resource_type(nil, key)
+          options = {
+            resource_type: resource_type(nil, key),
+            type: @options[:type]
+          }.compact
+
+          Cloudinary::Api.resource public_id(key), **options
           true
         rescue Cloudinary::Api::NotFound => e
           false
@@ -174,7 +192,7 @@ module ActiveStorage
     # @param [string]                   content_type The content type of the file.
     #
     # @return [string] The extension of the filename.
-    def ext_for_file(key, filename, content_type)
+    def ext_for_file(key, filename = nil, content_type = nil)
       if filename.blank?
         options = key.respond_to?(:attributes) ? key.attributes : {}
         filename = ActiveStorage::Filename.new(options[:filename]) if options.has_key?(:filename)
@@ -200,6 +218,8 @@ module ActiveStorage
     end
 
     def content_type_to_resource_type(content_type)
+      return 'image' if content_type.nil?
+
       type, subtype = content_type.split('/')
       case type
       when 'video', 'audio'

data/lib/cloudinary.rb

@@ -16,7 +16,12 @@ require "cloudinary/missing"
 module Cloudinary
   autoload :Utils, 'cloudinary/utils'
   autoload :Uploader, 'cloudinary/uploader'
+  autoload :BaseConfig, "cloudinary/base_config"
+  autoload :Config, "cloudinary/config"
+  autoload :AccountConfig, "cloudinary/account_config"
+  autoload :BaseApi, "cloudinary/base_api"
   autoload :Api, "cloudinary/api"
+  autoload :AccountApi, "cloudinary/account_api"
   autoload :Downloader, "cloudinary/downloader"
   autoload :Blob, "cloudinary/blob"
   autoload :PreloadedFile, "cloudinary/preloaded_file"
@@ -58,64 +63,42 @@ module Cloudinary
     "ept"  => "eps"
   }
 
-  @@config = nil
-
+  # Cloudinary config
+  #
+  # @param [Hash] new_config If +new_config+ is passed, Config will be updated with it
+  # @yieldparam [OpenStruct] Config can be updated in the block
+  #
+  # @return [OpenStruct]
   def self.config(new_config=nil)
-    first_time = @@config.nil?
-    @@config   ||= OpenStruct.new((YAML.load(ERB.new(IO.read(config_dir.join("cloudinary.yml"))).result)[config_env] rescue {}))
-
-    config_from_env if first_time
+    @@config ||= make_new_config(Config)
 
-    set_config(new_config) if new_config
-    yield(@@config) if block_given?
+    @@config.update(new_config) if new_config
+    yield @@config if block_given?
 
     @@config
   end
 
-  def self.config_from_url(url)
-    @@config ||= OpenStruct.new
-    return unless url && !url.empty?
-    uri = URI.parse(url)
-    if !uri.scheme || "cloudinary" != uri.scheme.downcase
-      raise(CloudinaryException,
-        "Invalid CLOUDINARY_URL scheme. Expecting to start with 'cloudinary://'")
-    end
-    set_config(
-      "cloud_name"          => uri.host,
-      "api_key"             => uri.user,
-      "api_secret"          => uri.password,
-      "private_cdn"         => !uri.path.blank?,
-      "secure_distribution" => uri.path[1..-1]
-    )
-    uri.query.to_s.split("&").each do
-    |param|
-      key, value = param.split("=")
-      if isNestedKey? key
-        putNestedKey key, value
-      else
-        set_config(key => Utils.smart_unescape(value))
-      end
-    end
-  end
+  # Cloudinary account config
+  #
+  # @param [Hash] new_config If +new_config+ is passed, Account Config will be updated with it
+  # @yieldparam [OpenStruct] Account config can be updated in the block
+  #
+  # @return [OpenStruct]
+  def self.account_config(new_config=nil)
+    @@account_config ||= make_new_config(AccountConfig)
 
-  def self.putNestedKey(key, value)
-    chain   = key.split(/[\[\]]+/).reject { |i| i.empty? }
-    outer   = @@config
-    lastKey = chain.pop()
-    chain.each do |innerKey|
-      inner = outer[innerKey]
-      if inner.nil?
-        inner           = OpenStruct.new
-        outer[innerKey] = inner
-      end
-      outer = inner
-    end
-    outer[lastKey] = value
+    @@account_config.update(new_config) if new_config
+    yield @@account_config if block_given?
+
+    @@account_config
   end
 
+  def self.config_from_url(url)
+    config.load_from_url(url)
+  end
 
-  def self.isNestedKey?(key)
-    /\w+\[\w+\]/ =~ key
+  def self.config_from_account_url(url)
+    account_config.load_from_url(url)
   end
 
   def self.app_root
@@ -129,22 +112,6 @@ module Cloudinary
 
   private
 
-  def self.config_from_env
-    # Heroku support
-    if ENV["CLOUDINARY_CLOUD_NAME"]
-      config_keys = ENV.keys.select! { |key| key.start_with? "CLOUDINARY_" }
-      config_keys -= ["CLOUDINARY_URL"] # ignore it when explicit options are passed
-      config_keys.each do |full_key|
-        conf_key = full_key["CLOUDINARY_".length..-1].downcase # convert "CLOUDINARY_CONFIG_NAME" to "config_name"
-        conf_val = ENV[full_key]
-        conf_val = conf_val == 'true' if %w[true false].include?(conf_val) # cast relevant boolean values
-        set_config(conf_key => conf_val)
-      end
-    elsif ENV["CLOUDINARY_URL"]
-      config_from_url(ENV["CLOUDINARY_URL"])
-    end
-  end
-
   def self.config_env
     return ENV["CLOUDINARY_ENV"] if ENV["CLOUDINARY_ENV"]
     return Rails.env if defined? Rails::env
@@ -159,6 +126,29 @@ module Cloudinary
   def self.set_config(new_config)
     new_config.each{|k,v| @@config.send(:"#{k}=", v) if !v.nil?}
   end
+
+  # Builds config from yaml file, extends it with specific module and loads configuration from environment variable
+  #
+  # @param [Module] config_module Config is extended with this module after being built
+  #
+  # @return [OpenStruct]
+  def self.make_new_config(config_module)
+    import_settings_from_file.tap do |config|
+      config.extend(config_module)
+      config.load_config_from_env
+    end
+  end
+
+  private_class_method :make_new_config
+
+  # Import settings from yaml file
+  #
+  # @return [OpenStruct]
+  def self.import_settings_from_file
+    OpenStruct.new((YAML.load(ERB.new(IO.read(config_dir.join("cloudinary.yml"))).result)[config_env] rescue {}))
+  end
+
+  private_class_method :import_settings_from_file
 end
   # Prevent require loop if included after Rails is already initialized.
   require "cloudinary/helper" if defined?(::ActionView::Base)

data/lib/cloudinary/account_api.rb

@@ -0,0 +1,226 @@
+class Cloudinary::AccountApi
+  extend Cloudinary::BaseApi
+
+  # Creates a new sub-account. Any users that have access to all sub-accounts will also automatically have access to the
+  # new sub-account.
+  # @param [String] name The display name as shown in the management console
+  # @param [String] cloud_name A case-insensitive cloud name comprised of alphanumeric and underscore characters.
+  #   Generates an error if the specified cloud name is not unique across all Cloudinary accounts.
+  #   Note: Once created, the name can only be changed for accounts with fewer than 1000 assets.
+  # @param [Object] custom_attributes Any custom attributes you want to associate with the sub-account
+  # @param [Boolean] enabled Whether to create the account as enabled (default is enabled)
+  # @param [String] base_account ID of sub-account from which to copy settings
+  # @param [Object] options additional options
+  def self.create_sub_account(name, cloud_name = nil, custom_attributes = {}, enabled = nil, base_account = nil, options = {})
+    params = {
+      name: name,
+      cloud_name: cloud_name,
+      custom_attributes: custom_attributes,
+      enabled: enabled,
+      base_sub_account_id: base_account
+    }
+
+    call_account_api(:post, 'sub_accounts', params, options.merge(content_type: :json))
+  end
+
+  # Updates the specified details of the sub-account.
+  # @param [String] sub_account_id The ID of the sub-account.
+  # @param [String] name The display name as shown in the management console
+  # @param [String] cloud_name A case-insensitive cloud name comprised of alphanumeric and underscore characters.
+  #   Generates an error if the specified cloud name is not unique across all Cloudinary accounts.
+  #   Note: Once created, the name can only be changed for accounts with fewer than 1000 assets.
+  # @param [Object] custom_attributes Any custom attributes you want to associate with the sub-account, as a map/hash
+  #   of key/value pairs.
+  # @param [Boolean] enabled Whether the sub-account is enabled.
+  # @param [Object] options additional options
+  def self.update_sub_account(sub_account_id, name = nil, cloud_name = nil, custom_attributes = nil, enabled = nil, options = {})
+    params = {
+      name: name,
+      cloud_name: cloud_name,
+      custom_attributes: custom_attributes,
+      enabled: enabled
+    }
+
+    call_account_api(:put, ['sub_accounts', sub_account_id], params, options.merge(content_type: :json))
+  end
+
+  # Lists sub-accounts.
+  # @param [Boolean] enabled Whether to only return enabled sub-accounts (true) or disabled accounts (false).
+  #  Default: all accounts are returned (both enabled and disabled).
+  # @param [Array<String>] ids A list of up to 100 sub-account IDs. When provided, other parameters are ignored.
+  # @param [String] prefix Returns accounts where the name begins with the specified case-insensitive string.
+  # @param [Object] options additional options
+  def self.sub_accounts(enabled = nil, ids = [], prefix = nil, options = {})
+    params = {
+      enabled: enabled,
+      ids: ids,
+      prefix: prefix
+    }
+
+    call_account_api(:get, 'sub_accounts', params, options.merge(content_type: :json))
+  end
+
+  # Retrieves the details of the specified sub-account.
+  # @param [String] sub_account_id The ID of the sub-account.
+  # @param [Object] options additional options
+  def self.sub_account(sub_account_id, options = {})
+    call_account_api(:get, ['sub_accounts', sub_account_id], {}, options.merge(content_type: :json))
+  end
+
+  # Deletes the specified sub-account. Supported only for accounts with fewer than 1000 assets.
+  # @param [String] sub_account_id The ID of the sub-account.
+  # @param [Object] options additional options
+  def self.delete_sub_account(sub_account_id, options = {})
+    call_account_api(:delete, ['sub_accounts', sub_account_id], {}, options)
+  end
+
+  # Creates a new user in the account.
+  # @param [String] name The name of the user.
+  # @param [String] email A unique email address, which serves as the login name and notification address.
+  # @param [String] role The role to assign. Possible values: master_admin, admin, billing, technical_admin, reports,
+  #   media_library_admin, media_library_user
+  # @param [Array<String>] sub_account_ids The list of sub-account IDs that this user can access.
+  #   Note: This parameter is ignored if the role is specified as master_admin.
+  # @param [Object] options additional options
+  def self.create_user(name, email, role, sub_account_ids = [], options = {})
+    params = {
+      name: name,
+      email: email,
+      role: role,
+      sub_account_ids: sub_account_ids
+    }
+
+    call_account_api(:post, 'users', params, options.merge(content_type: :json))
+  end
+
+  # Deletes an existing user.
+  # @param [String] user_id The ID of the user to delete.
+  # @param [Object] options additional options
+  def self.delete_user(user_id, options = {})
+    call_account_api(:delete, ['users', user_id], {}, options)
+  end
+
+  # Updates the details of the specified user.
+  # @param [String] user_id The ID of the user to update.
+  # @param [String] name The name of the user.
+  # @param [String] email A unique email address, which serves as the login name and notification address.
+  # @param [String] role The role to assign. Possible values: master_admin, admin, billing, technical_admin, reports,
+  #   media_library_admin, media_library_user
+  # @param [Array<String>] sub_account_ids The list of sub-account IDs that this user can access.
+  #   Note: This parameter is ignored if the role is specified as master_admin.
+  # @param [Object] options additional options
+  def self.update_user(user_id, name = nil, email = nil, role = nil, sub_account_ids = nil, options = {})
+    params = {
+      name: name,
+      email: email,
+      role: role,
+      sub_account_ids: sub_account_ids
+    }
+
+    call_account_api(:put, ['users', user_id], params, options.merge(content_type: :json))
+  end
+
+  # Returns the user with the specified ID.
+  # @param [String] user_id The ID of the user.
+  # @param [Object] options additional options
+  def self.user(user_id, options = {})
+    call_account_api(:get, ['users', user_id], {}, options.merge(content_type: :json))
+  end
+
+  # Lists users in the account.
+  # @param [Boolean] pending Limit results to pending users (true), users that are not pending (false), or all users (nil, the default)
+  # @param [Array<String>] user_ids A list of up to 100 user IDs. When provided, other parameters are ignored.
+  # @param [String] prefix Returns users where the name or email address begins with the specified case-insensitive string.
+  # @param [String] sub_account_id Only returns users who have access to the specified account.
+  # @param [Object] options additional options
+  def self.users(pending = nil, user_ids = [], prefix = nil, sub_account_id = nil, options = {})
+    params = {
+      ids: user_ids,
+      prefix: prefix,
+      sub_account_id: sub_account_id,
+      pending: pending
+    }
+
+    call_account_api(:get, 'users', params, options.merge(content_type: :json))
+  end
+
+  # Creates a new user group.
+  # @param [String] name The name for the user group.
+  # @param [Object] options additional options
+  def self.create_user_group(name, options = {})
+    params = {
+      name: name
+    }
+
+    call_account_api(:post, 'user_groups', params, options.merge(content_type: :json))
+  end
+
+  # Updates the specified user group.
+  # @param [String] group_id The ID of the user group to update.
+  # @param [String] name The name for the user group.
+  # @param [Object] options additional options
+  def self.update_user_group(group_id, name, options = {})
+    params = {
+      name: name
+    }
+
+    call_account_api(:put, ['user_groups', group_id], params, options.merge(content_type: :json))
+  end
+
+  # Adds a user to a group with the specified ID.
+  # @param [String] group_id The ID of the user group.
+  # @param [String] user_id The ID of the user.
+  # @param [Object] options additional options
+  def self.add_user_to_group(group_id, user_id, options = {})
+    call_account_api(:post, ['user_groups', group_id, 'users', user_id], {}, options.merge(content_type: :json))
+  end
+
+  # Removes a user from a group with the specified ID.
+  # @param [String] group_id The ID of the user group.
+  # @param [String] user_id The ID of the user.
+  # @param [Object] options additional options
+  def self.remove_user_from_group(group_id, user_id, options = {})
+    call_account_api(:delete, ['user_groups', group_id, 'users', user_id], {}, options.merge(content_type: :json))
+  end
+
+  # Deletes the user group with the specified ID.
+  # @param [String] group_id The ID of the user group to delete.
+  # @param [Object] options additional options
+  def self.delete_user_group(group_id, options = {})
+    call_account_api(:delete, ['user_groups', group_id], {}, options)
+  end
+
+  # Lists user groups in the account.
+  # @param [Object] options additional options
+  def self.user_groups(options = {})
+    call_account_api(:get, 'user_groups', {}, options.merge(content_type: :json))
+  end
+
+  # Retrieves the details of the specified user group.
+  # @param [String] group_id The ID of the user group to retrieve.
+  # @param [Object] options additional options
+  def self.user_group(group_id, options = {})
+    call_account_api(:get, ['user_groups', group_id], {}, options.merge(content_type: :json))
+  end
+
+  # Lists users in the specified user group.
+  # @param [String] group_id The ID of the user group.
+  # @param [Object] options additional options
+  def self.user_group_users(group_id, options = {})
+    call_account_api(:get, ['user_groups', group_id, 'users'], {}, options.merge(content_type: :json))
+  end
+
+  def self.call_account_api(method, uri, params, options)
+    account_id = options[:account_id] || Cloudinary.account_config.account_id || raise('Must supply account_id')
+    api_key    = options[:provisioning_api_key] || Cloudinary.account_config.provisioning_api_key || raise('Must supply provisioning api_key')
+    api_secret = options[:provisioning_api_secret] || Cloudinary.account_config.provisioning_api_secret || raise('Must supply provisioning api_secret')
+
+    params.reject! { |_, v| v.nil? }
+
+    call_cloudinary_api(method, uri, api_key, api_secret, params, options) do |cloudinary, inner_uri|
+      [cloudinary, 'v1_1', 'provisioning', 'accounts', account_id, inner_uri]
+    end
+  end
+
+  private_class_method :call_account_api
+end