google-search 1.0.2

data/History.rdoc

@@ -0,0 +1,8 @@
+
+=== 1.0.2 / 2009-07-27
+
+* Defaulting Item#uri to unescapedUrl
+
+=== 1.0.0 / 2009-07-24
+
+* Initial release

data/Manifest

@@ -0,0 +1,70 @@
+examples/image.rb
+examples/images.html
+examples/web.rb
+google-search.gemspec
+History.rdoc
+lib/google-search/item/base.rb
+lib/google-search/item/blog.rb
+lib/google-search/item/book.rb
+lib/google-search/item/image.rb
+lib/google-search/item/local.rb
+lib/google-search/item/news.rb
+lib/google-search/item/patent.rb
+lib/google-search/item/video.rb
+lib/google-search/item/web.rb
+lib/google-search/item.rb
+lib/google-search/response.rb
+lib/google-search/search/base.rb
+lib/google-search/search/blog.rb
+lib/google-search/search/book.rb
+lib/google-search/search/image.rb
+lib/google-search/search/local.rb
+lib/google-search/search/mixins/filter.rb
+lib/google-search/search/mixins/order_by.rb
+lib/google-search/search/mixins/safety_level.rb
+lib/google-search/search/mixins.rb
+lib/google-search/search/news.rb
+lib/google-search/search/patent.rb
+lib/google-search/search/video.rb
+lib/google-search/search/web.rb
+lib/google-search/search.rb
+lib/google-search/version.rb
+lib/google-search.rb
+Manifest
+Rakefile
+README.rdoc
+spec/fixtures/400-response.json
+spec/fixtures/blog-response.json
+spec/fixtures/book-response.json
+spec/fixtures/image-response.json
+spec/fixtures/invalid-response.json
+spec/fixtures/local-response.json
+spec/fixtures/news-response.json
+spec/fixtures/patent-response.json
+spec/fixtures/video-response.json
+spec/fixtures/web-2-response.json
+spec/fixtures/web-response.json
+spec/item_blog_spec.rb
+spec/item_book_spec.rb
+spec/item_image_spec.rb
+spec/item_local_spec.rb
+spec/item_news_spec.rb
+spec/item_patent_spec.rb
+spec/item_spec.rb
+spec/item_video_spec.rb
+spec/item_web_spec.rb
+spec/response_spec.rb
+spec/search_blog_spec.rb
+spec/search_book_spec.rb
+spec/search_image_spec.rb
+spec/search_local_spec.rb
+spec/search_news_spec.rb
+spec/search_patent_spec.rb
+spec/search_spec.rb
+spec/search_video_spec.rb
+spec/search_web_spec.rb
+spec/spec.opts
+spec/spec_helper.rb
+tasks/docs.rake
+tasks/gemspec.rake
+tasks/spec.rake

data/README.rdoc

