lemboy-google-api-client 0.9.26

data/samples/cli/Gemfile

@@ -0,0 +1,7 @@
+source 'https://rubygems.org'
+
+gem 'google-api-client', '~> 0.9'
+gem 'thor', '~> 0.19'
+gem 'os', '~> 0.9'
+gem 'rmail', '~> 1.1'
+gem 'dotenv'

data/samples/cli/README.md

@@ -0,0 +1,51 @@
+# API Samples
+
+This directory contains a small but growing collection of samples for various
+APIs. Each sample can be run on the command line from the `google-api-samples`
+script.
+
+Contributions of new samples are welcome.
+
+# Setup
+
+Depending on which particular samples you want to run, different
+steps may be required. Some samples, like Pub/Sub, require a service account,
+others like Drive, Calendar, and YouTube require an OAuth Client ID. And in
+some cases like Translate, only an API key is needed.
+
+* Create a project at https://console.developers.google.com
+* Go to the `API Manager` and enable the APIs you'd like to try
+* Go to `Credentials` and create the appropriate type of credential for the sample
+    * For keys, use 'Server key' as the type
+    * For OAuth Client IDs, use 'Other' as the type
+    * For service accounts, use the 'JSON' key type
+
+Additional details on how to enable APIs and create credentials can be
+found in the help guide in the console.
+
+
+## Example Environment Settings
+
+For convenience, application credentials can be read from the shell environment
+or placed in a .env file.
+
+After setup, your .env file might look something like:
+
+```
+GOOGLE_API_KEY=AIzaSyC6GvjvPlEzJpTW2bW2t0MPHXXXXXXXXXX
+GOOGLE_CLIENT_ID=479164972499-i7j6av7bp2s4on5ltb7pjXXXXXXXXXX.apps.googleusercontent.com
+GOOGLE_CLIENT_SECRET=JBotCTG5biFWGzXXXXXXXXXX
+GOOGLE_APPLICATION_CREDENTIALS=~/ruby-samples-cred.json
+```
+
+# Running the samples
+
+To list the available sample modules, run the script:
+```
+google-api-samples
+```
+
+To get help on a specific set of samples, run:
+```
+google-api-samples help <module>
+```

data/samples/cli/google-api-samples

@@ -0,0 +1,32 @@
+#!/usr/bin/env ruby
+
+$:.unshift(File.expand_path("../lib", __FILE__))
+
+require 'thor'
+require 'dotenv'
+
+
+# Small script to allow executing samples from the command line.
+# Each sample is loaded as a subcommand.
+#
+# Example usage:
+#
+#     google-api-samples drive upload myfile.txt
+#
+#
+class App < Thor
+
+  # Load all the samples and register them as subcommands
+  Dir.glob('./lib/samples/*.rb').each do |file|
+    require file
+  end
+
+  Samples.constants.each do |const|
+    desc const.downcase, "#{const} samples"
+    subcommand const.downcase, Samples.const_get(const)
+  end
+
+end
+
+Dotenv.load
+App.start(ARGV)

data/samples/cli/lib/base_cli.rb

