gettyimages-api 2.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 6b5c91bd5871d4cb8761930aeb093fe47a0c5d85
+  data.tar.gz: 644524093d4158f6f95c1dca4da520c5955e8dd6
+SHA512:
+  metadata.gz: c9f560e82439206b16671f81b5f76cfb158dea1217a1ab28282902053cb7288ce32adfd33f8dbefd54153301db0a715a183d55e3a26d1d529cf1f151f6535623
+  data.tar.gz: 9afd14e656e430f98c747d2418fdc6f72e564f8475b987ae8c09d04e137b6b173ffc65eba024d6fc63e31c1e4560f256300b0c2a4b6c814430f856056db7062e

data/.gitignore

@@ -0,0 +1,14 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log

data/.vscode/launch.json

@@ -0,0 +1,65 @@
+{
+    // Use IntelliSense to learn about possible attributes.
+    // Hover to view descriptions of existing attributes.
+    // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "name": "Debug Local File",
+            "type": "Ruby",
+            "request": "launch",
+            "cwd": "${workspaceRoot}",
+            "program": "${file}",
+            "showDebuggerOutput": true
+        },
+        {
+            "name": "Listen for rdebug-ide",
+            "type": "Ruby",
+            "request": "attach",
+            "cwd": "${workspaceRoot}",
+            "remoteHost": "127.0.0.1",
+            "remotePort": "1234",
+            "remoteWorkspaceRoot": "${workspaceRoot}"
+        },
+        {
+            "name": "Rails server",
+            "type": "Ruby",
+            "request": "launch",
+            "cwd": "${workspaceRoot}",
+            "program": "${workspaceRoot}/bin/rails",
+            "args": [
+                "server"
+            ]
+        },
+        {
+            "name": "RSpec - all",
+            "type": "Ruby",
+            "request": "launch",
+            "cwd": "${workspaceRoot}",
+            "program": "${workspaceRoot}/bin/rspec",
+            "args": [
+                "-I",
+                "${workspaceRoot}"
+            ]
+        },
+        {
+            "name": "RSpec - active spec file only",
+            "type": "Ruby",
+            "request": "launch",
+            "cwd": "${workspaceRoot}",
+            "program": "${workspaceRoot}/bin/rspec",
+            "args": [
+                "-I",
+                "${workspaceRoot}",
+                "${file}"
+            ]
+        },
+        {
+            "name": "Cucumber",
+            "type": "Ruby",
+            "request": "launch",
+            "cwd": "${workspaceRoot}",
+            "program": "${workspaceRoot}/bin/cucumber"
+        }
+    ]
+}

data/.vscode/tasks.json

@@ -0,0 +1,15 @@
+{
+    // See https://go.microsoft.com/fwlink/?LinkId=733558
+    // for the documentation about the tasks.json format
+    "version": "2.0.0",
+    "tasks": [
+        {
+            "label": "test",
+            "type": "shell",
+            "command": "ruby",
+            "args": [
+                "./unit_tests/Run.rb"
+            ],
+        }
+    ]
+}

data/Gemfile

