gettyimages-api 3.0.1 → 3.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 997e7f50a48676a01163f288529a8e26129ff288e220593d4c33a240edad4ceb
-  data.tar.gz: a44a0e727ba765c23c4e44360088b27d9526283fd5b21dc230bb883a42542787
+  metadata.gz: 2243c89f894db5706ba46493d4950793ace1489afd5a7d713f7d849a54c7f772
+  data.tar.gz: 5152952d3187909c52e0511326def10c73bec5f3c786ad73c379ef60b161985d
 SHA512:
-  metadata.gz: c43ff3f1dbb02255792b2fc0dd6ef490a5de0a55975d249310cffb4d983efecef04654f962d14a171ae3d25dc29d9fb5152860a5513585c41d51a0ac0177bd19
-  data.tar.gz: 15bd7ce9133f5457429376fdbcf1db10127472224ff02ba9790dfb5f5f6c1c19a4ea2c8d1ed66657a5b1bcac4177910885b6de15698f755e26d4c7338fc09bab
+  metadata.gz: f60f66c7147c1bd7745ee6fe99f196f9fd6770fc4d8aa63bf174c52b8917a6e79a16200a64f6a2a49ef589b934c89ce2ab1dbf6277180c24db0dad4e2f864555
+  data.tar.gz: d03290c6c8c34dc5363d2aba180f3c686632b61c60192bef36292ad1d7803d9a4d37aa6190523c9e36b7ceb271b42c74bfe53f56cc5e1e1988fa6ab35251249b

data/.github/workflows/build.yml

@@ -2,9 +2,9 @@ name: Build
 
 on:
   push:
-    branches: [ master, actions ]
+    branches: [ main ]
   pull_request:
-    branches: [ master ]
+    branches: [ main ]
 
 jobs:
   test:

data/.github/workflows/publish.yml

@@ -5,7 +5,7 @@ on:
     types: [released]
 
 jobs:
-  test:
+  publish:
 
     runs-on: ubuntu-latest
 

data/Gemfile.lock

@@ -1,14 +1,14 @@
 GEM
   remote: https://rubygems.org/
   specs:
-    addressable (2.7.0)
+    addressable (2.8.0)
       public_suffix (>= 2.0.2, < 5.0)
     crack (0.4.3)
       safe_yaml (~> 1.0.0)
     hashdiff (1.0.0)
     json (2.3.0)
     power_assert (1.1.6)
-    public_suffix (4.0.3)
+    public_suffix (4.0.6)
     rake (13.0.1)
     safe_yaml (1.0.5)
     test-unit (3.3.5)

data/Makefile

@@ -1,5 +1,19 @@
+shell = /bin/sh
+UID := $(shell id -u)
+GID := $(shell id -g)
+
 build:
 	bundle config set --local path 'vendor/bundle'
 	bundle install --path vendor/bundle
 	bundle exec rake
 	gem build gettyimages-api.gemspec
+
+test:
+	rake
+
+# Run a Ruby container with the current directory mounted and as the
+# current user. This allows development without installing Ruby on your
+# system or if you have a version of Ruby not supported by the SDK.
+docker:
+	env UID=${UID} GID=${UID} docker run -it --net=host -v /${PWD}:/workdir -w //workdir -u ${UID}:${GID} ruby:2.7 /bin/bash
+	

data/README.md

@@ -40,7 +40,7 @@ api_secret = "API Secret"
 # create instance of the SDK
 apiClient = ApiClient.new(api_key, api_secret)
 result = apiClient
-    .search_images()
+    .search_images_creative()
     .with_phrase("gorilla")
     .with_fields(["artist", "id", "title"])
     .with_exclude_nudity("true")
@@ -109,6 +109,18 @@ result = apiClient
 puts result["uri"]
 ```
 
+### Make a request using custom parameter and header
+
+```ruby
+apiClient = ApiClient.new(api_key, api_secret)
+result = apiClient
+    .search_images_creative()
+    .with_phrase("beach")
+    .with_custom_parameter("safe_search", "true")
+    .with_custom_header("gi-country-code", "CAN")
+    .execute()
+```
+
 ### Use the custom request functionality for GET request with query parameters
 
 ```ruby

data/lib/Downloads/DownloadImages.rb

@@ -2,13 +2,13 @@ require_relative "../RequestBase.rb"
 
 class DownloadImages < RequestBase
 
-    attr_accessor :asset_id, :accept_language
+    attr_accessor :asset_id
 
-	API_ROUTE = "/v3/downloads/images" # mashery endpoint	
-	QUERY_PARAMS_NAMES = ["file_type","height","product_id","product_type"]	
+	API_ROUTE = "/v3/downloads/images"
+	QUERY_PARAM_NAMES = ["file_type","height","product_id","product_type"]	
 