@@ -0,0 +1,95 @@
+# 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 'googleauth'
+require 'googleauth/stores/file_token_store'
+require 'fileutils'
+require 'thor'
+require 'os'
+
+# Base command line module for samples. Provides authorization support,
+# either using application default credentials or user authorization
+# depending on the use case.
+class BaseCli < Thor
+  include Thor::Actions
+
+  OOB_URI = 'urn:ietf:wg:oauth:2.0:oob'
+
+  class_option :user, :type => :string
+  class_option :api_key, :type => :string
+
+  no_commands do
+
+    # Returns the path to the client_secrets.json file.
+    def client_secrets_path
+      return ENV['GOOGLE_CLIENT_SECRETS'] if ENV.has_key?('GOOGLE_CLIENT_SECRETS')
+      return well_known_path_for('client_secrets.json')
+    end
+
+    # Returns the path to the token store.
+    def token_store_path
+      return ENV['GOOGLE_CREDENTIAL_STORE'] if ENV.has_key?('GOOGLE_CREDENTIAL_STORE')
+      return well_known_path_for('credentials.yaml')
+    end
+
+    # Builds a path to a file in $HOME/.config/google (or %APPDATA%/google,
+    # on Windows)
+    def well_known_path_for(file)
+      if OS.windows?
+        dir = ENV.fetch('HOME'){ ENV['APPDATA']}
+        File.join(dir, 'google', file)
+      else
+        File.join(ENV['HOME'], '.config', 'google', file)
+      end
+    end
+
+    # Returns application credentials for the given scope.
+    def application_credentials_for(scope)
+      Google::Auth.get_application_default(scope)
+    end
+
+    # Returns user credentials for the given scope. Requests authorization
+    # if requrired.
+    def user_credentials_for(scope)
+      FileUtils.mkdir_p(File.dirname(token_store_path))
+
+      if ENV['GOOGLE_CLIENT_ID']
+        client_id = Google::Auth::ClientId.new(ENV['GOOGLE_CLIENT_ID'], ENV['GOOGLE_CLIENT_SECRET'])
+      else
+        client_id = Google::Auth::ClientId.from_file(client_secrets_path)
+      end
+      token_store = Google::Auth::Stores::FileTokenStore.new(:file => token_store_path)
+      authorizer = Google::Auth::UserAuthorizer.new(client_id, scope, token_store)
+
+      user_id = options[:user] || 'default'
+
+      credentials = authorizer.get_credentials(user_id)
+      if credentials.nil?
+        url = authorizer.get_authorization_url(base_url: OOB_URI)
+        say "Open the following URL in your browser and authorize the application."
+        say url
+        code = ask "Enter the authorization code:"
+        credentials = authorizer.get_and_store_credentials_from_code(
+          user_id: user_id, code: code, base_url: OOB_URI)
+      end
+      credentials
+    end
+
+    # Gets the API key of the client
+    def api_key
+      ENV['GOOGLE_API_KEY'] || options[:api_key]
+    end
+
+  end
+end

data/samples/cli/lib/samples/analytics.rb

@@ -0,0 +1,62 @@
+# 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/analytics_v3'
+require 'base_cli'
+
+module Samples
+  # Examples for the Google Analytics APIs
+  #
+  # Sample usage session:
+  #
+  #     $ ./google-api-samples analytics show_visits 55622900 --start='2015-12-01' --end='2015-12-08'
+  #     ga:date   ga:sessions  ga:users  ga:newUsers  ga:percentNewSessions  ga:sessionDuration  ga:avgSessionDuration
+  #     20151201  0            0         0            0.0                    0.0                 0.0
+  #     20151202  0            0         0            0.0                    0.0                 0.0
+  #     20151203  1            1         1            100.0                  0.0                 0.0
+  #     20151204  2            2         1            50.0                   616.0               308.0
+  #     20151205  0            0         0            0.0                    0.0                 0.0
+  #     20151206  1            1         1            100.0                  0.0                 0.0
+  #     20151207  0            0         0            0.0                    0.0                 0.0
+  #     20151208  2            2         1            50.0                   0.0                 0.0
+  #
+  class Analytics < BaseCli
+    Analytics = Google::Apis::AnalyticsV3
+
+    desc 'show_visits PROFILE_ID', 'Show visists for the given analytics profile ID'
+    method_option :start, type: :string, required: true
+    method_option :end, type: :string, required: true
+    def show_visits(profile_id)
+      analytics = Analytics::AnalyticsService.new
+      analytics.authorization = user_credentials_for(Analytics::AUTH_ANALYTICS)
+
+      dimensions = %w(ga:date)
+      metrics = %w(ga:sessions ga:users ga:newUsers ga:percentNewSessions
+                   ga:sessionDuration ga:avgSessionDuration)
+      sort = %w(ga:date)
+      result = analytics.get_ga_data("ga:#{profile_id}",
+                                     options[:start],
+                                     options[:end],
+                                     metrics.join(','),
+                                     dimensions: dimensions.join(','),
+                                     sort: sort.join(','))
+
+      data = []
+      data.push(result.column_headers.map { |h| h.name })
+      data.push(*result.rows)
+      print_table(data)
+    end
+
+  end
+end

data/samples/cli/lib/samples/androidpublisher.rb