@@ -0,0 +1,95 @@
+
+= Google Search
+
+Fast, feature rich Google Search client. Search web results, images,
+books, local, patents, blogs and news using an elegant Ruby API with
+only a single dependency.
+
+== Dependencies 
+
+* json gem
+
+== Features
+
+* Fast
+* Lazy Enumeration (requests more results from google, not all at once)
+* Populates Google::Search::Item's blog, book, image, local, news, patent, video, and web
+* Clean, well documented source code
+* Full test coverage
+
+== Classes
+
+  - Google::Search                  | superclass of all other search classes. Is Enumerable
+  - Google::Search::Web             | web search.
+  - Google::Search::Blog            | blog search.
+  - Google::Search::Book            | book search.
+  - Google::Search::Image           | image search.
+  - Google::Search::Local           | local search.
+  - Google::Search::News            | news search.
+  - Google::Search::Patent          | patent search.
+  - Google::Search::Video           | video search.
+  - Google::Search::Response        | single request response, containing items. Is Enumerable
+  - Google::Search::Item            | single item, superclass of all other items.
+  - Google::Search::Item::Web       | single item containing web specific data.
+  - Google::Search::Item::Blog      | single item containing blog specific data.
+  - Google::Search::Item::Book      | single item containing book specific data.
+  - Google::Search::Item::Image     | single item containing image specific data.
+  - Google::Search::Item::Local     | single item containing local specific data.
+  - Google::Search::Item::News      | single item containing news specific data.
+  - Google::Search::Item::Patent    | single item containing patent specific data.
+  - Google::Search::Item::Video     | single item containing video specific data.
+
+== Arbitrary Query String Support
+
+Arbitrary key / value pairs may be passed to Google::Search.new, all options
+passed that are not assigned (deleted) will pass on to be part of the query string. 
+
+For argument reference visit: http://code.google.com/apis/ajaxsearch/documentation/reference.html#_fonje_web
+  
+== Items
+
+Each item type (web, image, etc) is a subclass of Google::Search::Item,
+whose constant is Google::Search::Item::{Web, Image, Blog, etc}. Every aspect
+of google-search is well documented, so poke around to learn more or view
+spec/item_spec.rb for item attributes.
+
+== Image example
+
+Below we simply create a new :image search, and pass a :query string.
+Query strings are urlencoded when Search#get_uri is called, so there
+is no reason to do so manually.
+
+  File.open('path/to/images.html', 'w+') do |file|
+    Google::Search::Image.new(:query => 'Cookies').each do |image|
+      file.write %(<img src="#{image.uri}">)
+    end
+  end
+  
+== More Information
+
+* View the source :) 
+
+== License:
+
+(The MIT License)
+
+Copyright (c) 2009 TJ Holowaychuk <tj@vision-media.ca>
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, an d/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/Rakefile

@@ -0,0 +1,16 @@
+
+$:.unshift 'lib'
+require 'google-search'
+require 'rubygems'
+require 'rake'
+require 'echoe'
+
+Echoe.new "google-search", Google::Search::VERSION do |p|
+  p.author = "TJ Holowaychuk"
+  p.email = "tj@vision-media.ca"
+  p.summary = "Google Search API"
+  p.url = "http://github.com/visionmedia/google-search"
+  p.runtime_dependencies << 'json'
+end
+
+Dir['tasks/**/*.rake'].sort.each { |f| load f }

data/examples/image.rb

@@ -0,0 +1,21 @@
+
+$:.unshift File.dirname(__FILE__) + '/../lib'
+require 'rubygems'
+require 'google-search'
+require 'rext/all'
+
+HTML = File.dirname(__FILE__) + '/images.html'
+
+File.open(HTML, 'w+') do |file|
+  Google::Search::Image.new(:query => 'Cookies', :image_size => :icon).each do |image|
+    file.write %(<img src="#{image.uri}">)
+  end
+end
+
+begin
+  `open -a Safari #{HTML}`
+rescue
+  puts "Not on OSX? wtf? open #{HTML} in your browser to view the images"
+end
+
+

data/examples/images.html

