google-api-client 0.9.pre4 → 0.9.pre5

data/samples/lib/samples/calendar.rb

@@ -0,0 +1,83 @@
+# Copyright 2016 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 'google/apis/calendar_v3'
+require 'base_cli'
+
+
+module Samples
+  # Examples for the Google Calendar API
+  #
+  # Sample usage:
+  #
+  #     $ ./google-api-samples calendar list --limit 10
+  class Calendar < BaseCli
+    Calendar = Google::Apis::CalendarV3
+
+    desc 'schedule', 'Create an event'
+    method_option :summary, type: :string, required: true
+    method_option :start, type: :string, required: true
+    method_option :end , type: :string, required: true
+    method_option :attendees, type: :array
+    def schedule
+      calendar = Calendar::CalendarService.new
+      calendar.authorization = user_credentials_for(Calendar::AUTH_CALENDAR)
+
+      event = {
+        summary: options[:summary],
+        attendees: Array(options[:attenddes]).map { |email| { email: email } },
+        start: {
+          date_time: DateTime.parse(options[:start])
+        },
+        end: {
+          date_time: DateTime.parse(options[:end])
+        }
+      }
+
+      event = calendar.insert_event('primary', event, send_notifications: true)
+      say "Created event '#{event.summary}' (#{event.id})"
+    end
+
+    desc 'list', 'List upcoming events'
+    method_option :limit, type: :numeric
+    def list()
+      calendar = Calendar::CalendarService.new
+      calendar.authorization = user_credentials_for(Calendar::AUTH_CALENDAR)
+
+      page_token = nil
+      limit = options[:limit] || 1000
+      now = Time.now.iso8601
+      begin
+        result = calendar.list_events('primary',
+                                      max_results: [limit, 100].min,
+                                      single_events: true,
+                                      order_by: 'startTime',
+                                      time_min: now,
+                                      page_token: page_token,
+                                      fields: 'items(id,summary,start),next_page_token')
+
+        result.items.each do |event|
+          time = event.start.date_time || event.start.date
+          say "#{time}, #{event.summary}"
+        end
+        limit -= result.items.length
+        if result.next_page_token
+          page_token = result.next_page_token
+        else
+          page_token = nil
+        end
+      end while !page_token.nil? && limit > 0
+    end
+  end
+end

data/samples/lib/samples/drive.rb

@@ -0,0 +1,82 @@
+# Copyright 2016 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 'google/apis/drive_v3'
+require 'base_cli'
+
+
+module Samples
+  # Examples for the Google Drive API
+  #
+  # Sample usage:
+  #
+  #     $ ./google-api-samples drive upload ~/myvideo.mov
+  class Drive < BaseCli
+    Drive = Google::Apis::DriveV3
+
+    desc 'upload FILE', 'Upload a file to Google Drive'
+    method_option :name, type: :string
+    def upload(file)
+      drive = Drive::DriveService.new
+      drive.authorization = user_credentials_for(Drive::AUTH_DRIVE)
+
+      metadata  = {
+        name: options[:name] || file
+      }
+      result = drive.create_file(metadata, upload_source: file)
+      say "Upload complete"
+    end
+
+    desc 'download FILE_ID', 'Download a file from Google Drive'
+    method_option :out, type: :string
+    def download(file_id)
+      drive = Drive::DriveService.new
+      drive.authorization = user_credentials_for(Drive::AUTH_DRIVE)
+
+      dest = options[:out] || StringIO.new
+      drive.get_file(file_id, download_dest: dest)
+
+      if dest.is_a?(StringIO)
+        dest.rewind
+        STDOUT.write(dest.read)
+      else
+        say "File downloaded to #{options[:out]}"
+      end
+    end
+
+    desc 'list QUERY', 'Search for files'
+    method_option :limit, type: :numeric
+    def list(query)
+      drive = Drive::DriveService.new
+      drive.authorization = user_credentials_for(Drive::AUTH_DRIVE)
+
+      page_token = nil
+      limit = options[:limit] || 1000
+      begin
+        result = drive.list_files(q: query,
+                                  page_size: [limit, 100].min,
+                                  page_token: page_token,
+                                  fields: 'files(id,name),next_page_token')
+
+        result.files.each { |file| puts "#{file.id}, #{file.name}" }
+        limit -= result.files.length
+        if result.next_page_token
+          page_token = result.next_page_token
+        else
+          page_token = nil
+        end
+      end while !page_token.nil? && limit > 0
+    end
+  end
+end

data/samples/lib/samples/gmail.rb

