instagram_graph_api 0.0.8 → 0.0.13

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 64d1de43c28966fc8f80eb2b9724c17eb15e0ad3a7ecde0df75419fbaf90296d
-  data.tar.gz: f64f55b10813fe6f5921d33b3a3a1e8e5c331a04c6898abbb9d51f620af25e0b
+  metadata.gz: 8488ee797ab4f487ebf19776f064806f7347631fc38354cf6722112730c8c737
+  data.tar.gz: df891d813d3d93d55e8be002d5ac6cba0fafd7d83cedfc4164dda5402053daf4
 SHA512:
-  metadata.gz: ca56aee8b68c7290a25a5bc9ded5cecde8ff21347693872cf58b9d0abe759a5dd02cc2cd5f6f42383cfb429502b6fe3099fce87deecb6688eaae88eed5a81625
-  data.tar.gz: 24e610740383774f98a80ce1dd04896a34262d6c81b7facbeb7ecbf7da0882f9f427893b075235eda4fc848e2701fffc9a94b3dcfaeea4bcca79c6ec4525f002
+  metadata.gz: 0b3d554de5a6a3e930a55b8dbb00a426acb2212ef8dfd8dd03425343d7e2bdb1b127441f8058fbb1c78d1bd51d7de31a0fd2cad56680d4a9197a05b8793dc519
+  data.tar.gz: d281bc46eb5d3e8e790f118653e11c00c70cb0071e9405225c0f20bfa49062b39f8b042b013682d14435b2fd55ba9e57dc28eb3c9cd9ba76923f573e17c6d8ff

data/README.md

@@ -25,8 +25,14 @@ client = InstagramGraphApi.client(ACCESS_TOKEN)
 
 #get an arraay of business accounts linked to the access_token
 client.ig_business_accounts
+#get an array of connected IG accounts linked to the access_token
+client.connected_ig_accounts
 
-#get IG business account info
+#to get specific fields from "id,name,biography,ig_id,followers_count,profile_picture_url,username"
+client.ig_business_accounts("name,followers_count")
+client.connected_ig_accounts("name,followers_count")
+
+#get IG business account/ Connected IG account info
 client.get_account_info(IG_BUSINESS_ID)
 #to get specific fields
 fields = "name, biography"
@@ -49,6 +55,16 @@ client.discover_user(USERNAME, fields)
 
 #discover user media, fields can be "caption,media_url,media_type,like_count,comments_count,id"
 client.discover_user_media(USERNAME, fields)
