rails-pinterest 0.1.2 → 0.1.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '097b2ce4d2ec083c16dde219ab02d002612ed44147f0ea1ba7efbca852fd619f'
-  data.tar.gz: 4997ffce4d401df22dcd418437d75d0156bafa0b89568906a62b46b348286a71
+  metadata.gz: 8aab3135f3b808a0275ebf74d586cd5c5d10c8adf00c742dd5774160dbd2fca7
+  data.tar.gz: d22b0aa38454c2bf9f3a9c2b90da90167a187b0980ee5c55241b89518c1d31a6
 SHA512:
-  metadata.gz: '009d70127767d9823c65f25f88bb5a2c4aff755edcd3b0a750f2160efb79724053ec20d168cfe0643963b034610b07400ba1dd52c5e1e6242b052e5758fc3721'
-  data.tar.gz: ec8e20194ed18c512c3ed412d94e571b382608cfcbe72a87f2b0e9a93233481d2a322b618f22768957fe068107de5631cd9c48a2f00c5545747f50e6ce1e8382
+  metadata.gz: 3f5537f6e8f1fc2730c271058b48bc8e1c9d2403a0de760f8f994b66e073c8f0ce4ceb87de7d0f60e5eedfccd418fcb07288141e517beab5a1c9e7d7c3803778
+  data.tar.gz: dc2870525a7a25bbb42979b86f7c999561fe0ed6bd64da4aad93af267f3838c482de0233b4a22023b9dbdf811dceb750dc7ab146ef09c979e2049d415b731dc8

data/CHANGELOG.md

@@ -11,4 +11,10 @@
 - Re-release to rubygems
 
 ## [0.1.2] - 2023-12-2
-- Added oauth refresh token endpoint.
+- Added oauth refresh token endpoint.
+
+## [0.1.3] - 2023-12-2
+- Add to ReadMe how to get access token from a authorization token
+
+## [0.1.4] - 2024-01-17
+- Add keywords and terms to API

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    rails-pinterest (0.1.2)
+    rails-pinterest (0.1.4)
       faraday (>= 1)
       faraday-multipart (>= 1)
 
@@ -73,6 +73,7 @@ GEM
 
 PLATFORMS
   x86_64-darwin-19
+  x86_64-darwin-23
 
 DEPENDENCIES
   byebug (~> 11.1.3)

data/README.md

@@ -176,6 +176,29 @@ response = client.pins.create_pin(parameters: parameters)
 
 ### Oauth
 