-	QUERY_PARAMS_NAMES.each do |key|
-    define_method :"with_#{key}" do |value = true| 
+	QUERY_PARAM_NAMES.each do |key|
+        define_method :"with_#{key}" do |value = true| 
             if (!key.include? "id") && (value.is_a?(String))
                 value.downcase!
             end	
@@ -23,16 +23,10 @@ class DownloadImages < RequestBase
         return self
     end
 
-    public
-	def with_accept_language(language)
-		@accept_language = {"Accept-Language" => language}
-		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, accept_language)			
+		return @http_helper.post(uri, @query_params, nil, @headers)			
 	end
 
 end

data/lib/Downloads/DownloadVideos.rb

@@ -2,20 +2,17 @@ require_relative "../RequestBase.rb"
 
 class DownloadVideos < RequestBase
 
-    attr_accessor :asset_id, :accept_language
+    attr_accessor :asset_id
 
-	API_ROUTE = "/v3/downloads/videos" # mashery endpoint	
-	QUERY_PARAMS_NAMES = ["product_id","size"]	
+	API_ROUTE = "/v3/downloads/videos"
+	QUERY_PARAM_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
+	QUERY_PARAM_NAMES.each do |key|
+		define_method :"with_#{key}" do |value = true| 
+			add_parameter(key, value)
+			return self
+		end
+	end
       
     public 	
     def with_id(asset_id)	
@@ -23,16 +20,10 @@ class DownloadVideos < RequestBase
         return self
     end
 
-    public
-	def with_accept_language(language)
-		@accept_language = {"Accept-Language" => language}
-		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, accept_language)			
+		return @http_helper.post(uri, @query_params, nil, @headers)			
 	end
 
 end

data/lib/GettyImagesApi/version.rb

@@ -1,3 +1,3 @@
 module GettyImagesApi
-	VERSION = "3.0.1"
+	VERSION = "3.1.0"
 end

data/lib/Images/Images.rb

@@ -2,21 +2,17 @@ require_relative "../RequestBase.rb"
 
 class Images < RequestBase
 
-    attr_accessor :asset_id, :accept_language
+    attr_accessor :asset_id
 
-	API_ROUTE = "/v3/images" # mashery endpoint	
-	QUERY_PARAMS_NAMES = ["ids","fields"]
+	API_ROUTE = "/v3/images"
+	QUERY_PARAM_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
+	QUERY_PARAM_NAMES.each do |key|
+		define_method :"with_#{key}" do |value = true| 
+			add_parameter(key, value)
+			return self
+		end
+	end
 			
 	public 
     def with_id(id)
@@ -24,16 +20,11 @@ class Images < RequestBase
 		return self
 	end
 
-	public
-	def with_accept_language(language)
-		@accept_language = {"Accept-Language" => language}
-		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, @accept_language)			
+		return @http_helper.get(uri, @query_params, @headers)			
 	end
 
 end

data/lib/RequestBase.rb

@@ -2,13 +2,14 @@ require_relative "HttpHelper"
 
 class RequestBase
 
-	attr_accessor :http_helper, :query_params
+	attr_accessor :http_helper, :query_params, :headers
 
 	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
+		@headers = Hash.new
 
 	end	
 
@@ -17,4 +18,37 @@ class RequestBase
 		@query_params[key].nil? ? @query_params[key] = value : @query_params[key] << "," + value
 	end 
 
+	protected
+	def add_parameter(key, value)
+		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
+	end
+
+	public
+	def with_accept_language(language)
+		@headers["Accept-Language"] = language
+		return self
+	end
+
+	public
+	def with_custom_header(key, value)
+		@headers[key] = value
+		return self
+	end
+
+	public
+	def with_custom_parameter(key, value)
+		add_parameter(key, value)
+		return self
+	end
 end

data/lib/Search/SearchImages.rb

@@ -2,38 +2,20 @@ require_relative "../RequestBase.rb"
 
 class SearchImages < RequestBase
 
-	attr_accessor :accept_language
-
 	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",
+	QUERY_PARAM_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","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 with_accept_language(language)
-		@accept_language = {"Accept-Language" => language}
-		return self
+	
+	QUERY_PARAM_NAMES.each do |key|
+		define_method :"with_#{key}" do |value = true| 
+			add_parameter(key, value)
+			return self
+		end
 	end
 
 	def execute
-		return @http_helper.get(API_ROUTE, @query_params, @accept_language)			
+		return @http_helper.get(API_ROUTE, @query_params, @headers)			
 	end
 
 end

data/lib/Search/SearchImagesCreative.rb

@@ -2,38 +2,24 @@ require_relative "../RequestBase.rb"
 
 class SearchImagesCreative < RequestBase
 
-	attr_accessor :accept_language
+	QUERY_PARAM_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","minimum_size","number_of_people","orientations","page","page_size","phrase","prestige_content_only","product_types",
+		"sort_order"]
 
-	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","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 with_accept_language(language)
-		@accept_language = {"Accept-Language" => language}
-		return self
+	def initialize(api_key, access_token)
+		super
+		@api_route = "/v3/search/images/creative"
 	end
 