@@ -0,0 +1,47 @@
+# 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/androidpublisher_v2'
+require 'base_cli'
+
+
+module Samples
+  # Examples for the Google Play Developer API
+  #
+  # Sample usage:
+  #
+  #     $ ./google-api-samples androidpublisher upload --apk-path /path/to/com.spiffygame.apk --package-name com.spiffygame
+  class Androidpublisher < BaseCli
+    Androidpublisher = Google::Apis::AndroidpublisherV2
+
+    desc 'upload', 'Upload an apk to Google Play'
+    method_option :apk_path, type: :string
+    method_option :package_name, type: :string
+    def upload_apk
+      android_publisher = Androidpublisher::AndroidPublisherService.new
+      android_publisher.authorization = user_credentials_for(Androidpublisher::AUTH_ANDROIDPUBLISHER)
+
+      apk_path = options[:apk_path]
+      package_name = options[:package_name]
+
+      edit = android_publisher.insert_edit(package_name)
+      apk = android_publisher.upload_apk(package_name, edit.id, upload_source: apk_path)
+      android_publisher.update_track(package_name, edit.id, :production,
+        Androidpublisher::Track.new(track: "production", version_codes: [apk.version_code]))
+      android_publisher.commit_edit(package_name, edit.id)
+
+      say "Upload complete"
+    end
+  end
+end

data/samples/cli/lib/samples/bigquery.rb

@@ -0,0 +1,101 @@
+# 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/bigquery_v2'
+require 'base_cli'
+
+
+module Samples
+  # Examples for the Google BigQuery API
+  #
+  # Sample usage:
+  #
+  #     $ ./google-api-samples bigquery list_datasets --project_id=publicdata
+  #     $ ./google-api-samples bigquery list_tables --project_id=publicdata --dataset_id=samples
+  #     $ ./google-api-samples bigquery list_table_data --project_id=publicdata --dataset_id=samples --table_id=wikipedia --max_results=10
+  class Bigquery < BaseCli
+    Bigquery = Google::Apis::BigqueryV2
+
+    desc 'list datasets', 'List datasets'
+    method_option :project_id, type: :string
+    def list_datasets
+      bigquery = Bigquery::BigqueryService.new
+      bigquery.authorization = user_credentials_for(Bigquery::AUTH_BIGQUERY)
+
+      begin
+        project_id = options[:project_id] || 'publicdata'
+        result = bigquery.list_datasets(project_id)
+        data = []
+        data << ['id','kind']
+        result.datasets.each do |dataset|
+          data << [
+            dataset.id,
+            dataset.kind,
+          ]
+        end
+        print_table(data)
+      end
+    end
+
+    desc 'list tables', 'List tables'
+    method_option :project_id, type: :string
+    method_option :dataset_id, type: :string
+    def list_tables
+      bigquery = Bigquery::BigqueryService.new
+      bigquery.authorization = user_credentials_for(Bigquery::AUTH_BIGQUERY)
+
+      begin
+        project_id = options[:project_id] || 'publicdata'
+        dataset_id = options[:dataset_id] || 'samples'
+        result = bigquery.list_tables(project_id, dataset_id)
+        data = []
+        data << ['id','kind']
+        result.tables.each do |table|
+          data << [
+            table.id,
+            table.kind,
+          ]
+        end
+        print_table(data)
+      end
+    end
+
+    desc 'list table data', 'List table data'
+    method_option :project_id, type: :string
+    method_option :dataset_id, type: :string
+    method_option :table_id, type: :string
+    def list_table_data
+      bigquery = Bigquery::BigqueryService.new
+      bigquery.authorization = user_credentials_for(Bigquery::AUTH_BIGQUERY)
+
+      begin
+        project_id = options[:project_id] || 'publicdata'
+        dataset_id = options[:dataset_id] || 'samples'
+        table_id = options[:table_id] || 'wikipedia'
+        max_results = options[:max_results] || 10
+        result = bigquery.list_table_data(project_id, dataset_id, table_id, max_results: max_results)
+
+        datas = []
+        result.rows.each do |row|
+          data = []
+          row.f.each do |field|
+            data << field.v
+          end
+          datas << data
+        end
+        print_table(datas)
+      end
+    end
+  end
+end

data/samples/cli/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[:attendees]).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