@@ -0,0 +1 @@
+<img src="http://i222.photobucket.com/albums/dd203/I_never_said_I_lie_and_wait_4ever/lmao.gif"><img src="http://www.kde-look.org/CONTENT/user-pics/0/cookies.gif"><img src="http://games2flash.net/files/image/cookiesJS1.gif"><img src="http://www.learnairbrush.com/forums/images/commerce/items/cookies-48x48.png"><img src="http://www.bigmoneyarcade.com/games/images/cooking-cookies-game.gif"><img src="http://icons.iconarchive.com/icons/fasticon/coffee-break/cookies-icon.jpg"><img src="http://i257.photobucket.com/albums/hh236/h3llokitty2/ICONATOR_1e3e3e686ed961a0b9009d3c3e.gif"><img src="http://farm4.static.flickr.com/3069/buddyicons/29481597%40N08.jpg"><img src="http://1.gravatar.com/avatar/1df546cd37482d661c0a10d36ad83af5%3Fs%3D48%26d%3Didenticon%26r%3DG"><img src="http://www.arcadeonline.com/games/other/cooking-cookies/cooking1.gif"><img src="http://blueberry.ipaula.com/affiliates/cookies.gif"><img src="http://farm1.static.flickr.com/73/buddyicons/26768826%40N00.jpg"><img src="http://www.adiumxtras.com/images/thumbs/cookies_7_3204_2847_thumb.png"><img src="http://www.educationcanada.com/images/cookies.gif"><img src="http://z.hubpages.com/u/10745_50.jpg"><img src="http://www.wowcoolstuff.com/v/vspfiles/photos/Fortune-cookies-0.jpg"><img src="http://z.hubpages.com/u/11745_50.jpg"><img src="http://profile.ak.facebook.com/object2/609/0/q8611607717_7269.jpg"><img src="http://images.allrecipes.com/site/allrecipes/holidays/easter09/cutest_cookies.jpg"><img src="http://www.pendletonsoccer.org/pysa/modules/Your_Account/images/warning.gif"><img src="http://ocanada.com.au/shop/media/catalog/product/cache/1/thumbnail/50x/5e06319eda06f020e43594a9c230972d/O/h/OhHenryCookies218g_Lge.gif"><img src="http://farm4.static.flickr.com/3044/buddyicons/31781247%40N03.jpg"><img src="http://home.nordnet.fr/~pmdevigne/Images/CookiesManager/cm48x48.gif"><img src="http://www.epicurious.com/images/articlesguides/howtocook/dishes/cookies_46.jpg"><img src="http://musicremedy.com/webfiles/artists/CasperandtheCookies/CasperandtheCookies-06-small.jpg"><img src="http://www.monkeydoit.com/content_images/icon-cookies.gif"><img src="http://img.alibaba.com/photo/233843288/Pastry_Homemade_Cookies_Mixed_12_OZ.summ.jpg"><img src="http://www.somethingmorestore.com/Images/BeanPod/OatMlCkies.jpg"><img src="http://z.hubpages.com/u/94731_50.jpg"><img src="http://images.meredith.com/bhg/images/ecards/50sq_ecardCmasCookies100176327.jpg"><img src="http://filesll.fluxstatic.com/FFFFD99501A67167000295D9FFFF/TN1/Jpg/B-9835/AR50x50,Crop/633696919200000000"><img src="http://farm2.static.flickr.com/1155/buddyicons/8292289%40N08.jpg"><img src="http://ocanada.com.au/shop/media/catalog/product/cache/1/thumbnail/50x/5e06319eda06f020e43594a9c230972d/M/a/Maplecream_Cookies.jpg"><img src="http://www.traderscity.com/board/userpixthumbs6/5280-entertainment-fortune-cookies-1.jpg"><img src="http://www.traderscity.com/board/userpixthumbs6/5280-birthday-fortune-cookies-1.jpg"><img src="http://www.avonandsomerset.police.uk/community_safety/internet_advice/images/cookies_pli.jpg"><img src="http://www.source-promotional-products.co.uk/images/adv_50.gif"><img src="http://img.afullcup.com/assets/images/coupondb/chips-cookies-crackers.png"><img src="http://www.calebseyes.com/_wizardimages/Cookies.gif"><img src="http://ecx.images-amazon.com/images/I/51RZQE-D1pL._SL75_PIsitb-sticker-arrow-st,TopRight,8,-14_OU02_SS50_.jpg"><img src="http://ecx.images-amazon.com/images/I/51OehUjVyuL._SL75_PIsitb-sticker-arrow-st,TopRight,8,-14_OU01_SS50_.jpg"><img src="http://farm1.static.flickr.com/139/buddyicons/23514648%40N00.jpg"><img src="http://ocanada.com.au/shop/media/catalog/product/cache/1/thumbnail/50x/5e06319eda06f020e43594a9c230972d/R/e/ReeseCookies198g_Lge.gif"><img src="http://www.madame-chocolat.com/media/catalog/product/cache/1/thumbnail/50x/5e06319eda06f020e43594a9c230972d/c/h/chocolate_chip_cookies.jpg"><img src="http://www.traderscity.com/board/userpixthumbs6/5280-love-fortune-cookies-1.jpg"><img src="http://popcdn.zoovy.lg1.simplecdn.net/img/orangeonions/W50-H50-Bffffff/C/chocolate_chip_cookies.jpg"><img src="http://my.opera.com/community/users/avatar.pl/1587122"><img src="http://www.snackordie.com/2008/12/22/ffblackmagecookieicon.jpg"><img src="http://www.snackordie.com/2009/02/02/bubblebobblecookieicon.jpg"><img src="http://my.opera.com/community/users/avatar.pl/1492038"><img src="http://ecx.images-amazon.com/images/I/51zObsVkTSL._SL75_PIsitb-sticker-arrow-st,TopRight,8,-14_OU02_SS50_.jpg"><img src="http://farm1.static.flickr.com/52/buddyicons/88876166%40N00.jpg"><img src="http://www.peanutfreeplanet.com/v/vspfiles/photos/HomeFreeOatmealCookies-0.gif"><img src="http://www.instructables.com/files/deriv/F9P/HL0V/C8LEWH1IWZM/F9PHL0VC8LEWH1IWZM.TINY.jpg"><img src="http://www.peanutfreeplanet.com/v/vspfiles/photos/HomeFreeOrganicCChipCookies-0.gif"><img src="http://img.amazon.ca/images/I/51LKzjFp7WL._SL75_PIsitb-sticker-arrow-st,TopRight,8,-14_OU15_SS50_.jpg"><img src="http://cdn.cloudfiles.mosso.com/c28492/321251-1243940713.gif"><img src="http://www.iconarchive.com/icons/fasticon/coffee-break/cookies-48x48.png"><img src="http://brh.numbera.com/experiments/images/icons/pixel-cookies-48.jpg"><img src="http://www.rjjulia.com/media/catalog/product/cache/1/thumbnail//50x/c/o/cookies.jpg"><img src="http://www.kevinmccaughey.com/wp-content/uploads/fortune-cookie.jpg"><img src="http://farm1.static.flickr.com/232/buddyicons/8207661%40N06.jpg"><img src="http://www.softlist.net/images/icons/expired_cookies_cleaner_network___internet_browser_tools-8179.gif"><img src="http://forums.superantispyware.com/download/file.php%3Favatar%3D3913_1235515286.jpg">

