instagram_graph_api 0.0.7 → 0.0.12

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: daeb123714cedb898fce9eb3aa4e7dade4650b7d4f98c3d3ac28c44c80645567
-  data.tar.gz: 21f71e8be7b3d10525033562e5cf1129979187ff50463b7f91fe2780632a1df2
+  metadata.gz: 15be12b49a31da27c8d3978f2aaebb969091477d1c4d5e1a842dc4b9fd3f7b54
+  data.tar.gz: 5a20b15b6abf7dbc84cbccecfaecb7fd9ca46978140e6b548104c6e314d5debf
 SHA512:
-  metadata.gz: a5f982b034e984577ec4de6a5f822685b1baaa5d241b91cc165f118f57bb4d8609cf7920b29703818d92f68af94ee3be94c2a4d53d7efd6dd1da8f1da7496f14
-  data.tar.gz: 4319cde2bf73ec1e8378fa0a6964bd4a49f83befd90d4411e244b6f4c8062bb54a4b2133cf1e74ef793c09bab49782fa93edb0dfebc9af9271fe51efdcff2372
+  metadata.gz: 743679160256cd91df0a4466adea7c5c9bb68c12991c87f855986f758ca9f4de41522fc590b1098beb39fbcfb0419449ca7341963d2996cd98d49380aa180de7
+  data.tar.gz: 03daa42f1f38d45dd5d870f658c83ca44cca73dae56a580652a9143f790ef057f6d590b469c33997ca9ff64253317f86c48bf5c18667a4fc9ddaea27fdd818cc

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 like before/after or any other custom filter
 ```
 
 ## Development

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/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.7"
+  VERSION = "0.0.12"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: instagram_graph_api
 version: !ruby/object:Gem::Version
-  version: 0.0.7
+  version: 0.0.12
 platform: ruby
 authors:
 - Rakesh
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2018-09-28 00:00:00.000000000 Z
+date: 2020-11-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -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