+	QUERY_PARAM_NAMES.each do |key|
+		define_method :"with_#{key}" do |value = true| 
+			add_parameter(key, value)
+			return self
+		end
+	end
+	  		  
 	def execute
-		return @http_helper.get(API_ROUTE, @query_params, @accept_language)			
+		return @http_helper.get(@api_route, @query_params, @headers)			
 	end
 
 end

data/lib/Search/SearchImagesEditorial.rb

@@ -2,38 +2,21 @@ require_relative "../RequestBase.rb"
 
 class SearchImagesEditorial < RequestBase
 
-	attr_accessor :accept_language
-
-	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",
+	API_ROUTE = "/v3/search/images/editorial"
+    QUERY_PARAM_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
+	QUERY_PARAM_NAMES.each do |key|
+		define_method :"with_#{key}" do |value = true| 
+			add_parameter(key, value)
+			return self
+		end
 	end
 
-	def with_accept_language(language)
-		@accept_language = {"Accept-Language" => language}
-		return self
-	end
-	  
+
 	def execute
-		return @http_helper.get(API_ROUTE, @query_params, @accept_language)			
+		return @http_helper.get(API_ROUTE, @query_params, @headers)			
 	end
 
 end

data/lib/Search/SearchVideos.rb

@@ -1,38 +1,20 @@
 require_relative "../RequestBase.rb"
 
 class SearchVideos < RequestBase
-
-	attr_accessor :accept_language
 	
-	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",
+	API_ROUTE = "/v3/search/videos"
+    QUERY_PARAM_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 with_accept_language(language)
-		@accept_language = {"Accept-Language" => language}
-		return self
+	QUERY_PARAM_NAMES.each do |key|
+		define_method :"with_#{key}" do |value = true| 
+			add_parameter(key, value)
+			return self
+		end
 	end
 
 	def execute
-		return @http_helper.get(API_ROUTE, @query_params, @accept_language)			
+		return @http_helper.get(API_ROUTE, @query_params, @headers)			
 	end
 
 end

data/lib/Search/SearchVideosCreative.rb

@@ -2,37 +2,19 @@ require_relative "../RequestBase.rb"
 
 class SearchVideosCreative < RequestBase
 
-	attr_accessor :accept_language
-
-	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",
+	API_ROUTE = "/v3/search/videos/creative"
+    QUERY_PARAM_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 with_accept_language(language)
-		@accept_language = {"Accept-Language" => language}
-		return self
+	QUERY_PARAM_NAMES.each do |key|
+		define_method :"with_#{key}" do |value = true| 
+			add_parameter(key, value)
+			return self
+		end
 	end
-
+	  
 	def execute
-		return @http_helper.get(API_ROUTE, @query_params, @accept_language)			
+		return @http_helper.get(API_ROUTE, @query_params, @headers)			
 	end
 
 end

data/lib/Search/SearchVideosEditorial.rb

@@ -2,37 +2,19 @@ require_relative "../RequestBase.rb"
 
 class SearchVideosEditorial < RequestBase
 
-	attr_accessor :accept_language
-
-	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",
+	API_ROUTE = "/v3/search/videos/editorial"
+    QUERY_PARAM_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 with_accept_language(language)
-		@accept_language = {"Accept-Language" => language}
-		return self
+	QUERY_PARAM_NAMES.each do |key|
+		define_method :"with_#{key}" do |value = true| 
+			add_parameter(key, value)
+			return self
+		end
 	end
-
+	
 	def execute
-		return @http_helper.get(API_ROUTE, @query_params, @accept_language)			
+		return @http_helper.get(API_ROUTE, @query_params, @headers)			
 	end
 
 end

data/lib/Videos/Videos.rb

@@ -2,21 +2,17 @@ require_relative "../RequestBase.rb"
 
 class Videos < RequestBase
 
-    attr_accessor :asset_id, :accept_language
+    attr_accessor :asset_id
 
-	API_ROUTE = "/v3/videos" # mashery endpoint	
-	QUERY_PARAMS_NAMES = ["ids","fields"]
+	API_ROUTE = "/v3/videos"
+	QUERY_PARAM_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
+	QUERY_PARAM_NAMES.each do |key|
+		define_method :"with_#{key}" do |value = true| 
+			add_parameter(key, value)
+			return self
+		end
+	end
 			
 	public 
     def with_id(id)
@@ -24,16 +20,11 @@ class Videos < RequestBase
 		return self
 	end
 
-	public
-	def with_accept_language(language)
-		@accept_language = {"Accept-Language" => language}
-		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, @accept_language)			
+		return @http_helper.get(uri, @query_params, @headers)			
 	end
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: gettyimages-api
 version: !ruby/object:Gem::Version
-  version: 3.0.1
+  version: 3.1.0
 platform: ruby
 authors:
 - Getty Images
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-06-03 00:00:00.000000000 Z
+date: 2022-09-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler