gdata_19 1.1.2

data/gdata19.gemspec

@@ -0,0 +1,294 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{gdata19}
+  s.version = "1.1.2"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Jeff Fisher"]
+  s.date = %q{2010-09-02}
+  s.default_executable = %q{test_captcha.rb}
+  s.description = %q{This gem provides a set of wrappers designed to make it easy to work with 
+    the Google Data APIs with 1.9 compat}
+  s.email = %q{jfisher@youtube.com}
+  s.executables = ["test_captcha.rb"]
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README"
+  ]
+  s.files = [
+    ".hgtags",
+     "LICENSE",
+     "README",
+     "Rakefile",
+     "VERSION",
+     "bin/test_captcha.rb",
+     "doc/classes/GData.html",
+     "doc/classes/GData/Auth.html",
+     "doc/classes/GData/Auth/AuthSub.html",
+     "doc/classes/GData/Auth/AuthSub.src/M000020.html",
+     "doc/classes/GData/Auth/AuthSub.src/M000021.html",
+     "doc/classes/GData/Auth/AuthSub.src/M000022.html",
+     "doc/classes/GData/Auth/AuthSub.src/M000023.html",
+     "doc/classes/GData/Auth/AuthSub.src/M000024.html",
+     "doc/classes/GData/Auth/AuthSub.src/M000025.html",
+     "doc/classes/GData/Auth/AuthSub.src/M000026.html",
+     "doc/classes/GData/Auth/AuthSub.src/M000038.html",
+     "doc/classes/GData/Auth/AuthSub.src/M000039.html",
+     "doc/classes/GData/Auth/AuthSub.src/M000040.html",
+     "doc/classes/GData/Auth/AuthSub.src/M000041.html",
+     "doc/classes/GData/Auth/AuthSub.src/M000042.html",
+     "doc/classes/GData/Auth/AuthSub.src/M000043.html",
+     "doc/classes/GData/Auth/AuthSub.src/M000044.html",
+     "doc/classes/GData/Auth/AuthSub.src/M000045.html",
+     "doc/classes/GData/Auth/AuthSub.src/M000046.html",
+     "doc/classes/GData/Auth/AuthSub.src/M000047.html",
+     "doc/classes/GData/Auth/AuthSub.src/M000048.html",
+     "doc/classes/GData/Auth/AuthSub.src/M000049.html",
+     "doc/classes/GData/Auth/AuthSub.src/M000050.html",
+     "doc/classes/GData/Auth/AuthSub.src/M000051.html",
+     "doc/classes/GData/Auth/AuthSub.src/M000052.html",
+     "doc/classes/GData/Auth/AuthSub.src/M000053.html",
+     "doc/classes/GData/Auth/ClientLogin.html",
+     "doc/classes/GData/Auth/ClientLogin.src/M000027.html",
+     "doc/classes/GData/Auth/ClientLogin.src/M000028.html",
+     "doc/classes/GData/Auth/ClientLogin.src/M000029.html",
+     "doc/classes/GData/Auth/ClientLogin.src/M000045.html",
+     "doc/classes/GData/Auth/ClientLogin.src/M000046.html",
+     "doc/classes/GData/Auth/ClientLogin.src/M000047.html",
+     "doc/classes/GData/Auth/ClientLogin.src/M000050.html",
+     "doc/classes/GData/Auth/ClientLogin.src/M000051.html",
+     "doc/classes/GData/Auth/ClientLogin.src/M000052.html",
+     "doc/classes/GData/Auth/ClientLogin.src/M000053.html",
+     "doc/classes/GData/Auth/ClientLogin.src/M000054.html",
+     "doc/classes/GData/Auth/ClientLogin.src/M000055.html",
+     "doc/classes/GData/Auth/ClientLogin.src/M000056.html",
+     "doc/classes/GData/Client.html",
+     "doc/classes/GData/Client/Apps.html",
+     "doc/classes/GData/Client/Apps.src/M000027.html",
+     "doc/classes/GData/Client/Apps.src/M000028.html",
+     "doc/classes/GData/Client/AuthorizationError.html",
+     "doc/classes/GData/Client/BadRequestError.html",
+     "doc/classes/GData/Client/Base.html",
+     "doc/classes/GData/Client/Base.src/M000002.html",
+     "doc/classes/GData/Client/Base.src/M000003.html",
+     "doc/classes/GData/Client/Base.src/M000004.html",
+     "doc/classes/GData/Client/Base.src/M000005.html",
+     "doc/classes/GData/Client/Base.src/M000006.html",
+     "doc/classes/GData/Client/Base.src/M000007.html",
+     "doc/classes/GData/Client/Base.src/M000008.html",
+     "doc/classes/GData/Client/Base.src/M000009.html",
+     "doc/classes/GData/Client/Base.src/M000010.html",
+     "doc/classes/GData/Client/Base.src/M000011.html",
+     "doc/classes/GData/Client/Base.src/M000012.html",
+     "doc/classes/GData/Client/Base.src/M000013.html",
+     "doc/classes/GData/Client/Base.src/M000014.html",
+     "doc/classes/GData/Client/Base.src/M000015.html",
+     "doc/classes/GData/Client/Base.src/M000016.html",
+     "doc/classes/GData/Client/Base.src/M000017.html",
+     "doc/classes/GData/Client/Base.src/M000018.html",
+     "doc/classes/GData/Client/Base.src/M000019.html",
+     "doc/classes/GData/Client/Base.src/M000020.html",
+     "doc/classes/GData/Client/Base.src/M000021.html",
+     "doc/classes/GData/Client/Base.src/M000022.html",
+     "doc/classes/GData/Client/Base.src/M000023.html",
+     "doc/classes/GData/Client/Base.src/M000024.html",
+     "doc/classes/GData/Client/Base.src/M000025.html",
+     "doc/classes/GData/Client/Blogger.html",
+     "doc/classes/GData/Client/Blogger.src/M000002.html",
+     "doc/classes/GData/Client/BookSearch.html",
+     "doc/classes/GData/Client/BookSearch.src/M000010.html",
+     "doc/classes/GData/Client/BookSearch.src/M000011.html",
+     "doc/classes/GData/Client/Calendar.html",
+     "doc/classes/GData/Client/Calendar.src/M000030.html",
+     "doc/classes/GData/Client/Calendar.src/M000031.html",
+     "doc/classes/GData/Client/Calendar.src/M000032.html",
+     "doc/classes/GData/Client/Calendar.src/M000033.html",
+     "doc/classes/GData/Client/Calendar.src/M000034.html",
+     "doc/classes/GData/Client/CaptchaError.html",
+     "doc/classes/GData/Client/CaptchaError.src/M000001.html",
+     "doc/classes/GData/Client/CaptchaError.src/M000005.html",
+     "doc/classes/GData/Client/Contacts.html",
+     "doc/classes/GData/Client/Contacts.src/M000003.html",
+     "doc/classes/GData/Client/DocList.html",
+     "doc/classes/GData/Client/DocList.src/M000006.html",
+     "doc/classes/GData/Client/DocList.src/M000007.html",
+     "doc/classes/GData/Client/Error.html",
+     "doc/classes/GData/Client/Finance.html",
+     "doc/classes/GData/Client/Finance.src/M000029.html",
+     "doc/classes/GData/Client/Finance.src/M000030.html",
+     "doc/classes/GData/Client/GBase.html",
+     "doc/classes/GData/Client/GBase.src/M000004.html",
+     "doc/classes/GData/Client/GMail.html",
+     "doc/classes/GData/Client/GMail.src/M000028.html",
+     "doc/classes/GData/Client/GMail.src/M000029.html",
+     "doc/classes/GData/Client/Health.html",
+     "doc/classes/GData/Client/Health.src/M000031.html",
+     "doc/classes/GData/Client/Health.src/M000034.html",
+     "doc/classes/GData/Client/Health.src/M000035.html",
+     "doc/classes/GData/Client/Notebook.html",
+     "doc/classes/GData/Client/Notebook.src/M000009.html",
+     "doc/classes/GData/Client/Notebook.src/M000010.html",
+     "doc/classes/GData/Client/Photos.html",
+     "doc/classes/GData/Client/Photos.src/M000008.html",
+     "doc/classes/GData/Client/Photos.src/M000009.html",
+     "doc/classes/GData/Client/RequestError.html",
+     "doc/classes/GData/Client/RequestError.src/M000006.html",
+     "doc/classes/GData/Client/ServerError.html",
+     "doc/classes/GData/Client/Spreadsheets.html",
+     "doc/classes/GData/Client/Spreadsheets.src/M000001.html",
+     "doc/classes/GData/Client/UnknownError.html",
+     "doc/classes/GData/Client/VersionConflictError.html",
+     "doc/classes/GData/Client/WebmasterTools.html",
+     "doc/classes/GData/Client/WebmasterTools.src/M000007.html",
+     "doc/classes/GData/Client/WebmasterTools.src/M000008.html",
+     "doc/classes/GData/Client/YouTube.html",
+     "doc/classes/GData/Client/YouTube.src/M000013.html",
+     "doc/classes/GData/Client/YouTube.src/M000014.html",
+     "doc/classes/GData/Client/YouTube.src/M000025.html",
+     "doc/classes/GData/Client/YouTube.src/M000026.html",
+     "doc/classes/GData/Client/YouTube.src/M000027.html",
+     "doc/classes/GData/HTTP.html",
+     "doc/classes/GData/HTTP/DefaultService.html",
+     "doc/classes/GData/HTTP/DefaultService.src/M000019.html",
+     "doc/classes/GData/HTTP/DefaultService.src/M000037.html",
+     "doc/classes/GData/HTTP/DefaultService.src/M000042.html",
+     "doc/classes/GData/HTTP/DefaultService.src/M000045.html",
+     "doc/classes/GData/HTTP/DefaultService.src/M000046.html",
+     "doc/classes/GData/HTTP/MimeBody.html",
+     "doc/classes/GData/HTTP/MimeBody.src/M000032.html",
+     "doc/classes/GData/HTTP/MimeBody.src/M000033.html",
+     "doc/classes/GData/HTTP/MimeBody.src/M000034.html",
+     "doc/classes/GData/HTTP/MimeBody.src/M000035.html",
+     "doc/classes/GData/HTTP/MimeBody.src/M000036.html",
+     "doc/classes/GData/HTTP/MimeBody.src/M000037.html",
+     "doc/classes/GData/HTTP/MimeBody.src/M000038.html",
+     "doc/classes/GData/HTTP/MimeBodyString.html",
+     "doc/classes/GData/HTTP/MimeBodyString.src/M000036.html",
+     "doc/classes/GData/HTTP/MimeBodyString.src/M000037.html",
+     "doc/classes/GData/HTTP/MimeBodyString.src/M000039.html",
+     "doc/classes/GData/HTTP/MimeBodyString.src/M000040.html",
+     "doc/classes/GData/HTTP/MimeBodyString.src/M000041.html",
+     "doc/classes/GData/HTTP/Request.html",
+     "doc/classes/GData/HTTP/Request.src/M000015.html",
+     "doc/classes/GData/HTTP/Request.src/M000016.html",
+     "doc/classes/GData/HTTP/Request.src/M000017.html",
+     "doc/classes/GData/HTTP/Request.src/M000018.html",
+     "doc/classes/GData/HTTP/Request.src/M000033.html",
+     "doc/classes/GData/HTTP/Request.src/M000034.html",
+     "doc/classes/GData/HTTP/Request.src/M000035.html",
+     "doc/classes/GData/HTTP/Request.src/M000036.html",
+     "doc/classes/GData/HTTP/Request.src/M000038.html",
+     "doc/classes/GData/HTTP/Request.src/M000039.html",
+     "doc/classes/GData/HTTP/Request.src/M000040.html",
+     "doc/classes/GData/HTTP/Request.src/M000041.html",
+     "doc/classes/GData/HTTP/Request.src/M000042.html",
+     "doc/classes/GData/HTTP/Request.src/M000043.html",
+     "doc/classes/GData/HTTP/Request.src/M000044.html",
+     "doc/classes/GData/HTTP/Request.src/M000045.html",
+     "doc/classes/GData/HTTP/Response.html",
+     "doc/classes/GData/HTTP/Response.src/M000032.html",
+     "doc/classes/GData/HTTP/Response.src/M000035.html",
+     "doc/classes/GData/HTTP/Response.src/M000038.html",
+     "doc/classes/GData/HTTP/Response.src/M000039.html",
+     "doc/created.rid",
+     "doc/files/README.html",
+     "doc/files/lib/gdata/auth/authsub_rb.html",
+     "doc/files/lib/gdata/auth/clientlogin_rb.html",
+     "doc/files/lib/gdata/auth_rb.html",
+     "doc/files/lib/gdata/client/apps_rb.html",
+     "doc/files/lib/gdata/client/base_rb.html",
+     "doc/files/lib/gdata/client/blogger_rb.html",
+     "doc/files/lib/gdata/client/booksearch_rb.html",
+     "doc/files/lib/gdata/client/calendar_rb.html",
+     "doc/files/lib/gdata/client/contacts_rb.html",
+     "doc/files/lib/gdata/client/doclist_rb.html",
+     "doc/files/lib/gdata/client/finance_rb.html",
+     "doc/files/lib/gdata/client/gbase_rb.html",
+     "doc/files/lib/gdata/client/gdata_rb.html",
+     "doc/files/lib/gdata/client/gmail_rb.html",
+     "doc/files/lib/gdata/client/health_rb.html",
+     "doc/files/lib/gdata/client/notebook_rb.html",
+     "doc/files/lib/gdata/client/photos_rb.html",
+     "doc/files/lib/gdata/client/spreadsheets_rb.html",
+     "doc/files/lib/gdata/client/webmaster_tools_rb.html",
+     "doc/files/lib/gdata/client/youtube_rb.html",
+     "doc/files/lib/gdata/client_rb.html",
+     "doc/files/lib/gdata/http/default_service_rb.html",
+     "doc/files/lib/gdata/http/mime_body_rb.html",
+     "doc/files/lib/gdata/http/request_rb.html",
+     "doc/files/lib/gdata/http/response_rb.html",
+     "doc/files/lib/gdata/http_rb.html",
+     "doc/files/lib/gdata_rb.html",
+     "doc/fr_class_index.html",
+     "doc/fr_file_index.html",
+     "doc/fr_method_index.html",
+     "doc/index.html",
+     "doc/rdoc-style.css",
+     "gdata19.gemspec",
+     "lib/gdata.rb",
+     "lib/gdata/auth.rb",
+     "lib/gdata/auth/authsub.rb",
+     "lib/gdata/auth/clientlogin.rb",
+     "lib/gdata/client.rb",
+     "lib/gdata/client/apps.rb",
+     "lib/gdata/client/base.rb",
+     "lib/gdata/client/blogger.rb",
+     "lib/gdata/client/booksearch.rb",
+     "lib/gdata/client/calendar.rb",
+     "lib/gdata/client/contacts.rb",
+     "lib/gdata/client/doclist.rb",
+     "lib/gdata/client/finance.rb",
+     "lib/gdata/client/gbase.rb",
+     "lib/gdata/client/gmail.rb",
+     "lib/gdata/client/health.rb",
+     "lib/gdata/client/notebook.rb",
+     "lib/gdata/client/photos.rb",
+     "lib/gdata/client/spreadsheets.rb",
+     "lib/gdata/client/webmaster_tools.rb",
+     "lib/gdata/client/youtube.rb",
+     "lib/gdata/http.rb",
+     "lib/gdata/http/default_service.rb",
+     "lib/gdata/http/mime_body.rb",
+     "lib/gdata/http/request.rb",
+     "lib/gdata/http/response.rb",
+     "pkg/gdata19-1.1.2.gem",
+     "test/tc_gdata_auth_authsub.rb",
+     "test/tc_gdata_auth_clientlogin.rb",
+     "test/tc_gdata_client_base.rb",
+     "test/tc_gdata_client_calendar.rb",
+     "test/tc_gdata_client_photos.rb",
+     "test/tc_gdata_client_youtube.rb",
+     "test/tc_gdata_http_mime_body.rb",
+     "test/tc_gdata_http_request.rb",
+     "test/test_config.yml.example",
+     "test/test_helper.rb",
+     "test/testimage.jpg",
+     "test/ts_gdata.rb",
+     "test/ts_gdata_auth.rb",
+     "test/ts_gdata_client.rb",
+     "test/ts_gdata_http.rb"
+  ]
+  s.homepage = %q{http://github.com/tokumine/GData}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.7}
+  s.summary = %q{Google Data APIs Ruby Utility Library}
+  s.test_files = [
+    "test/ts_gdata.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end
+

data/lib/gdata/auth/authsub.rb

@@ -0,0 +1,162 @@
+# encoding: UTF-8
+# Copyright (C) 2008 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require 'cgi'
+require 'openssl'
+require 'base64'
+
+module GData
+  module Auth
+    
+    # This class implements AuthSub signatures for Data API requests.
+    # It can be used with a GData::Client::GData object.
+    class AuthSub
+      
+      # The URL of AuthSubRequest.
+      REQUEST_HANDLER = 'https://www.google.com/accounts/AuthSubRequest'
+      # The URL of AuthSubSessionToken.
+      SESSION_HANDLER = 'https://www.google.com/accounts/AuthSubSessionToken'
+      # The URL of AuthSubRevokeToken.
+      REVOKE_HANDLER = 'https://www.google.com/accounts/AuthSubRevokeToken'
+      # The URL of AuthSubInfo.
+      INFO_HANDLER =  'https://www.google.com/accounts/AuthSubTokenInfo'
+      # 2 ** 64, the largest 64 bit unsigned integer
+      BIG_INT_MAX = 18446744073709551616
+      
+      # AuthSub access token.
+      attr_accessor :token
+      # Private RSA key used to sign secure requests.
+      attr_reader :private_key
+      
+      # Initialize the class with a new token. Optionally pass a private
+      # key or custom URLs.
+      def initialize(token, options = {})
+        if token.nil?
+          raise ArgumentError, "Token cannot be nil."
+        elsif token.class != String
+          raise ArgumentError, "Token must be a String."
+        end
+        
+        @token = token
+        
+        options.each do |key, value|
+          self.send("#{key}=", value)
+        end
+      end
+      
+      # Set the private key to use with this AuthSub token.
+      # The key can be an OpenSSL::PKey::RSA object, a string containing a
+      # private key in PEM format, or a string specifying a path to a PEM
+      # file that contains the private key.
+      def private_key=(key)
+        begin
+          if key.nil? or key.class == OpenSSL::PKey::RSA
+            @private_key = key
+          elsif File.exists?(key)
+            key_from_file = File.read(key)
+            @private_key = OpenSSL::PKey::RSA.new(key_from_file)
+          else
+            @private_key = OpenSSL::PKey::RSA.new(key)
+          end
+        rescue
+          raise ArgumentError, "Not a valid private key."
+        end
+      end
+      
+      # Sign a GData::Http::Request object with a valid AuthSub Authorization
+      # header.
+      def sign_request!(request)
+        header = "AuthSub token=\"#{@token}\""
+        
+        if @private_key
+          time = Time.now.to_i
+          nonce = OpenSSL::BN.rand_range(BIG_INT_MAX)
+          method = request.method.to_s.upcase
+          data = "#{method} #{request.url} #{time} #{nonce}"
+          sig = @private_key.sign(OpenSSL::Digest::SHA1.new, data)
+          sig = Base64.encode64(sig).gsub(/\n/, '')
+          header = "#{header} sigalg=\"rsa-sha1\" data=\"#{data}\""
+          header = "#{header} sig=\"#{sig}\""
+        end
+        
+        request.headers['Authorization'] = header
+      end
+      
+      # Upgrade the current token into a session token.
+      def upgrade
+        request = GData::HTTP::Request.new(SESSION_HANDLER)
+        sign_request!(request)
+        service = GData::HTTP::DefaultService.new
+        response = service.make_request(request)
+        if response.status_code != 200
+          raise GData::Client::AuthorizationError.new(response)
+        end
+        
+        @token = response.body[/Token=(.*)/,1]
+        return @token
+        
+      end
+      
+      # Return some information about the current token. If the current token
+      # is a one-time use token, this operation will use it up!
+      def info
+        request = GData::HTTP::Request.new(INFO_HANDLER)
+        sign_request!(request)
+        service = GData::HTTP::DefaultService.new
+        response = service.make_request(request)
+        if response.status_code != 200
+          raise GData::Client::AuthorizationError.new(response)
+        end
+        
+        result = {}
+        result[:target] = response.body[/Target=(.*)/,1]
+        result[:scope] = response.body[/Scope=(.*)/,1]
+        result[:secure] = response.body[/Secure=(.*)/,1]
+        return result
+       
+      end
+      
+      # Revoke the token.
+      def revoke
+        request = GData::HTTP::Request.new(REVOKE_HANDLER)
+        sign_request!(request)
+        service = GData::HTTP::DefaultService.new
+        response = service.make_request(request)
+        if response.status_code != 200
+          raise GData::Client::AuthorizationError.new(response)
+        end
+
+      end
+      
+      # Return the proper URL for an AuthSub approval page with the requested
+      # scope. next_url should be a URL that points back to your code that
+      # will receive the token. domain is optionally a Google Apps domain.
+      def self.get_url(next_url, scope, secure = false, session = true, 
+          domain = nil)
+        next_url = CGI.escape(next_url)
+        scope = CGI.escape(scope)
+        secure = secure ? 1 : 0
+        session = session ? 1 : 0
+        body = "next=#{next_url}&scope=#{scope}&session=#{session}" +
+               "&secure=#{secure}"
+        if domain
+          domain = CGI.escape(domain)
+          body = "#{body}&hd=#{domain}"
+        end
+        return "#{REQUEST_HANDLER}?#{body}"
+      end
+    end
+  end
+end

data/lib/gdata/auth/clientlogin.rb

@@ -0,0 +1,103 @@
+# encoding: UTF-8
+# Copyright (C) 2008 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require 'cgi'
+
+module GData
+  module Auth
+    
+    # This class implements ClientLogin signatures for Data API requests.
+    # It can be used with a GData::Client::GData object.
+    class ClientLogin
+      
+      # The ClientLogin authentication handler
+      attr_accessor :auth_url
+      # One of 'HOSTED_OR_GOOGLE', 'GOOGLE', or 'HOSTED'. 
+      # See documentation here: 
+      # http://code.google.com/apis/accounts/docs/AuthForInstalledApps.html
+      attr_accessor :account_type
+      # The access token
+      attr_accessor :token
+      # The service name for the API you are working with
+      attr_accessor :service
+      
+      # Initialize the class with the service name of an API that you wish
+      # to request a token for.
+      def initialize(service, options = {})
+        if service.nil?
+          raise ArgumentError, "Service name cannot be nil"
+        end
+        
+        @service = service
+        
+        options.each do |key, value|
+          self.send("#{key}=", value)
+        end
+        
+        @auth_url ||= 'https://www.google.com/accounts/ClientLogin'
+        @account_type ||= 'HOSTED_OR_GOOGLE'
+      end
+      
+      # Retrieves a token for the given username and password.
+      # source identifies your application.
+      # login_token and login_captcha are used only if you are responding
+      # to a previously issued CAPTCHA challenge.
+      def get_token(username, password, source, login_token = nil, 
+          login_captcha = nil)
+        body = Hash.new
+        body['accountType'] = @account_type
+        body['Email'] = username
+        body['Passwd'] = password
+        body['service'] = @service
+        body['source'] = source
+        if login_token and login_captcha
+          body['logintoken'] = login_token
+          body['logincaptcha'] = login_captcha
+        end
+        
+        request = GData::HTTP::Request.new(@auth_url, :body => body, 
+          :method => :post)
+        service = GData::HTTP::DefaultService.new
+        response = service.make_request(request)
+        if response.status_code != 200
+          url = response.body[/Url=(.*)/,1]
+          error = response.body[/Error=(.*)/,1]
+          
+          if error == "CaptchaRequired"
+            captcha_token = response.body[/CaptchaToken=(.*)/,1]
+            captcha_url = response.body[/CaptchaUrl=(.*)/,1]
+            raise GData::Client::CaptchaError.new(captcha_token, captcha_url), 
+              "#{error} : #{url}"
+          end
+          
+          raise GData::Client::AuthorizationError.new(response)
+        end
+        
+        @token = response.body[/Auth=(.*)/,1]
+        return @token
+      end
+      
+      # Creates an appropriate Authorization header on a GData::HTTP::Request
+      # object.
+      def sign_request!(request)
+        if @token == nil
+          raise GData::Client::Error, "Cannot sign request without credentials"
+        end
+        
+        request.headers['Authorization'] = "GoogleLogin auth=#{@token}" 
+      end
+    end
+  end
+end

data/lib/gdata/auth.rb

@@ -0,0 +1,23 @@
+# encoding: UTF-8
+# Copyright (C) 2008 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+require 'gdata/auth/clientlogin'
+require 'gdata/auth/authsub'
+
+module GData
+  module Auth
+    SOURCE_LIB_STRING = 'GoogleDataRubyUtil-'
+  end
+end

data/lib/gdata/client/apps.rb

@@ -0,0 +1,28 @@
+# encoding: UTF-8
+# Copyright (C) 2008 Google Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+module GData
+  module Client
+    
+    # Client class to wrap working with the Apps Provisioning API.
+    class Apps < Base
+      
+      def initialize(options = {})
+        options[:clientlogin_service] ||= 'apps'
+        super(options)
+      end
+    end
+  end
+end