google-api-client 0.9.8 → 0.9.20

data/generated/google/apis/youtube_v3/service.rb

@@ -2776,6 +2776,16 @@ module Google
         #   The id parameter specifies the YouTube playlist item ID for the playlist item
         #   that is being deleted. In a playlistItem resource, the id property specifies
         #   the playlist item's ID.
+        # @param [String] on_behalf_of_content_owner
+        #   Note: This parameter is intended exclusively for YouTube content partners.
+        #   The onBehalfOfContentOwner parameter indicates that the request's
+        #   authorization credentials identify a YouTube CMS user who is acting on behalf
+        #   of the content owner specified in the parameter value. This parameter is
+        #   intended for YouTube content partners that own and manage many different
+        #   YouTube channels. It allows content owners to authenticate once and get access
+        #   to all their video and channel data, without having to provide authentication
+        #   credentials for each individual channel. The CMS account that the user
+        #   authenticates with must be linked to the specified YouTube content owner.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -2797,9 +2807,10 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def delete_playlist_item(id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+        def delete_playlist_item(id, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
           command =  make_simple_command(:delete, 'playlistItems', options)
           command.query['id'] = id unless id.nil?
+          command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
           command.query['userIp'] = user_ip unless user_ip.nil?
@@ -2952,6 +2963,16 @@ module Google
         #   specify values, the existing start and end times will be removed and replaced
         #   with the default settings.
         # @param [Google::Apis::YoutubeV3::PlaylistItem] playlist_item_object
+        # @param [String] on_behalf_of_content_owner
+        #   Note: This parameter is intended exclusively for YouTube content partners.
+        #   The onBehalfOfContentOwner parameter indicates that the request's
+        #   authorization credentials identify a YouTube CMS user who is acting on behalf
+        #   of the content owner specified in the parameter value. This parameter is
+        #   intended for YouTube content partners that own and manage many different
+        #   YouTube channels. It allows content owners to authenticate once and get access
+        #   to all their video and channel data, without having to provide authentication
+        #   credentials for each individual channel. The CMS account that the user
+        #   authenticates with must be linked to the specified YouTube content owner.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -2973,12 +2994,13 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def update_playlist_item(part, playlist_item_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+        def update_playlist_item(part, playlist_item_object = nil, on_behalf_of_content_owner: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
           command =  make_simple_command(:put, 'playlistItems', options)
           command.request_representation = Google::Apis::YoutubeV3::PlaylistItem::Representation
           command.request_object = playlist_item_object
           command.response_representation = Google::Apis::YoutubeV3::PlaylistItem::Representation
           command.response_class = Google::Apis::YoutubeV3::PlaylistItem
+          command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.nil?
           command.query['part'] = part unless part.nil?
           command.query['fields'] = fields unless fields.nil?
           command.query['quotaUser'] = quota_user unless quota_user.nil?
@@ -3622,9 +3644,12 @@ module Google
         # @param [Boolean] mine
         #   Set this parameter's value to true to retrieve a feed of the authenticated
         #   user's subscriptions.
+        # @param [Boolean] my_recent_subscribers
+        #   Set this parameter's value to true to retrieve a feed of the subscribers of
+        #   the authenticated user in reverse chronological order (newest first).
         # @param [Boolean] my_subscribers
         #   Set this parameter's value to true to retrieve a feed of the subscribers of
-        #   the authenticated user.
+        #   the authenticated user in no particular order.
         # @param [String] on_behalf_of_content_owner
         #   Note: This parameter is intended exclusively for YouTube content partners.
         #   The onBehalfOfContentOwner parameter indicates that the request's
