cirandas.net

ref: master

vendor/gdata/README


= GData

* http://code.google.com/p/gdata

== DESCRIPTION:

Ruby wrapper for working with Google Data APIs

== SYNOPSIS:

  yt = GData::Client::YouTube.new
  yt.source = 'my_cool_application'
  yt.clientlogin('username', 'password')
  yt.client_id = 'CLIENT_ID'
  yt.developer_key = 'DEVELOPER_KEY'
  feed = yt.get('http://gdata.youtube.com/feeds/api/users/default/uploads').to_xml
  
  # creating, updating, and deleting a playlist
  
  entry = <<-EOF
  
    Ruby Utility Unit Test
    This is a test playlist.
  
  EOF
  
  response = yt.post('http://gdata.youtube.com/feeds/api/users/default/playlists', entry).to_xml
  
  edit_uri = response.elements["link[@rel='edit']"].attributes['href']
  
  response.elements["summary"].text = "Updated description"
  
  response = yt.put(edit_uri, response.to_s).to_xml
  
  yt.delete(edit_uri).to_xml
  
  # uploading a video
  
  test_movie = '/path/to/a/movie.mov'
  mime_type = 'video/quicktime'
  feed = 'http://uploads.gdata.youtube.com/feeds/api/users/default/uploads'

  entry = <
    
      Test Movie
      
        This is a test with the Ruby library
      
      People
      
      test,lame
    
  
  EOF
   
  response = @yt.post_file(feed, test_movie, mime_type, entry).to_xml

== REQUIREMENTS:

* A sunny disposition

Tested against Ruby 1.8.6 patch level 114

== INSTALL:

  sudo gem install gdata

To generate documentation:

  rake doc
  
To run unit tests:
  
  cp test/test_config.yml.example test/test_config.yml
  # edit test/test_config.yml
  rake test

== LICENSE:

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.