data/examples/web.rb

@@ -0,0 +1,28 @@
+
+$:.unshift File.dirname(__FILE__) + '/../lib'
+require 'rubygems'
+require 'google-search'
+
+def find_item uri, query
+  search = Google::Search::Web.new do |search|
+    search.query = query
+    search.size = :large
+    search.each_response { print '.'; $stdout.flush }
+  end
+  search.find { |item| item.uri =~ uri }
+end
+
+def rank_for query
+  print "%35s " % query
+  if item = find_item(/vision\-media\.ca/, query)
+    puts " #%d" % (item.index + 1)
+  else
+    puts " Not found"
+  end
+end
+
+rank_for 'Victoria Web Training'
+rank_for 'Victoria Web School'
+rank_for 'Victoria Web Design'
+rank_for 'Victoria Drupal'
+rank_for 'Victoria Drupal Development'

data/google-search.gemspec

@@ -0,0 +1,33 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{google-search}
+  s.version = "1.0.2"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
+  s.authors = ["TJ Holowaychuk"]
+  s.date = %q{2009-07-30}
+  s.description = %q{Google Search API}
+  s.email = %q{tj@vision-media.ca}
+  s.extra_rdoc_files = ["lib/google-search/item/base.rb", "lib/google-search/item/blog.rb", "lib/google-search/item/book.rb", "lib/google-search/item/image.rb", "lib/google-search/item/local.rb", "lib/google-search/item/news.rb", "lib/google-search/item/patent.rb", "lib/google-search/item/video.rb", "lib/google-search/item/web.rb", "lib/google-search/item.rb", "lib/google-search/response.rb", "lib/google-search/search/base.rb", "lib/google-search/search/blog.rb", "lib/google-search/search/book.rb", "lib/google-search/search/image.rb", "lib/google-search/search/local.rb", "lib/google-search/search/mixins/filter.rb", "lib/google-search/search/mixins/order_by.rb", "lib/google-search/search/mixins/safety_level.rb", "lib/google-search/search/mixins.rb", "lib/google-search/search/news.rb", "lib/google-search/search/patent.rb", "lib/google-search/search/video.rb", "lib/google-search/search/web.rb", "lib/google-search/search.rb", "lib/google-search/version.rb", "lib/google-search.rb", "README.rdoc", "tasks/docs.rake", "tasks/gemspec.rake", "tasks/spec.rake"]
+  s.files = ["examples/image.rb", "examples/images.html", "examples/web.rb", "google-search.gemspec", "History.rdoc", "lib/google-search/item/base.rb", "lib/google-search/item/blog.rb", "lib/google-search/item/book.rb", "lib/google-search/item/image.rb", "lib/google-search/item/local.rb", "lib/google-search/item/news.rb", "lib/google-search/item/patent.rb", "lib/google-search/item/video.rb", "lib/google-search/item/web.rb", "lib/google-search/item.rb", "lib/google-search/response.rb", "lib/google-search/search/base.rb", "lib/google-search/search/blog.rb", "lib/google-search/search/book.rb", "lib/google-search/search/image.rb", "lib/google-search/search/local.rb", "lib/google-search/search/mixins/filter.rb", "lib/google-search/search/mixins/order_by.rb", "lib/google-search/search/mixins/safety_level.rb", "lib/google-search/search/mixins.rb", "lib/google-search/search/news.rb", "lib/google-search/search/patent.rb", "lib/google-search/search/video.rb", "lib/google-search/search/web.rb", "lib/google-search/search.rb", "lib/google-search/version.rb", "lib/google-search.rb", "Manifest", "Rakefile", "README.rdoc", "spec/fixtures/400-response.json", "spec/fixtures/blog-response.json", "spec/fixtures/book-response.json", "spec/fixtures/image-response.json", "spec/fixtures/invalid-response.json", "spec/fixtures/local-response.json", "spec/fixtures/news-response.json", "spec/fixtures/patent-response.json", "spec/fixtures/video-response.json", "spec/fixtures/web-2-response.json", "spec/fixtures/web-response.json", "spec/item_blog_spec.rb", "spec/item_book_spec.rb", "spec/item_image_spec.rb", "spec/item_local_spec.rb", "spec/item_news_spec.rb", "spec/item_patent_spec.rb", "spec/item_spec.rb", "spec/item_video_spec.rb", "spec/item_web_spec.rb", "spec/response_spec.rb", "spec/search_blog_spec.rb", "spec/search_book_spec.rb", "spec/search_image_spec.rb", "spec/search_local_spec.rb", "spec/search_news_spec.rb", "spec/search_patent_spec.rb", "spec/search_spec.rb", "spec/search_video_spec.rb", "spec/search_web_spec.rb", "spec/spec.opts", "spec/spec_helper.rb", "tasks/docs.rake", "tasks/gemspec.rake", "tasks/spec.rake"]
+  s.homepage = %q{http://github.com/visionmedia/google-search}
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Google-search", "--main", "README.rdoc"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{google-search}
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{Google Search API}
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<json>, [">= 0"])
+    else
+      s.add_dependency(%q<json>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<json>, [">= 0"])
+  end
+end

