youtuberb 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 621b21bea6af44d5d861d0fd9f6d4394b0cc4f164c87e96ae97b49b284f9187a
-  data.tar.gz: 0623d21c9c87e88c0968f25e405959994cbdd57c6578c491a471c21afec098e1
+  metadata.gz: abca9225386659a452e73a1a188260a389d4b9801ee8bad9cca354f0caf7fe46
+  data.tar.gz: 7c83234a7f9b0ce77a81ad8d152e3cae422052bee1145c974260011c4c7dbbc7
 SHA512:
-  metadata.gz: 508dc5051850a3378fceb20a15e569a6b58d6eb456271d8cd4247b394e5c241d6015085e36150258775d2b2fb71d75f5c69f77193774f7dd3fcd5a4502450501
-  data.tar.gz: 04c65890328f1126f5760d91ee984a046c464143936420a61628dbcdd139171db51071496de3413d7cb4b514559536ca19cc345456ad113716eaa5d57e648b3a
+  metadata.gz: 151f38d41251545eb90b3aa978b4b0293222ae1f70fd6edc34ffcc16b44200db773eddb9decb89340177c4050bb19c4c69dd3252951a1335946759b72a9ccfaa
+  data.tar.gz: 971c715687e1486aab1883055a08ecaa59c9271d223522f11e7b5a7d0902d2d4f2bf1f62329b48d400c2b68b0481211475a984e1bd8002ce47978cb92b49016c

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    youtuberb (0.1.1)
+    youtuberb (0.1.2)
       faraday (~> 1.7)
       faraday_middleware (~> 1.1)
 

data/README.md

@@ -17,15 +17,39 @@ gem 'youtuberb'
 ### Set Client Details
 
 Firstly you'll need to set an API Key and an Access Token. 
+An Access Token will be an OAuth2 token generated after authentication. 
 
 ```ruby
 @client = YouTube::Client.new(api_key: "", access_token: "")
 ```
 
+### Channels
+
+```ruby
+# Get the Channel details of the currently authenticated user
+@client.channels.mine
+
+# Get a Channel by ID
+@client.channels.retrieve(id: "channel_id")
+
+# Get a Channel by username
+@client.channels.retrieve(username: "username")
+```
+
 ### Videos
 
 ```ruby
-@client.videos.get_by_id(user_id: 141981764)
+# Get a single video
+@client.videos.list(id: "abc123")
+
+# Get multiple videos
+@client.videos.list(id: "abc123,123abc")
+
+# Liked videos for the currently authenticated user
+@client.videos.liked
+
+# Get a video owned by the current user. This retrieves extra information so will only work on videos owned by the current user.
+@client.videos.retrieve(id: "abc123")
 ```
 
 ### Playlists