+How to get exchange your authorization code for an access token [(step 3)](https://developers.pinterest.com/docs/getting-started/authentication/)
+```ruby
+# https://developers.pinterest.com/docs/getting-started/authentication/
+
+# POST /oauth/tokens to exchange authorization code for access token
+
+# 1. Build the client
+client = Pinterest::Client.new(access_token: "fake-token-because-you-dont-have-this-yet", client_id: "client-id" , secret_key: "secret-key")
+
+# 2. Build parameters
+parameters = {
+  'grant_type'    => 'authorization_code', # Required from Pinterest
+  'code'          => params[:code].to_s, # Replace with the actual authorization code
+  'redirect_uri'  => "your-redirect-uri"
+}
+
+# 3. Get the access token
+response = client.oauth.retrieve_oauth_token(parameters: parameters)
+puts response
+# { "access_token": "{an access token string prefixed with 'pina'}", "refresh_token": "{a refresh token string prefixed with 'pinr'}", "response_type": "authorization_code", ..
+
+```
+
 How to refresh your access tokens
 
 ```ruby

data/lib/pinterest/client.rb

@@ -31,6 +31,14 @@ module Pinterest
       @pins ||= Pinterest::Pins.new(client: self)
     end
 
+    def terms
+      @terms ||= Pinterest::Pins.new(client: self)
+    end
+
+    def keywords
+      @pins ||= Pinterest::Keywords.new(client: self)
+    end
+
     def oauth
       @oauth ||= Pinterest::Oauth.new(client: self)
     end

data/lib/pinterest/keywords.rb

@@ -0,0 +1,30 @@
+module Pinterest
+  class Keywords
+    def initialize(client: nil)
+      @client = client
+    end
+
+    def get_keywords(ad_account_id:, parameters: {})
+      @client.get(path: "/ad_accounts/#{ad_account_id}/keywords", parameters: parameters)
+    end
+
+    def create_keywords(ad_account_id:, parameters: {})
+      @client.json_post(path: "/ad_accounts/#{ad_account_id}/keywords", parameters: parameters)
+    end
+
+    def update_keywords(ad_account_id:, parameters: {})
+      @client.patch(path: "/ad_accounts/#{ad_account_id}/keywords", parameters: parameters)
+    end
+
+    def get_country_keyword_metrics(ad_account_id:, parameters: {})
+      @client.get(path: "/ad_accounts/#{ad_account_id}/keywords", parameters: parameters)
+    end
+
+    # Region list: "US" "CA" "DE" "FR" "ES" "IT" "DE+AT+CH" "GB+IE" "IT+ES+PT+GR+MT" "PL+RO+HU+SK+CZ" "SE+DK+FI+NO" "NL+BE+LU" "AR" "BR" "CO" "MX" "MX+AR+CO+CL" "AU+NZ"
+    # trend_type: "growing" "monthly" "yearly" "seasonal"
+    # https://developer.pinterest.com/docs/api/v5/#operation/trending_keywords/list
+    def list_trending_keywords(region:, trend_type:, parameters: {})
+      @client.get(path: "/trends/keywords/#{region}/top/#{trend_type}", parameters: parameters)
+    end
+  end
+end

data/lib/pinterest/terms.rb

@@ -0,0 +1,16 @@
+module Pinterest
+  class Terms
+    def initialize(client: nil)
+      @client = client
+    end
+
+    # parameters: { terms: ["example", "of", "query"]}
+    def list_related_terms(parameters: {})
+      @client.get(path: "/terms/related", parameters: parameters)
+    end
+
+    def list_suggested_terms(parameters: {})
+      @client.get(path: "/terms/suggested", parameters: parameters)
+    end
+  end
+end

data/lib/pinterest/version.rb

@@ -1,3 +1,3 @@
 module Pinterest
-  VERSION = "0.1.2"
+  VERSION = "0.1.4"
 end

data/lib/pinterest.rb

@@ -3,8 +3,10 @@ require "faraday/multipart"
 require_relative "pinterest/http"
 require_relative "pinterest/client"
 require_relative "pinterest/boards"
+require_relative "pinterest/keywords"
 require_relative "pinterest/oauth"
 require_relative "pinterest/pins"
+require_relative "pinterest/terms"
 require_relative "pinterest/version"
 
 module Pinterest

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rails-pinterest
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.1.4
 platform: ruby
 authors:
 - Donald Lee
-autorequire:
+autorequire: 
 bindir: exe
 cert_chain: []
-date: 2023-12-03 00:00:00.000000000 Z
+date: 2024-01-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -38,7 +38,7 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '1'
-description:
+description: 
 email:
 - donaldlee50@gmail.com
 executables: []
@@ -60,8 +60,10 @@ files:
 - lib/pinterest/client.rb
 - lib/pinterest/compatibility.rb
 - lib/pinterest/http.rb
+- lib/pinterest/keywords.rb
 - lib/pinterest/oauth.rb
 - lib/pinterest/pins.rb
+- lib/pinterest/terms.rb
 - lib/pinterest/version.rb
 - lib/ruby/pinterest.rb
 - rails-pinterest.gemspec
@@ -73,7 +75,7 @@ metadata:
   homepage_uri: https://github.com/royalgiant/rails-pinterest
   source_code_uri: https://github.com/royalgiant/rails-pinterest
   changelog_uri: https://github.com/royalgiant/rails-pinterest/blob/main/CHANGELOG.md
-post_install_message:
+post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -88,8 +90,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.3
-signing_key:
+rubygems_version: 3.0.3.1
+signing_key: 
 specification_version: 4
 summary: Pinterest API + Ruby!
 test_files: []