@@ -3679,7 +3704,7 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def list_subscriptions(part, channel_id: nil, for_channel_id: nil, id: nil, max_results: nil, mine: nil, my_subscribers: nil, on_behalf_of_content_owner: nil, on_behalf_of_content_owner_channel: nil, order: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+        def list_subscriptions(part, channel_id: nil, for_channel_id: nil, id: nil, max_results: nil, mine: nil, my_recent_subscribers: nil, my_subscribers: nil, on_behalf_of_content_owner: nil, on_behalf_of_content_owner_channel: nil, order: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
           command =  make_simple_command(:get, 'subscriptions', options)
           command.response_representation = Google::Apis::YoutubeV3::ListSubscriptionResponse::Representation
           command.response_class = Google::Apis::YoutubeV3::ListSubscriptionResponse
@@ -3688,6 +3713,7 @@ module Google
           command.query['id'] = id unless id.nil?
           command.query['maxResults'] = max_results unless max_results.nil?
           command.query['mine'] = mine unless mine.nil?
+          command.query['myRecentSubscribers'] = my_recent_subscribers unless my_recent_subscribers.nil?
           command.query['mySubscribers'] = my_subscribers unless my_subscribers.nil?
           command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.nil?
           command.query['onBehalfOfContentOwnerChannel'] = on_behalf_of_content_owner_channel unless on_behalf_of_content_owner_channel.nil?
@@ -4065,12 +4091,20 @@ module Google
         #   property specifies the video's ID.
         # @param [String] locale
         #   DEPRECATED
+        # @param [Fixnum] max_height
+        #   The maxHeight parameter specifies a maximum height of the embedded player. If
+        #   maxWidth is provided, maxHeight may not be reached in order to not violate the
+        #   width request.
         # @param [Fixnum] max_results
         #   The maxResults parameter specifies the maximum number of items that should be
         #   returned in the result set.
         #   Note: This parameter is supported for use in conjunction with the myRating
         #   parameter, but it is not supported for use in conjunction with the id
         #   parameter.
+        # @param [Fixnum] max_width
+        #   The maxWidth parameter specifies a maximum width of the embedded player. If
+        #   maxHeight is provided, maxWidth may not be reached in order to not violate the
+        #   height request.
         # @param [String] my_rating
         #   Set this parameter's value to like or dislike to instruct the API to only
         #   return videos liked or disliked by the authenticated user.
@@ -4121,7 +4155,7 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def list_videos(part, chart: nil, hl: nil, id: nil, locale: nil, max_results: nil, my_rating: nil, on_behalf_of_content_owner: nil, page_token: nil, region_code: nil, video_category_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+        def list_videos(part, chart: nil, hl: nil, id: nil, locale: nil, max_height: nil, max_results: nil, max_width: nil, my_rating: nil, on_behalf_of_content_owner: nil, page_token: nil, region_code: nil, video_category_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
           command =  make_simple_command(:get, 'videos', options)
           command.response_representation = Google::Apis::YoutubeV3::ListVideosResponse::Representation
           command.response_class = Google::Apis::YoutubeV3::ListVideosResponse
@@ -4129,7 +4163,9 @@ module Google
           command.query['hl'] = hl unless hl.nil?
           command.query['id'] = id unless id.nil?
           command.query['locale'] = locale unless locale.nil?
+          command.query['maxHeight'] = max_height unless max_height.nil?
           command.query['maxResults'] = max_results unless max_results.nil?
+          command.query['maxWidth'] = max_width unless max_width.nil?
           command.query['myRating'] = my_rating unless my_rating.nil?
           command.query['onBehalfOfContentOwner'] = on_behalf_of_content_owner unless on_behalf_of_content_owner.nil?
           command.query['pageToken'] = page_token unless page_token.nil?

data/generated/google/apis/youtubereporting_v1.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://developers.google.com/youtube/reporting/v1/reports/
     module YoutubereportingV1
       VERSION = 'V1'
-      REVISION = '20160517'
+      REVISION = '20160719'
 
       # View monetary and non-monetary YouTube Analytics reports for your YouTube content
       AUTH_YT_ANALYTICS_MONETARY_READONLY = 'https://www.googleapis.com/auth/yt-analytics-monetary.readonly'

data/google-api-client.gemspec

@@ -26,7 +26,8 @@ Gem::Specification.new do |spec|
   spec.add_runtime_dependency 'mime-types', '>= 1.6'
   spec.add_runtime_dependency 'hurley', '~> 0.1'
   spec.add_runtime_dependency 'googleauth', '~> 0.5'
-  spec.add_runtime_dependency 'thor', '~> 0.19'
   spec.add_runtime_dependency 'httpclient', '~> 2.7'
   spec.add_runtime_dependency 'memoist', '~> 0.11'
+
+  spec.add_development_dependency 'thor', '~> 0.19'
 end

data/lib/google/apis/core/api_command.rb

@@ -105,6 +105,10 @@ module Google
           end
         end
 
+        def allow_form_encoding?
+          request_representation.nil? && super
+        end
+
         private
 
         # Attempt to parse a JSON error message, returning the first found error

data/lib/google/apis/core/base_service.rb

@@ -63,10 +63,16 @@ module Google
           item_count = 0
           loop do
             @last_result = @fetch_proc.call(page_token)
-            for item in @last_result.send(@items_field)
-              item_count = item_count + 1
-              break if @max && item_count > @max
-              yield item
+            items = @last_result.send(@items_field)
+            if items.kind_of?(Array)
+              for item in items
+                item_count = item_count + 1
+                break if @max && item_count > @max
+                yield item
+              end
+            elsif items
+              # yield singular non-nil items (for genomics API)
+              yield items
             end
             break if @max && item_count >= @max
             break if @last_result.next_page_token.nil? || @last_result.next_page_token == page_token

data/lib/google/apis/core/download.rb

@@ -23,6 +23,7 @@ module Google
       # Streaming/resumable media download support
       class DownloadCommand < ApiCommand
         RANGE_HEADER = 'range'
+        OK_STATUS = [200, 201, 206]
 
         # File or IO to write content to
         # @return [String, File, #write]
@@ -65,7 +66,7 @@ module Google
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
         def execute_once(client, &block)
-          client.get(@download_url || url) do |req|
+          response = client.get(@download_url || url) do |req|
             apply_request_options(req)
             check_if_rewind_needed = false
             if @offset > 0
@@ -73,7 +74,7 @@ module Google
               req.header[RANGE_HEADER] = sprintf('bytes=%d-', @offset)
               check_if_rewind_needed = true
             end
-            req.on_body(200, 201, 206) do |res, chunk|
+            req.on_body(*OK_STATUS) do |res, chunk|
               check_status(res.status_code, chunk) unless res.status_code.nil?
               if check_if_rewind_needed && res.status_code != 206
                 # Oh no! Requested a chunk, but received the entire content
@@ -88,6 +89,10 @@ module Google
               @download_io.flush
             end
           end
+
+          # Since the on_body block only runs on success, check status again just in case it failed
+          check_status(response.status_code, response.body) unless OK_STATUS.include?(response.status_code.to_i)
+
           if @close_io_on_finish
             result = nil
           else

data/lib/google/apis/core/http_command.rb

@@ -146,7 +146,7 @@ module Google
           self.url = url.expand(params) if url.is_a?(Addressable::Template)
           url.query_values = query.merge(url.query_values || {})
 
-          if [:post, :put].include?(method)  && body.nil?
+          if allow_form_encoding?
             @form_encoded = true
             self.body = Addressable::URI.form_encode(url.query_values(Array))
             self.header['Content-Type'] = 'application/x-www-form-urlencoded; charset=UTF-8'
@@ -306,6 +306,10 @@ module Google
           req.options.open_timeout = options.open_timeout_sec
         end
 
+        def allow_form_encoding?
+          [:post, :put].include?(method) && body.nil?
+        end
+
         private
 
         def form_encoded?

data/lib/google/apis/core/upload.rb

@@ -17,8 +17,14 @@ require 'google/apis/core/http_command'
 require 'google/apis/core/api_command'
 require 'google/apis/errors'
 require 'addressable/uri'
-require 'mime-types'
 require 'tempfile'
+begin
+  require 'mime/types/columnar'
+rescue LoadError
+  # Temporary until next major bump when we can tighten
+  # dependency to mime-types >-=3.0
+  require 'mime-types'
+end
 
 module Google
   module Apis

data/lib/google/apis/errors.rb

@@ -19,7 +19,7 @@ module Google
       attr_reader :status_code
       attr_reader :header
       attr_reader :body
-      
+
       def initialize(err, status_code: nil, header: nil, body: nil)
         @cause = nil
 
@@ -42,7 +42,7 @@ module Google
         end
       end
     end
-    
+
     # An error which is raised when there is an unexpected response or other
     # transport error that prevents an operation from succeeding.
     class TransmissionError < Error

data/lib/google/apis/generator/annotator.rb

@@ -25,12 +25,18 @@ require 'addressable/uri'
 
 module Google
   module Apis
+
     # @private
     class Generator
+
       # Helper for picking names for methods, properties, types, etc. Performs various normaliations
       # as well as allows for overriding individual names from a configuration file for cases
       # where algorithmic approaches produce poor APIs.
       class Names
+        ActiveSupport::Inflector.inflections do |inflections|
+          u = inflections.uncountable('send_as', 'as')
+        end
+
         include Google::Apis::Core::Logging
         include NameHelpers
 

data/lib/google/apis/version.rb

@@ -15,7 +15,7 @@
 module Google
   module Apis
     # Client library version
-    VERSION = '0.9.8'
+    VERSION = '0.9.20'
 
     # Current operating system
     # @private

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/sheets.rb

@@ -0,0 +1,61 @@
+# 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/sheets_v4'
+require 'base_cli'
+
+
+module Samples
+  # Examples for the Google Sheets API
+  #
+  # Sample usage:
+  #
+  #     $ ./google-api-samples sheets get_values --spreadsheet_key='1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms' --range='Class Data!A1:F'
+  #
+  #     Student Name  Gender  Class Level   Home State  Major    Extracurricular Activity
+  #     Alexandra     Female  4. Senior     CA          English  Drama Club
+  #     Andrew        Male    1. Freshman   SD          Math     Lacrosse
+  #     Anna          Female  1. Freshman   NC          English  Basketball
+  #     Becky         Female  2. Sophomore  SD          Art      Baseball
+  #     Benjamin      Male    4. Senior     WI          English  Basketball
+  #     Carl          Male    3. Junior     MD          Art      Debate
+  #     Carrie        Female  3. Junior     NE          English  Track & Field
+  #     Dorothy       Female  4. Senior     MD          Math     Lacrosse
+  #     Dylan         Male    1. Freshman   MA          Math     Baseball
+  #     Edward        Male    3. Junior     FL          English  Drama Club
+  #     Ellen         Female  1. Freshman   WI          Physics  Drama Club
+  #     Fiona         Female  1. Freshman   MA          Art      Debate
+  #     John          Male    3. Junior     CA          Physics  Basketball
+  #     Jonathan      Male    2. Sophomore  SC          Math     Debate
+  class Sheets < BaseCli
+    Sheets = Google::Apis::SheetsV4
+
+    desc 'get_values', 'Get values from Google Spreadseets '
+    method_option :spreadsheet_key, type: :string, required: true
+    method_option :range, type: :string, required: true
+    def get_values
+      sheets = Sheets::SheetsService.new
+      sheets.authorization = user_credentials_for(Sheets::AUTH_SPREADSHEETS_READONLY)
+      result = sheets.get_spreadsheet_values(options[:spreadsheet_key], options[:range])
+      data = []
+      rows = result.values.length
+      rows.times.each do |row|
+        data.push(result.values[row])
+      end
+      print_table(data)
+    end
+
+    default_task :get_values
+  end
+end