@@ -0,0 +1,50 @@
+# Copyright 2016 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 'google/apis/gmail_v1'
+require 'base_cli'
+require 'rmail'
+
+module Samples
+  # Examples for the Gmail API
+  #
+  # Sample usage:
+  #
+  #     $ ./google-api-samples gmail send 'Hello there!' \
+  #       --to='recipient@example.com' --from='user@example.com' \
+  #       --subject='Hello'
+  #
+  class Gmail < BaseCli
+    Gmail = Google::Apis::GmailV1
+
+    desc 'send TEXT', 'Send a message with the gmail API'
+    method_option :to, type: :string, required: true
+    method_option :from, type: :string, required: true
+    method_option :subject, type: :string, required: true
+    def send(body)
+      gmail = Gmail::GmailService.new
+      gmail.authorization = user_credentials_for(Gmail::AUTH_SCOPE)
+
+      message = RMail::Message.new
+      message.header['To'] = options[:to]
+      message.header['From'] = options[:from]
+      message.header['Subject'] = options[:subject]
+      message.body = body
+
+      gmail.send_user_message('me',
+                              upload_source: StringIO.new(message.to_s),
+                              content_type: 'message/rfc822')
+    end
+  end
+end

data/samples/lib/samples/pubsub.rb

@@ -0,0 +1,114 @@
+# Copyright 2016 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 'google/apis/pubsub_v1'
+require 'base_cli'
+
+
+module Samples
+  # Examples for the Google Cloud Pub/Sub API.
+  #
+  # Sample usage session:
+  #
+  #     $ ./google-api-samples pubsub create_topic mytopic --project=623040240964
+  #     # ./google-api-samples pubsub subscribe mysub --topic=mytopic --project=623040240964
+  #     $ ./google-api-samples pubsub publish 'Hello!' --topic=mytopic --project=623040240964
+  #     $ ./google-api-samples pubsub pull mysub --project=623040240964
+  #     Received: Hello!
+  #     $ ./google-api-samples pubsub unsubscribe mysub --project=623040240964
+  #     $ ./google-api-samples pubsub delete_topic mytopic --project=623040240964
+  #
+  class PubSub < BaseCli
+    Pubsub = Google::Apis::PubsubV1
+
+    desc 'create_topic TOPIC_NAME', 'Create a topic'
+    method_option :project, type: :string, required: true
+    def create_topic(name)
+      pubsub = Pubsub::PubsubService.new
+      pubsub.authorization = Google::Auth.get_application_default([Pubsub::AUTH_PUBSUB])
+      topic = "projects/#{options[:project]}/topics/#{name}"
+
+      pubsub.create_topic(topic)
+    end
+
+    desc 'delete_topic TOPIC_NAME', 'Delete a topic'
+    method_option :project, type: :string, required: true
+    def delete_topic(name)
+      pubsub = Pubsub::PubsubService.new
+      pubsub.authorization = Google::Auth.get_application_default([Pubsub::AUTH_PUBSUB])
+
+      topic = "projects/#{options[:project]}/topics/#{name}"
+
+      pubsub.delete_topic(topic)
+    end
+
+    desc 'subscribe SUBSCRIPTION_NAME', 'Subscribe to a topic'
+    method_option :project, type: :string, required: true
+    method_option :topic, type: :string, required: true
+    def subscribe(name)
+      pubsub = Pubsub::PubsubService.new
+      pubsub.authorization = Google::Auth.get_application_default([Pubsub::AUTH_PUBSUB])
+
+      topic = "projects/#{options[:project]}/topics/#{options[:topic]}"
+      subscription = "projects/#{options[:project]}/subscriptions/#{name}"
+      pubsub.create_subscription(subscription, Pubsub::Subscription.new(topic: topic))
+    end
+
+    desc 'unsubscribe subscription_name', 'Ububscribe from a topic'
+    method_option :project, type: :string, required: true
+    def unsubscribe(name)
+      pubsub = Pubsub::PubsubService.new
+      pubsub.authorization = Google::Auth.get_application_default([Pubsub::AUTH_PUBSUB])
+
+      subscription = "projects/#{options[:project]}/subscriptions/#{name}"
+      pubsub.delete_subscription(subscription)
+    end
+
+
+    desc 'publish MESSAGE', 'Publish a message to a topic'
+    method_option :project, type: :string, required: true
+    method_option :topic, type: :string, required: true
+    def publish(message)
+      pubsub = Pubsub::PubsubService.new
+      pubsub.authorization = Google::Auth.get_application_default([Pubsub::AUTH_PUBSUB])
+      topic = "projects/#{options[:project]}/topics/#{options[:topic]}"
+
+      request = Pubsub::PublishRequest.new(messages: [])
+      request.messages << Pubsub::Message.new(data: message)
+
+      pubsub.publish_topic(topic, request)
+    end
+
+    desc 'pull SUBSCRIPTION_NAME', 'Pull message(s) from the topic'
+    method_option :project, type: :string, required: true
+    method_option :max, type: :numeric, default: 5
+    def pull(name)
+      pubsub = Pubsub::PubsubService.new
+      pubsub.authorization = Google::Auth.get_application_default([Pubsub::AUTH_PUBSUB])
+
+      subscription = "projects/#{options[:project]}/subscriptions/#{name}"
+
+      # Pull messages
+      response = pubsub.pull_subscription(subscription, Pubsub::PullRequest.new(max_messages: options[:max]))
+      response.received_messages.each do |received_message|
+        data = received_message.message.data
+        puts "Received: #{data}"
+      end
+
+      # Acknowledge receipt
+      ack_ids = response.received_messages.map{ |msg| msg.ack_id }
+      pubsub.acknowledge_subscription(subscription, Pubsub::AcknowledgeRequest.new(ack_ids: ack_ids))
+    end
+  end
+end