data/lib/google-search.rb

@@ -0,0 +1,29 @@
+#--
+# Copyright (c) 2009 2009 TJ Holowaychuk <tj@vision-media.ca>
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+#++
+
+require 'json'
+require 'open-uri'
+require 'google-search/version'
+require 'google-search/item'
+require 'google-search/response'
+require 'google-search/search'

data/lib/google-search/item.rb

@@ -0,0 +1,10 @@
+
+require 'google-search/item/base'
+require 'google-search/item/web'
+require 'google-search/item/blog'
+require 'google-search/item/book'
+require 'google-search/item/image'
+require 'google-search/item/local'
+require 'google-search/item/news'
+require 'google-search/item/video'
+require 'google-search/item/patent'

data/lib/google-search/item/base.rb

@@ -0,0 +1,78 @@
+
+module Google
+  class Search
+    class Item
+      
+      ##
+      # Index.
+      
+      attr_reader :index
+      
+      ##
+      # Unformatted page title.
+      
+      attr_reader :title
+      
+      ##
+      # Absolute uri.
+      
+      attr_reader :uri
+      
+      ##
+      # Visible uri.
+      
+      attr_reader :visible_uri
+      
+      ##
+      # Thumbnail uri.
+      
+      attr_reader :thumbnail_uri
+      
+      ##
+      # Thumbnail width in pixels.
+      
+      attr_reader :thumbnail_width
+      
+      ##
+      # Thumbnail height in pixels.
+      
+      attr_reader :thumbnail_height
+      
+      ##
+      # Contents.
+      
+      attr_reader :content
+      
+      ##
+      # Initialize with _hash_.
+
+      def initialize hash
+        @index = hash['index']
+        @title = hash['titleNoFormatting'] || hash['title']
+        @uri = hash['unescapedUrl'] || hash['url'] || hash['postUrl']
+        @content = hash['contentNoFormatting'] || hash['content']
+        @thumbnail_uri = hash['tbUrl']
+        @thumbnail_width = hash['tbWidth'].to_i
+        @thumbnail_height = hash['tbHeight'].to_i
+        @visible_uri = hash['visibleUrl']
+      end
+      
+      ##
+      # Return class for _google_class_ string formatted
+      # as 'GwebSearch', 'GbookSearch', etc.
+      
+      def self.class_for google_class
+        case google_class
+        when 'GwebSearch'    ; Web
+        when 'GlocalSearch'  ; Local
+        when 'GbookSearch'   ; Book
+        when 'GimageSearch'  ; Image
+        when 'GvideoSearch'  ; Video
+        when 'GpatentSearch' ; Patent
+        when 'GnewsSearch'   ; News
+        when 'GblogSearch'   ; Blog
+        end
+      end
+    end
+  end
+end