+
+#Search for a tag, 
+client.tag_media(page_token, tag_name)
+#fields can be "media_type,comments_count,like_count,media_url,permalink"
+fields="media_url,permalink"
+client.tag_media(page_token, tag_name, fields)
+#custom edge can be provided, default is 'top_media'
+tag_media = client.tag_media(page_token, tag_name, edge: "recent_media")
+# Note: We can run `tag_media.next_page` to fetch next set of results
+# additional arguent options can also be passed for page params i.e before/after/limit etc
 ```
 
 ## Development

data/instagram_graph_api.gemspec

@@ -33,7 +33,7 @@ Gem::Specification.new do |spec|
   spec.require_paths = ["lib"]
 
   spec.add_development_dependency "bundler", "~> 1.16"
-  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rake", ">= 12.3.3"
   spec.add_development_dependency "pry"
   spec.add_dependency "koala"
 end

data/lib/instagram_graph_api/client.rb

@@ -4,12 +4,10 @@ module InstagramGraphApi
   class Client < Koala::Facebook::API
     Dir[File.expand_path('../client/*.rb', __FILE__)].each{|f| require f}
 
+    include InstagramGraphApi::Client::Insights
     include InstagramGraphApi::Client::Users
     include InstagramGraphApi::Client::Media
     include InstagramGraphApi::Client::Discovery
-
-    def initialize(media_id = nil, access_token)
-      super(access_token)
-    end
+    include InstagramGraphApi::Client::Tag
   end
 end

data/lib/instagram_graph_api/client/discovery.rb

@@ -14,7 +14,7 @@ module InstagramGraphApi
       def discover_user_media(username, fields = nil, options={})
         fields ||= "caption,media_url,media_type,like_count,comments_count,id"
         page_options = ".after(#{options['after']})" if options["after"]
-        page_options = ".before(#{options['before']})" if options["before"]
+        page_options = ".after(#{options['before']})" if options["before"]
         discover_user(username, "media#{page_options}{#{fields}}")
       end
     end

data/lib/instagram_graph_api/client/insights.rb

@@ -0,0 +1,21 @@
+module InstagramGraphApi
+  class Client
+    module Insights
+
+      METRIC_HASH = {
+        image: 'impressions,reach',
+        video: 'impressions,reach,video_views',
+        story: 'impressions,replies,reach,taps_forward,taps_back,exits'
+      }
+
+      def insights(object_id, type: "image", metrics: nil)
+        metrics ||= METRIC_HASH[type.to_sym]
+        @raw_insights = get_connections(object_id, "insights?metric=#{metrics}")
+        @raw_insights.reduce({}) do |result, insight_data|
+          result[insight_data["name"]] = insight_data["values"].first["value"]
+          result
+        end
+      end
+    end
+  end
+end

data/lib/instagram_graph_api/client/media.rb

@@ -3,12 +3,6 @@ module InstagramGraphApi
     module Media
       attr_accessor :media_info, :raw_insights
 
-      METRIC_HASH = {
-        image: 'impressions,reach',
-        video: 'impressions,reach,video_views',
-        story: 'impressions,replies,reach,taps_forward,taps_back,exits'
-      }
-
       MEDIA_INFO_HASH = {
         image: "comments_count,like_count,media_type,"\
                     "media_url,permalink,timestamp,thumbnail_url",
@@ -18,27 +12,20 @@ module InstagramGraphApi
                       "timestamp,thumbnail_url"
       }
 
-      def get_user_recent_media(id, type: "image", options: {})
+      def get_user_recent_media(id, fields = nil, type: "image", options: {})
         entity = type.eql?("story") ? "stories" : "media"
-        query = "#{entity}?fields=#{MEDIA_INFO_HASH[type.to_sym]}"
+        fields ||= MEDIA_INFO_HASH[type.to_sym]
+        query = "#{entity}?fields=#{fields}"
         query += "&after=#{options[:after]}" if options[:after]
         query += "&before=#{options[:before]}" if options[:before]
         get_connections(id, query)
       end
 
-      def get_media_details(media_id, type: "image")
+      def get_media_details(media_id, fields = nil, type: "image")
         fields ||= MEDIA_INFO_HASH[type.to_sym]
         get_connections(media_id , "?fields=#{fields}")
       end
 
-      def insights(media_id, type: "image", metrics: nil)
-        metrics ||= METRIC_HASH[type.to_sym]
-        @raw_insights = get_connections(media_id , "insights?metric=#{metrics}")
-        @raw_insights.reduce({}) do |result, insight_data|
-          result[insight_data["name"]] = insight_data["values"].first["value"]
-          result
-        end
-      end
     end
   end
 end

data/lib/instagram_graph_api/client/tag.rb

@@ -0,0 +1,21 @@
+module InstagramGraphApi
+  class Client
+    module Tag
+      def tag_media(page_token, tag_name, fields = nil, edge: "top_media", options: {})
+        user_id = get_ig_id_from_token(page_token)
+        tag_info = graph_call("ig_hashtag_search?user_id=#{user_id}&q=#{tag_name}")[0]
+        fields ||= "id,media_type,comments_count,like_count,media_url,permalink"
+        query = "#{edge}?user_id=#{user_id}&fields=#{fields}"
+        query += options.reduce(""){|s, (k, v)| s+= "&#{k}=#{v}" }
+        get_connections(tag_info["id"], query)
+      end
+
+      private
+
+      def get_ig_id_from_token(token)
+        account_info = get_connections('me', "?fields=connected_instagram_account")
+        account_info.dig("connected_instagram_account", "id")
+      end
+    end
+  end
+end

data/lib/instagram_graph_api/client/users.rb

@@ -9,6 +9,14 @@ module InstagramGraphApi
         end.compact
       end
 
+      def connected_ig_accounts(fields = nil)
+        fields ||= 'id,name,biography,ig_id,followers_count,profile_picture_url,username'
+        accounts = get_pages("?fields=connected_instagram_account{#{fields}}")
+        accounts.map do |a|
+          a["connected_instagram_account"].merge(page_id: a["id"]) if a["connected_instagram_account"]
+        end.compact
+      end
+
       def get_account_info(ig_account_id, fields = nil)
         fields ||= "biography,followers_count,ig_id,name,profile_picture_url,username,id"
         get_connections(ig_account_id , "?fields=#{fields}")

data/lib/instagram_graph_api/version.rb

@@ -1,3 +1,3 @@
 module InstagramGraphApi
-  VERSION = "0.0.8"
+  VERSION = "0.0.13"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: instagram_graph_api
 version: !ruby/object:Gem::Version
-  version: 0.0.8
+  version: 0.0.13
 platform: ruby
 authors:
 - Rakesh
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2018-09-28 00:00:00.000000000 Z
+date: 2020-12-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -28,16 +28,16 @@ dependencies:
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: 12.3.3
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: 12.3.3
 - !ruby/object:Gem::Dependency
   name: pry
   requirement: !ruby/object:Gem::Requirement
@@ -86,7 +86,9 @@ files:
 - lib/instagram_graph_api.rb
 - lib/instagram_graph_api/client.rb
 - lib/instagram_graph_api/client/discovery.rb
+- lib/instagram_graph_api/client/insights.rb
 - lib/instagram_graph_api/client/media.rb
+- lib/instagram_graph_api/client/tag.rb
 - lib/instagram_graph_api/client/users.rb
 - lib/instagram_graph_api/version.rb
 homepage: https://github.com/rakeshpatra/instagram_graph_api
@@ -108,8 +110,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.7
+rubygems_version: 3.0.6
 signing_key: 
 specification_version: 4
 summary: Instagram Graph API