data/samples/lib/samples/translate.rb

@@ -0,0 +1,44 @@
+# Copyright 2016 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 'google/apis/translate_v2'
+require 'base_cli'
+
+
+module Samples
+  # Examples for the Google Translate API
+  #
+  # Sample usage:
+  #
+  #      $ ./google-api-samples translate 'Hola!' --target='en'
+  #      Hello
+  #
+  class Translate < BaseCli
+    Translate = Google::Apis::TranslateV2
+
+    desc 'translate PHRASE', 'Translate a phrase'
+    method_option :source, type: :string
+    method_option :target, type: :string, required: true
+    def translate(phrase)
+      translate = Translate::TranslateService.new
+      translate.key = api_key
+
+      result = translate.list_translations(phrase, options[:target], source: options[:source])
+      puts result.translations.first.translated_text
+    end
+
+    default_task :translate
+
+  end
+end

data/samples/lib/samples/you_tube.rb

@@ -0,0 +1,44 @@
+# Copyright 2016 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 'google/apis/youtube_v3'
+require 'base_cli'
+
+
+module Samples
+  # Examples for the YouTube APIs
+  #
+  # Sample usage:
+  #
+  #     $ ./google-api-samples youtube upload ~/myvideo.mov --title="So funny!"
+  #
+  class YouTube < BaseCli
+    YT = Google::Apis::YoutubeV3
+
+    desc 'upload FILE', 'Upload a video to YouTube'
+    method_option :title, type: :string
+    def upload(file)
+      youtube = YT::YouTubeService.new
+      youtube.authorization = user_credentials_for(YT::AUTH_YOUTUBE)
+
+      metadata  = {
+        snippet: {
+          title: options[:title] || file
+        }
+      }
+      result = youtube.insert_video('snippet', metadata, upload_source: file)
+      say "Upload complete"
+    end
+  end
+end

data/spec/google/apis/core/api_command_spec.rb

@@ -151,6 +151,41 @@ EOF
     end
   end
 
+  context('with a client error response') do
+    let(:command) do
+      Google::Apis::Core::ApiCommand.new(:get, 'https://www.googleapis.com/zoo/animals')
+    end
+
+    before(:example) do
+      json = <<EOF
+{
+ "error": {
+  "errors": [
+   {
+    "domain": "global",
+    "reason": "timeRangeEmpty",
+    "message": "The specified time range is empty."
+   }
+  ],
+  "code": 400,
+  "message": "The specified time range is empty."
+ }
+}
+EOF
+      stub_request(:get, 'https://www.googleapis.com/zoo/animals')
+        .to_return(status: [400, 'Bad Request'], headers: { 'Content-Type' => 'application/json' }, body: json)
+    end
+
+    it 'should raise client error' do
+      expect { command.execute(client) }.to raise_error(Google::Apis::ClientError)
+    end
+
+    it 'should raise an error with the reason and message' do
+      expect { command.execute(client) }.to raise_error(
+        /timeRangeEmpty: The specified time range is empty/)
+    end
+  end
+
   context('with an empty error body') do
     let(:command) do
       Google::Apis::Core::ApiCommand.new(:get, 'https://www.googleapis.com/zoo/animals')
@@ -166,5 +201,9 @@ EOF
     it 'should raise client error' do
       expect { command.execute(client) }.to raise_error(Google::Apis::ClientError)
     end
+
+    it 'should use the default error message' do
+      expect { command.execute(client) }.to raise_error(/Invalid request/)
+    end
   end
 end