@@ -0,0 +1,6 @@
+source 'https://rubygems.org'
+
+gem 'rake'
+gem 'json'
+gem 'test-unit'
+gem 'webmock'                                                                                                                                                                                                                                                                                                                                                                                                                           

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2014-2018 Getty Images
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,158 @@
+# Getty Images API Ruby SDK
+[![Build Status](https://travis-ci.org/gettyimages/gettyimages-api_ruby.svg?branch=master)](https://travis-ci.org/gettyimages/gettyimages-api_ruby)  
+Seamlessly integrate Getty Images' expansive digital content, powerful search technology, and rich metadata into your publishing tools, products and services!
+
+- Search for images and videos from our extensive creative and editorial catalogs.
+- Get image and video metadata.
+- Download files using your Getty Images products (e.g., Editorial subscriptions, Easy Access, Thinkstock Subscriptions, and Image Packs).
+- Custom Request functionality that allows user to call any endpoint.
+
+## Requirements
+
+- Ruby version >= 2.4
+- [Bundler](http://bundler.io)
+
+## Examples
+
+### Search for one or more images
+
+```ruby
+require 'gettyimages-api'
+
+api_key = "API Key"
+api_secret = "API Secret"
+
+# create instance of the SDK
+apiClient = ApiClient.new(api_key, api_secret)
+result = apiClient
+    .search_images()
+    .with_phrase("gorilla")
+    .with_fields(["artist", "id", "title"])
+    .with_exclude_nudity("true")
+    .with_page(2)
+    .with_page_size(5)
+    .execute()
+
+result["images"].each do | image |
+    puts "Id: #{image["id"]} Title: #{image["title"]}"
+end
+```
+
+### Get detailed information for one image
+
+```ruby
+require 'gettyimages-api'
+
+api_key = "API Key"
+api_secret = "API Secret"
+
+# create instance of the SDK
+apiClient = ApiClient.new(api_key, api_secret)
+result = apiClient
+    .images()
+    .with_id("ASSET_ID")
+    .execute()
+
+puts result
+```
+
+### Get detailed information for multiple images
+
+```ruby
+require 'gettyimages-api'
+
+api_key = "API Key"
+api_secret = "API Secret"
+
+# create instance of the SDK
+apiClient = ApiClient.new(api_key, api_secret)
+result = apiClient
+    .images()
+    .with_ids(["ASSET_ID_1", "ASSET_ID_2"])
+    .execute()
+
+result["images"].each do | image |
+    puts image
+end
+```
+
+### Download an image
+
+```ruby
+require 'gettyimages-api'
+
+api_key = "API Key"
+api_secret = "API Secret"
+
+# create instance of the SDK
+apiClient = ApiClient.new(api_key, api_secret)
+result = apiClient
+    .download_images()
+    .with_id("ASSET_ID")
+    .execute()
+
+puts result["uri"]
+```
+
+### Use the custom request functionality for GET request with query parameters
+
+```ruby
+require 'gettyimages-api'
+
+api_key = "API Key"
+api_secret = "API Secret"
+
+# create instance of the SDK
+apiClient = ApiClient.new(api_key, api_secret)
+result = apiClient
+    .custom_request()
+    .with_method("GET")
+    .with_route("search/images")
+    .with_query_parameters({"phrase"=> "cat", "fields"=> ["artist", "id", "title"], "page" => 2})
+    .execute()
+
+result["images"].each do | image |
+    puts "Id: #{image["id"]} Title: #{image["title"]}"
+end
+```
+
+### Use the custom request functionality for POST request with body
+
+```ruby
+require 'gettyimages-api'
+
+api_key = "API Key"
+api_secret = "API Secret"
+
+# create instance of the SDK
+apiClient = ApiClient.new(api_key, api_secret)
+result = apiClient
+    .custom_request()
+    .with_method("POST")
+    .with_route("boards")
+    .with_body({"name"=> "Board Name", "description" => "Board Description"})
+    .execute()
+
+puts result["id"]
+```
+
+## Unit Tests
+
+Install bundler and all dependencies
+
+```sh
+gem install bundler
+bundle install
+```
+
+To execute all unit tests:
+
+```sh
+rake
+```
+
+To run one unit test file:
+
+```sh
+ruby unit_tests/FILENAME.rb
+```

data/Rakefile

@@ -0,0 +1,9 @@
+require "bundler"
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+task :test do
+  ruby("unit_tests/Run.rb")
+end
+
+task default: :test

data/gettyimages-api.gemspec

@@ -0,0 +1,25 @@
+# coding: utf-8
+lib = File.expand_path('lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require_relative 'lib/GettyImagesApi/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "gettyimages-api"
+  spec.version       = GettyImagesApi::VERSION
+  spec.version       = "#{spec.version}-alpha-#{ENV['TRAVIS_BUILD_NUMBER']}" if ENV['TRAVIS']
+  spec.authors       = ["Getty Images"]
+  spec.email         = ["developersupport@gettyimages.com"]
+  spec.summary       = "Getty Images API SDK"
+  spec.description   = "Getty Images API SDK"
+  spec.homepage      = "https://github.com/gettyimages/gettyimages-api_ruby"
+  spec.license       = "MIT"
+  gem_files          = `git ls-files -z`.split("\x0")
+  gem_ignored_files  = `git ls-files -z unit_tests/`.split("\x0")
+  spec.files         = gem_files - gem_ignored_files - ['.travis.yml']
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+  
+  spec.add_development_dependency "bundler"
+  spec.add_development_dependency "rake"
+  
+end

data/lib/ApiClient.rb

@@ -0,0 +1,88 @@
+require_relative "Credentials"
+require_relative "Search/SearchImages.rb"
+require_relative "Search/SearchImagesCreative.rb"
+require_relative "Search/SearchImagesEditorial.rb"
+require_relative "Search/SearchVideos.rb"
+require_relative "Search/SearchVideosCreative.rb"
+require_relative "Search/SearchVideosEditorial.rb"
+require_relative "Downloads/DownloadImages.rb"
+require_relative "Downloads/DownloadVideos.rb"
+require_relative "Images/Images.rb"
+require_relative "Videos/Videos.rb"
+require_relative "CustomRequest/CustomRequest.rb"
+
+class ApiClient
+	
+	# Initialize the Credentials to be used by the SDK
+	def initialize(api_key, api_secret, user_name = nil, password = nil)
+
+		@credentials = Credentials.new(
+			:credential_type => (user_name.nil?) || (password.nil?) ? OAuthGrantType::CLIENT_CREDENTIALS : OAuthGrantType::PASSWORD, 
+			:client_key => api_key, 
+			:client_secret => api_secret,
+			:user_name => user_name,
+			:password => password)				
+	end
+
+	# Get access token to be used by the SDK
+	def get_access_token
+		return @credentials.get_access_token
+	end
+
+	# Search for both creative and editorial images
+	def search_images()
+		return SearchImages.new(@credentials.client_key, @credentials.get_access_token)
+	end
+
+	# Search for creative images
+	def search_images_creative()
+		return SearchImagesCreative.new(@credentials.client_key, @credentials.get_access_token)
+	end
+
+	# Search for editorial images
+	def search_images_editorial()
+		return SearchImagesEditorial.new(@credentials.client_key, @credentials.get_access_token)
+	end
+
+	#Search for both creative and editorial videos
+	def search_videos()
+		return SearchVideos.new(@credentials.client_key, @credentials.get_access_token)
+	end
+
+	#Search for creative videos
+	def search_videos_creative()
+		return SearchVideosCreative.new(@credentials.client_key, @credentials.get_access_token)
+	end
+
+	#Search for editorial videos
+	def search_videos_editorial()
+		return SearchVideosEditorial.new(@credentials.client_key, @credentials.get_access_token)
+	end
+	
+	#Get metadata for images 	
+	def images()
+		return Images.new(@credentials.client_key, @credentials.get_access_token)
+	end
+
+	#Get metadata for videos 	
+	def videos()
+		return Videos.new(@credentials.client_key, @credentials.get_access_token)
+	end
+	
+	#Download an image
+	def download_images()
+		return DownloadImages.new(@credentials.client_key, @credentials.get_access_token)
+	end
+
+	#Download a video
+	def download_videos()
+		return DownloadVideos.new(@credentials.client_key, @credentials.get_access_token)
+	end
+
+	#Build a custom API request
+	def custom_request()
+		return CustomRequest.new(@credentials.client_key, @credentials.get_access_token)
+	end
+
+end
+

data/lib/Credentials.rb

@@ -0,0 +1,68 @@
+require 'open-uri'
+require 'net/https'
+
+class OAuthGrantType
+ 	PASSWORD = 'password'
+ 	CLIENT_CREDENTIALS = 'client_credentials'
+end
+
+class Credentials
+
+	attr_accessor :credential_type
+	attr_accessor :client_key
+	attr_accessor :client_secret
+	attr_accessor :user_name
+	attr_accessor :password
+
+	def initialize(args)
+		args.keys.each { |name| instance_variable_set "@" + name.to_s, args[name] }	
+	end
+
+	def get_uri(path)
+		return URI.parse "#{Api_Host::API_BASE_URL}#{path}"
+	end
+
+	# Get Access Token Using OAuth
+	def get_access_token
+		
+		# Determine OAuth Flow
+		case @credential_type
+			when OAuthGrantType::PASSWORD
+				oauth_data = {
+					:grant_type => @credential_type, 
+					:client_id => @client_key, 
+					:client_secret => @client_secret, 
+					:username => @user_name, 
+					:password => @password }
+			when OAuthGrantType::CLIENT_CREDENTIALS
+				oauth_data = {
+					:grant_type => @credential_type, 
+					:client_id => @client_key, 
+					:client_secret => @client_secret }
+			else
+				puts 'Current OAuth flow only supports Resource Owner and Client Credentials'				
+		end
+
+		# define endpoint
+		uri = get_uri '/oauth2/token'
+
+		# define HTTPS connection
+		https = Net::HTTP.new(uri.host, uri.port)
+		https.use_ssl = true
+		https.verify_mode = OpenSSL::SSL::VERIFY_NONE
+		
+		# define Request
+		req = Net::HTTP::Post.new uri.request_uri
+		req['Api-Key'] = @client_key
+		req.set_form_data oauth_data
+		
+		res = https.request req
+		data = res.body
+		result = JSON.parse(data)
+		if !res.is_a?(Net::HTTPSuccess)
+			raise res.code + ": " + result['error_description']	
+		end
+		return result['access_token']
+	end
+
+end

data/lib/CustomRequest/CustomRequest.rb

@@ -0,0 +1,63 @@
+require_relative "../RequestBase.rb"
+
+class CustomRequest < RequestBase
+
+    attr_accessor :method, :body, :route
+    # @route = "/v3/"
+
+    def initialize(api_key, access_token)
+        @route = "/v3/"
+        super(api_key, access_token)
+    end
+
+    def execute
+        case @method
+        when "GET"
+            return @http_helper.get(@route, @query_params)
+        when "POST"
+            return @http_helper.post(@route, @query_params, self.body)
+        when "PUT"
+            return @http_helper.put(@route, @query_params, self.body)
+        when "DELETE"
+            return @http_helper.delete(@route, @query_params)
+        else
+            raise "No appropriate HTTP method found for this request."
+        end
+					
+    end
+     	
+    def with_route(route)	
+        @route += route
+        return self
+    end
+
+    def with_method(method)	
+        @method = method
+        return self
+    end
+
+    def with_query_parameters(params)
+        params.each do |key,value|
+            if value.is_a?(Array)
+				value = value.join(",")
+				if !key.include? "id"
+					value.downcase!
+                end	
+                params[key] = value
+			else
+				if (!key.include? "id") && (value.is_a?(String))
+					value.downcase!
+                end	
+                params[key] = value
+            end
+        end
+        @query_params = params
+        return self
+    end
+
+    def with_body(body)	
+        self.body = body
+        return self
+    end
+
+end

data/lib/Downloads/DownloadImages.rb

@@ -0,0 +1,32 @@
+require_relative "../RequestBase.rb"
+
+class DownloadImages < RequestBase
+
+    attr_accessor :asset_id
+
+	API_ROUTE = "/v3/downloads/images" # mashery endpoint	
+	QUERY_PARAMS_NAMES = ["file_type","height","product_id","product_type"]	
+
+	QUERY_PARAMS_NAMES.each do |key|
+    define_method :"with_#{key}" do |value = true| 
+            if (!key.include? "id") && (value.is_a?(String))
+                value.downcase!
+            end	
+            build_query_params(key, value)
+            return self
+        end
+    end
+      
+    public 	
+    def with_id(asset_id)	
+        self.asset_id = asset_id
+        return self
+    end
+
+    def execute
+        build_query_params("auto_download", "false")
+        uri = API_ROUTE + "/" + self.asset_id
+		return @http_helper.post(uri, @query_params, nil)			
+	end
+
+end

data/lib/Downloads/DownloadVideos.rb

@@ -0,0 +1,32 @@
+require_relative "../RequestBase.rb"
+
+class DownloadVideos < RequestBase
+
+    attr_accessor :asset_id
+
+	API_ROUTE = "/v3/downloads/videos" # mashery endpoint	
+	QUERY_PARAMS_NAMES = ["product_id","size"]	
+
+	QUERY_PARAMS_NAMES.each do |key|
+    define_method :"with_#{key}" do |value = true| 
+            if (!key.include? "id") && (value.is_a?(String))
+                value.downcase!
+            end	
+            build_query_params(key, value)
+            return self
+        end
+    end
+      
+    public 	
+    def with_id(asset_id)	
+        self.asset_id = asset_id
+        return self
+    end
+
+    def execute
+        build_query_params("auto_download", "false")
+        uri = API_ROUTE + "/" + self.asset_id
+		return @http_helper.post(uri, @query_params, nil)			
+	end
+
+end

data/lib/Example.rb

@@ -0,0 +1,21 @@
+require "pp"
+require_relative "GettyImagesApi"
+
+api_key = "api key"
+api_secret = "api secret"
+
+apiClient 		= GettyImagesApi.new(api_key, api_secret)
+search_results	= apiClient.search().images().creative()
+					.with_phrase("gorilla")
+					.with_response_fields(["id","title"])
+					.with_graphical_styles("illustration")
+					.with_graphical_styles(["fine_art","photography"])
+					.with_page(2)
+					.with_page_size(5)
+					.execute()
+
+search_results["images"].each do | image |
+	puts "Id: #{image["id"]} Title: #{image["title"]}" 
+end
+
+

data/lib/GettyImagesApi/version.rb

@@ -0,0 +1,3 @@
+module GettyImagesApi
+	VERSION = "2.0.0"
+end

data/lib/HttpHelper.rb

@@ -0,0 +1,124 @@
+require 'net/http'
+require 'uri'
+require 'json'
+require 'rbconfig'
+require_relative 'GettyImagesApi/version'
+
+class Api_Host
+	API_HOST = "api.gettyimages.com"
+	API_BASE_URL = "https://#{API_HOST}"
+end
+
+class HttpHelper
+
+	def initialize(api_key, access_token)
+		@api_key = api_key
+		@access_token = access_token
+	end	
+
+	def get_uri(path)
+		return URI.parse "#{Api_Host::API_BASE_URL}#{path}"
+	end
+
+	def get(endpoint_path, query_params)
+		
+		uri = get_uri(endpoint_path)
+		#puts uri		
+		if !query_params.nil?
+			uri.query = URI.encode_www_form query_params
+		end
+		#puts "REQUEST URI: #{uri.request_uri}" 
+		req = Net::HTTP::Get.new uri.request_uri
+		return send uri, req, @api_key, @access_token
+
+	end
+
+	def post(endpoint_path, query_params, body)
+
+		uri = get_uri(endpoint_path)
+		if !query_params.nil?
+			uri.query = URI.encode_www_form query_params
+		end	
+		req = Net::HTTP::Post.new uri.request_uri
+		if !body.nil?
+			req["Content-Type"] = "application/json"
+			req.body = body.to_json
+		end
+		return send uri, req, @api_key, @access_token
+
+	end
+
+	def put(endpoint_path, query_params, body)
+
+		uri = get_uri(endpoint_path)
+		if !query_params.nil?
+			uri.query = URI.encode_www_form query_params
+		end	
+		req = Net::HTTP::Put.new uri.request_uri
+		if !body.nil?
+			req["Content-Type"] = "application/json"
+			req.body = body.to_json
+		end
+		return send uri, req, @api_key, @access_token
+
+	end
+
+	def delete(endpoint_path, query_params)
+
+		uri = get_uri(endpoint_path)
+		if !query_params.nil?
+			uri.query = URI.encode_www_form query_params
+		end	
+		req = Net::HTTP::Delete.new uri.request_uri
+		return send uri, req, @api_key, @access_token
+
+	end
+
+	private
+	def os
+		@os ||= (
+		host_os = RbConfig::CONFIG['host_os']
+		case host_os
+			when /mswin|msys|mingw|cygwin|bccwin|wince|emc/
+				:windows
+			when /darwin|mac os/
+				:macosx
+			when /linux/
+				:linux
+			when /solaris|bsd/
+				:unix
+			else
+				raise Error::WebDriverError, "unknown os: #{host_os.inspect}"
+			end)
+  	end
+
+	private
+	def send(uri, request, api_key, bearer_token = "")
+
+		# define HTTPS connection
+		https = Net::HTTP.new(uri.host, uri.port)
+		https.use_ssl = true
+		https.verify_mode = OpenSSL::SSL::VERIFY_NONE
+
+		# define headers
+		request["User-Agent"] = "GettImagesApiSdk/#{GettyImagesApi::VERSION} (#{os} ; Ruby #{RUBY_VERSION})"
+		request["Api-Key"] = api_key
+		request["Authorization"] = "Bearer #{bearer_token}" unless bearer_token.empty?
+		
+		# send request		
+		resp = https.request request
+
+		if !resp.is_a?(Net::HTTPSuccess)
+			data = JSON.parse(resp.body)			
+			raise "HTTP RESPONSE: #{data}" 
+		end
+
+		if resp.code == '204'
+			return Hash.new
+		end
+
+		return JSON.parse(resp.body)
+
+	end 
+
+end

data/lib/Images/Images.rb

@@ -0,0 +1,33 @@
+require_relative "../RequestBase.rb"
+
+class Images < RequestBase
+
+    attr_accessor :asset_id
+
+	API_ROUTE = "/v3/images" # mashery endpoint	
+	QUERY_PARAMS_NAMES = ["ids","fields"]
+
+	QUERY_PARAMS_NAMES.each do |key|
+    define_method :"with_#{key}" do |value = true| 
+            value = value.join(",")
+            if !key.include? "id"
+                value.downcase!
+            end	
+            build_query_params(key, value)
+    		return self
+    	end
+  	end
+			
+	public 
+    def with_id(id)
+        self.asset_id = id
+		return self
+	end
+
+	public
+    def execute
+        self.asset_id.nil? ? uri = API_ROUTE : uri = API_ROUTE + "/" + self.asset_id
+		return @http_helper.get(uri, @query_params)			
+	end
+
+end

data/lib/RequestBase.rb

@@ -0,0 +1,20 @@
+require_relative "HttpHelper"
+
+class RequestBase
+
+	attr_accessor :http_helper, :query_params
+
+	def initialize(api_key, access_token)
+		
+		#puts "here is my token #{access_token}" 		
+		@http_helper = HttpHelper.new(api_key, access_token)						
+		@query_params = Hash.new
+
+	end	
+
+	protected
+	def build_query_params(key, value)
+		@query_params[key].nil? ? @query_params[key] = value : @query_params[key] << "," + value
+	end 
+
+end

data/lib/Search/SearchImages.rb

@@ -0,0 +1,33 @@
+require_relative "../RequestBase.rb"
+
+class SearchImages < RequestBase
+
+	API_ROUTE = "/v3/search/images" # mashery endpoint	
+	QUERY_PARAMS_NAMES = ["age_of_people","artists","collection_codes","collections_filter_type","color","compositions","embed_content_only","ethnicity","event_ids","exclude_nudity","fields",
+		"file_types","graphical_styles","keyword_ids","license_models","minimum_size","number_of_people","orientations","page","page_size","phrase","prestige_content_only","product_types",
+		"sort_order","specific_people"]
+
+	QUERY_PARAMS_NAMES.each do |key|
+    define_method :"with_#{key}" do |value = true| 
+			if value.is_a?(Array)
+				value = value.join(",")
+				if (!key.include? "id") && (!key.include? "orientations")
+					value.downcase!
+				end	
+    			build_query_params(key, value)
+			else
+				if (!key.include? "id") && (!key.include? "orientations") && (value.is_a?(String))
+					value.downcase!
+				end	
+    			build_query_params(key, value)
+    		end
+    		return self
+    	end
+  	end
+
+	def execute
+		return @http_helper.get(API_ROUTE, @query_params)			
+	end
+
+end
+

data/lib/Search/SearchImagesCreative.rb

@@ -0,0 +1,32 @@
+require_relative "../RequestBase.rb"
+
+class SearchImagesCreative < RequestBase
+
+	API_ROUTE = "/v3/search/images/creative" # mashery endpoint	
+    QUERY_PARAMS_NAMES = ["age_of_people","artists","collection_codes","collections_filter_type","color","compositions","embed_content_only","ethnicity","exclude_nudity","fields","file_types",
+        "graphical_styles","keyword_ids","license_models","minimum_size","number_of_people","orientations","page","page_size","phrase","prestige_content_only","product_types",
+        "sort_order"]
+
+	QUERY_PARAMS_NAMES.each do |key|
+    define_method :"with_#{key}" do |value = true| 
+			if value.is_a?(Array)
+				value = value.join(",")
+				if (!key.include? "id") && (!key.include? "orientations")
+					value.downcase!
+				end	
+    			build_query_params(key, value)
+			else
+				if (!key.include? "id") && (!key.include? "orientations") && (value.is_a?(String))
+					value.downcase!
+				end	
+    			build_query_params(key, value)
+    		end
+    		return self
+    	end
+  	end
+
+	def execute
+		return @http_helper.get(API_ROUTE, @query_params)			
+	end
+
+end

data/lib/Search/SearchImagesEditorial.rb

@@ -0,0 +1,32 @@
+require_relative "../RequestBase.rb"
+
+class SearchImagesEditorial < RequestBase
+
+	API_ROUTE = "/v3/search/images/editorial" # mashery endpoint	
+    QUERY_PARAMS_NAMES = ["age_of_people","artists","collection_codes","collections_filter_type","compositions","editorial_segments","embed_content_only","end_date","entity_uris","ethnicity",
+        "event_ids","exclude_nudity","fields","file_types","graphical_styles","keyword_ids","minimum_quality_rank","minimum_size","number_of_people","orientations","page","page_size","phrase",
+        "product_types","sort_order","specific_people","start_date"]
+
+	QUERY_PARAMS_NAMES.each do |key|
+    define_method :"with_#{key}" do |value = true| 
+			if value.is_a?(Array)
+				value = value.join(",")
+				if (!key.include? "id") && (!key.include? "orientations")
+					value.downcase!
+				end	
+    			build_query_params(key, value)
+			else
+				if (!key.include? "id") && (!key.include? "orientations") && (value.is_a?(String))
+					value.downcase!
+				end	
+    			build_query_params(key, value)
+    		end
+    		return self
+    	end
+  	end
+
+	def execute
+		return @http_helper.get(API_ROUTE, @query_params)			
+	end
+
+end

data/lib/Search/SearchVideos.rb

@@ -0,0 +1,31 @@
+require_relative "../RequestBase.rb"
+
+class SearchVideos < RequestBase
+
+	API_ROUTE = "/v3/search/videos" # mashery endpoint	
+    QUERY_PARAMS_NAMES = ["age_of_people","collection_codes","collections_filter_type","editorial_video_types","exclude_nudity","fields","format_available","frame_rates",
+        "keyword_ids","license_models","page","page_size","phrase","product_types","sort_order","specific_people"]
+
+	QUERY_PARAMS_NAMES.each do |key|
+    define_method :"with_#{key}" do |value = true| 
+			if value.is_a?(Array)
+				value = value.join(",")
+				if !key.include? "id"
+					value.downcase!
+				end	
+    			build_query_params(key, value)
+			else
+				if (!key.include? "id") && (value.is_a?(String))
+					value.downcase!
+				end	
+    			build_query_params(key, value)
+    		end
+    		return self
+    	end
+  	end
+
+	def execute
+		return @http_helper.get(API_ROUTE, @query_params)			
+	end
+
+end

data/lib/Search/SearchVideosCreative.rb

@@ -0,0 +1,31 @@
+require_relative "../RequestBase.rb"
+
+class SearchVideosCreative < RequestBase
+
+	API_ROUTE = "/v3/search/videos/creative" # mashery endpoint	
+    QUERY_PARAMS_NAMES = ["age_of_people","collection_codes","collections_filter_type","exclude_nudity","fields","format_available","frame_rates",
+        "keyword_ids","license_models","page","page_size","phrase","product_types","sort_order"]
+
+	QUERY_PARAMS_NAMES.each do |key|
+    define_method :"with_#{key}" do |value = true| 
+			if value.is_a?(Array)
+				value = value.join(",")
+				if !key.include? "id"
+					value.downcase!
+				end	
+    			build_query_params(key, value)
+			else
+				if (!key.include? "id") && (value.is_a?(String))
+					value.downcase!
+				end	
+    			build_query_params(key, value)
+    		end
+    		return self
+    	end
+  	end
+
+	def execute
+		return @http_helper.get(API_ROUTE, @query_params)			
+	end
+
+end

data/lib/Search/SearchVideosEditorial.rb

@@ -0,0 +1,31 @@
+require_relative "../RequestBase.rb"
+
+class SearchVideosEditorial < RequestBase
+
+	API_ROUTE = "/v3/search/videos/editorial" # mashery endpoint	
+    QUERY_PARAMS_NAMES = ["age_of_people","collection_codes","collections_filter_type","editorial_video_types","entity_uris","exclude_nudity","fields","format_available","frame_rates",
+        "keyword_ids","page","page_size","phrase","product_types","sort_order","specific_people"]
+
+	QUERY_PARAMS_NAMES.each do |key|
+    define_method :"with_#{key}" do |value = true| 
+			if value.is_a?(Array)
+				value = value.join(",")
+				if !key.include? "id"
+					value.downcase!
+				end	
+    			build_query_params(key, value)
+			else
+				if (!key.include? "id") && (value.is_a?(String))
+					value.downcase!
+				end	
+    			build_query_params(key, value)
+    		end
+    		return self
+    	end
+  	end
+
+	def execute
+		return @http_helper.get(API_ROUTE, @query_params)			
+	end
+
+end

data/lib/Videos/Videos.rb

@@ -0,0 +1,33 @@
+require_relative "../RequestBase.rb"
+
+class Videos < RequestBase
+
+    attr_accessor :asset_id
+
+	API_ROUTE = "/v3/videos" # mashery endpoint	
+	QUERY_PARAMS_NAMES = ["ids","fields"]
+
+	QUERY_PARAMS_NAMES.each do |key|
+    define_method :"with_#{key}" do |value = true| 
+            value = value.join(",")
+            if !key.include? "id"
+                value.downcase!
+            end	
+            build_query_params(key, value)
+    		return self
+    	end
+  	end
+			
+	public 
+    def with_id(id)
+        self.asset_id = id
+		return self
+	end
+
+	public
+    def execute
+        self.asset_id.nil? ? uri = API_ROUTE : uri = API_ROUTE + "/" + self.asset_id
+		return @http_helper.get(uri, @query_params)			
+	end
+
+end

data/lib/gettyimages-api.rb

@@ -0,0 +1 @@
+require_relative 'ApiClient'

metadata

@@ -0,0 +1,99 @@
+--- !ruby/object:Gem::Specification
+name: gettyimages-api
+version: !ruby/object:Gem::Version
+  version: 2.0.0
+platform: ruby
+authors:
+- Getty Images
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2018-04-05 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Getty Images API SDK
+email:
+- developersupport@gettyimages.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".vscode/launch.json"
+- ".vscode/tasks.json"
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.md
+- Rakefile
+- gettyimages-api.gemspec
+- lib/ApiClient.rb
+- lib/Credentials.rb
+- lib/CustomRequest/CustomRequest.rb
+- lib/Downloads/DownloadImages.rb
+- lib/Downloads/DownloadVideos.rb
+- lib/Example.rb
+- lib/GettyImagesApi/version.rb
+- lib/HttpHelper.rb
+- lib/Images/Images.rb
+- lib/RequestBase.rb
+- lib/Search/SearchImages.rb
+- lib/Search/SearchImagesCreative.rb
+- lib/Search/SearchImagesEditorial.rb
+- lib/Search/SearchVideos.rb
+- lib/Search/SearchVideosCreative.rb
+- lib/Search/SearchVideosEditorial.rb
+- lib/Videos/Videos.rb
+- lib/gettyimages-api.rb
+homepage: https://github.com/gettyimages/gettyimages-api_ruby
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.5.2
+signing_key: 
+specification_version: 4
+summary: Getty Images API SDK
+test_files: []