data/lib/google-search/item/blog.rb

@@ -0,0 +1,34 @@
+
+module Google
+  class Search
+    class Item
+      class Blog < self
+        
+        ##
+        # Blog base uri.
+        
+        attr_reader :blog_uri
+        
+        ##
+        # Author name.
+        
+        attr_reader :author
+        
+        ##
+        # Published DateTime.
+        
+        attr_reader :published
+        
+        ##
+        # Initialize with _hash_.
+
+        def initialize hash
+          super
+          @author = hash['author']
+          @blog_uri = hash['blogUrl']
+          @published = DateTime.parse hash['publishedDate']
+        end
+      end
+    end
+  end
+end

data/lib/google-search/item/book.rb

@@ -0,0 +1,40 @@
+
+module Google
+  class Search
+    class Item
+      class Book < self
+        
+        ##
+        # Book id.
+        
+        attr_reader :id
+        
+        ##
+        # Author name(s).
+        
+        attr_reader :author
+        
+        ##
+        # Published year.
+        
+        attr_reader :published_year
+        
+        ##
+        # Page count.
+        
+        attr_reader :pages
+        
+        ##
+        # Initialize with _hash_.
+
+        def initialize hash
+          super
+          @author = hash['authors']
+          @published_year = hash['publishedYear'].to_i
+          @id = hash['bookId']
+          @pages = hash['pageCount'].to_i
+        end
+      end
+    end
+  end
+end