@@ -45,6 +69,22 @@ Firstly you'll need to set an API Key and an Access Token.
 @client.playlists.update(id: "playlist_id", title: "My Playlist", privacy_status: "public")
 @client.playlists.delete(id: "playlist_id")
 ```
+### Playlist Items
+
+```ruby
+# Playlist Items for a Playlist
+@client.playlist_items.list(playlist_id: "playlist_id")
+
+@client.playlist_items.retrieve(id: "playlist_item_id")
+
+# Add a video to a playlist
+@client.playlist_items.create(playlist_id: "playlist_id", video_id: "video_id")
+
+@client.playlist_items.update(id: "playlist_item_id", playlist_id: "playlist_id", video_id: "video_id")
+
+@client.playlist_items.delete(id: "playlist_id")
+```
+
 ## Contributing
 
 Bug reports and pull requests are welcome on GitHub at https://github.com/deanpcmad/youtuberb.

data/lib/you_tube/client.rb

@@ -13,8 +13,8 @@ module YouTube
       @stubs = stubs
     end
 
-    def activities
-      ActivitiesResource.new(self)
+    def channels
+      ChannelsResource.new(self)
     end
 
     def videos

data/lib/you_tube/objects/channel.rb

@@ -0,0 +1,29 @@
+module YouTube
+  class Channel < Object
+
+    def initialize(options = {})
+      super options
+
+      if options["snippet"]
+        self.title        = options["snippet"]["title"]
+        self.description  = options["snippet"]["description"]
+        self.published_at = options["snippet"]["publishedAt"]
+
+        if options["snippet"]["thumbnails"]
+          thumb = options["snippet"]["thumbnails"]
+          self.thumbnail_default  = thumb["default"]["url"]   if thumb["default"]
+          self.thumbnail_medium   = thumb["medium"]["url"]    if thumb["medium"]
+          self.thumbnail_high     = thumb["high"]["url"]      if thumb["high"]
+          self.thumbnail_standard = thumb["standard"]["url"]  if thumb["standard"]
+          self.thumbnail_maxres   = thumb["maxres"]["url"]    if thumb["maxres"]
+        end
+      end
+
+      if options["status"]
+        self.privacy_status      = options["status"]["privacyStatus"]
+        self.long_uploads_status = options["status"]["longUploadsStatus"]
+      end
+    end
+
+  end
+end

data/lib/you_tube/resources/channels.rb

@@ -0,0 +1,25 @@
+module YouTube
+  class ChannelsResource < Resource
+
+    PARTS = "id,snippet,status,statistics"
+
+    # Retrieve the channel of the currently authenticated user
+    def mine
+      response = get_request "channels", params: {mine: true, part: PARTS}
+      return nil if response.body["pageInfo"]["totalResults"] == 0
+      Channel.new(response.body["items"][0])
+    end
+    
+    # Retrieve a Channel by its ID or Username
+    def retrieve(id: nil, username: nil)
+      attrs = {}
+      attrs[:id] = id if id
+      attrs[:forUsername] = username if username
+
+      response = get_request "channels", params: attrs.merge({part: PARTS})
+      return nil if response.body["pageInfo"]["totalResults"] == 0
+      Channel.new(response.body["items"][0])
+    end
+
+  end
+end

data/lib/you_tube/version.rb

@@ -1,3 +1,3 @@
 module YouTube
-  VERSION = "0.1.1"
+  VERSION = "0.1.2"
 end

data/lib/you_tube.rb

@@ -12,12 +12,12 @@ module YouTube
   autoload :Resource, "you_tube/resource"
   autoload :Object, "you_tube/object"
 
-  autoload :ActivitiesResource, "you_tube/resources/activities"
+  autoload :ChannelsResource, "you_tube/resources/channels"
   autoload :VideosResource, "you_tube/resources/videos"
   autoload :PlaylistsResource, "you_tube/resources/playlists"
   autoload :PlaylistItemsResource, "you_tube/resources/playlist_items"
 
-  autoload :Activity, "you_tube/objects/activity"
+  autoload :Channel, "you_tube/objects/channel"
   autoload :Video, "you_tube/objects/video"
   autoload :Playlist, "you_tube/objects/playlist"
   autoload :PlaylistItem, "you_tube/objects/playlist_item"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: youtuberb
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
 platform: ruby
 authors:
 - Dean Perry
@@ -58,12 +58,12 @@ files:
 - lib/you_tube/collection.rb
 - lib/you_tube/error.rb
 - lib/you_tube/object.rb
-- lib/you_tube/objects/activity.rb
+- lib/you_tube/objects/channel.rb
 - lib/you_tube/objects/playlist.rb
 - lib/you_tube/objects/playlist_item.rb
 - lib/you_tube/objects/video.rb
 - lib/you_tube/resource.rb
-- lib/you_tube/resources/activities.rb
+- lib/you_tube/resources/channels.rb
 - lib/you_tube/resources/playlist_items.rb
 - lib/you_tube/resources/playlists.rb
 - lib/you_tube/resources/videos.rb

data/lib/you_tube/objects/activity.rb

@@ -1,4 +0,0 @@
-module YouTube
-  class Activity < Object
-  end
-end

data/lib/you_tube/resources/activities.rb

@@ -1,11 +0,0 @@
-module YouTube
-  class ActivitiesResource < Resource
-    
-    def list
-      response = get_request "activities", params: {home: true}
-      # response = post_request("games", body: "fields id,name,status,url,created_at,updated_at;")
-      # Collection.from_response(response, type: Game)
-    end
-
-  end
-end