google-api-client 0.46.1 → 0.50.0

data/Gemfile

@@ -23,6 +23,7 @@ group :development do
   gem 'logging', '~> 2.2'
   gem 'opencensus', '~> 0.4'
   gem 'httparty'
+  gem 'gems', '~> 1.2'
 end
 
 platforms :jruby do

data/Rakefile

@@ -79,10 +79,28 @@ namespace :kokoro do
   end
 
   task :release do
-    # Until code generation process is updated and release-please is set up, just publish docs
-    require_relative "rakelib/devsite/devsite_builder.rb"
+    Rake::Task["kokoro:publish_gem"].invoke
+    Rake::Task["kokoro:publish_docs"].invoke
+  end
+
+  task :publish_gem do
+    require "gems"
+
+    load_env_vars if ENV["KOKORO_GFILE_DIR"]
+    api_token = ENV["RUBYGEMS_API_TOKEN"]
+    if api_token
+      ::Gems.configure do |config|
+        config.key = api_token
+      end
+    end
+
+    rm_rf "pkg"
+    Rake::Task["build"].invoke
+    built_gem_path = Dir.glob("pkg/google-api-client-*.gem").last
 
-    DevsiteBuilder.new.publish_if_missing ENV["DOCS_BUILD_TAG"]
+    response = ::Gems.push File.new built_gem_path
+    puts response
+    raise "Failed to release gem" unless response.include? "Successfully registered gem:"
   end
 
   desc "Publish docs for the latest git tag"
@@ -93,6 +111,16 @@ namespace :kokoro do
   end
 end
 
+def load_env_vars
+  service_account = "#{ENV['KOKORO_GFILE_DIR']}/service-account.json"
+  raise "#{service_account} is not a file" unless File.file? service_account
+  ENV["GOOGLE_APPLICATION_CREDENTIALS"] = service_account
+  filename = "#{ENV['KOKORO_GFILE_DIR']}/ruby_env_vars.json"
+  raise "#{filename} is not a file" unless File.file? filename
+  env_vars = JSON.parse File.read(filename)
+  env_vars.each { |k, v| ENV[k] ||= v }
+end
+
 def header str, token = "#"
   line_length = str.length + 8
   puts

data/api_list_config.yaml

@@ -1 +1,9 @@
+include:
+  - name: appsmarket
+    version: v2
+    discovery_rest_url: https://content.googleapis.com/discovery/v1/apis/appsmarket/v2/rest
+  - name: youtubePartner
+    version: v1
+    discovery_rest_url: https://content.googleapis.com/discovery/v1/apis/youtubePartner/v1/rest
 exclude: []
+pause: []

data/bin/generate-api

@@ -28,32 +28,34 @@ module Google
 
     desc 'gen OUTDIR', 'Generate ruby API from an API description'
     method_options url: :array, file: :array, from_discovery: :boolean, preferred_only: :boolean,
-                   verbose: :boolean, names: :string, names_out: :string
+                   verbose: :boolean, names: :string, names_out: :string, api: :string, clean: :boolean
     def gen(dir)
       ensure_active_support
       require 'google/apis/generator'
 
       self.destination_root = dir
       Google::Apis.logger.level = Logger::DEBUG if options[:verbose]
-      generate_from_url(options[:url]) if options[:url]
-      generate_from_file(options[:file]) if options[:file]
-      generate_from_discovery(preferred_only: options[:preferred_only]) if options[:from_discovery]
-      create_file(options[:names_out]) { |*| generator.dump_api_names } if options[:names_out]
+      count = 0
+      count += generate_from_url(options[:url]) if options[:url]
+      count += generate_from_file(options[:file]) if options[:file]
+      count += generate_specific_apis(options[:api]) if options[:api]
+      count += generate_from_discovery(preferred_only: options[:preferred_only]) if options[:from_discovery]
+      count += clean_from_discovery if options[:clean]
+      create_file(options[:names_out]) { |*| generator.dump_api_names } if count > 0 && options[:names_out]
     end
 
     desc 'list', 'List public APIs'
     method_options verbose: :boolean, preferred_only: :boolean
     def list
       Google::Apis.logger.level = Logger::DEBUG if options[:verbose]
-      discovery = Discovery::DiscoveryService.new
-      apis = discovery.list_apis
-      apis.items.each do |api|
+      discovery_api_list.each do |api|
         say sprintf('%s - %s', api.id, api.description).strip unless options[:preferred_only] && !api.preferred?
       end
     end
 
     no_commands do
-      def generate_from_url(urls)
+      def generate_from_url(urls, first_only: false)
+        count = 0
         Array(urls).each do |url|
           begin
             json = discovery.http(:get, url)
@@ -62,7 +64,10 @@ module Google
             next
           end
           generate_api(json)
+          return 1 if first_only
+          count += 1
         end
+        count
       end
 
       def generate_from_file(files)
@@ -71,15 +76,38 @@ module Google
             generate_api(f.read)
           end
         end
+        Array(files).size
+      end
+
+      def generate_specific_apis(apis)
+        discovery_apis = discovery_api_list.each_with_object({}) do |api, hash|
+          hash["#{api.name}.#{api.version}"] = api
+        end
+        paused_apis = Array(api_list_config["pause"])
+        count = 0
+        Array(apis).each do |name_version|
+          api = discovery_apis[name_version]
+          if api.nil?
+            say "API #{api} is not in the discovery list."
+          elsif paused_apis.include? name_version
+            say "Ignoring paused API #{api.name} #{api.version}"
+          else
+            discovery_rest_url = "https://raw.githubusercontent.com/googleapis/discovery-artifact-manager/master/discoveries/#{api.name}.#{api.version}.json"
+            say sprintf('Loading %s, version %s from %s', api.name, api.version, discovery_rest_url)
+            generate_from_url([discovery_rest_url, api.discovery_rest_url], first_only: true)
+            count += 1
+          end
+        end
+        count
       end
 
       def generate_from_discovery(preferred_only: false)
         say 'Fetching API list'
-        apis = discovery.list_apis
-        exclude_apis = api_list_config["exclude"] || []
-        apis.items.each do |api|
-          if exclude_apis.include? "#{api.name}.#{api.version}"
-            say "Ignoring excluded API #{api.name} #{api.version}"
+        paused_apis = Array(api_list_config["pause"])
+        count = 0
+        discovery_api_list.each do |api|
+          if paused_apis.include? "#{api.name}.#{api.version}"
+            say "Ignoring paused API #{api.name} #{api.version}"
           elsif (preferred_only && !api.preferred?)
             say sprintf('Ignoring disoverable API %s', api.id)
           else
@@ -91,9 +119,27 @@ module Google
 	    # by the Discovery index.
             discovery_rest_url = "https://raw.githubusercontent.com/googleapis/discovery-artifact-manager/master/discoveries/#{api.name}.#{api.version}.json"
             say sprintf('Loading %s, version %s from %s', api.name, api.version, discovery_rest_url)
-            generate_from_url(discovery_rest_url)
+            generate_from_url([discovery_rest_url, api.discovery_rest_url], first_only: true)
+            count += 1
           end
         end
+        count
+      end
+
+      def clean_from_discovery
+        count = 0
+        apis = discovery_api_list.map { |api| "#{api.name.underscore}_#{api.version.tr '.', '_'}" }
+        Dir.chdir("#{destination_root}/google/apis") do
+          Dir.glob("*.rb").each do |filename|
+            filename = File.basename(filename, ".rb")
+            unless apis.include? filename
+              FileUtils.rm_r filename
+              FileUtils.rm "#{filename}.rb"
+              count += 1
+            end
+          end
+        end
+        count
       end
 
       def generate_api(json)
@@ -107,6 +153,20 @@ module Google
         @discovery ||= Discovery::DiscoveryService.new
       end
 
+      def discovery_api_list
+        @discovery_api_list ||= begin
+          items = discovery.list_apis.items
+          excluded = Array(api_list_config["exclude"])
+          items.delete_if { |item| excluded.include? "#{item.name}.#{item.version}" }
+          Array(api_list_config["include"]).each do |include_hash|
+            include_hash.symbolize_keys!
+            include_item = Discovery::DirectoryList::Item.new(**include_hash)
+            items << include_item unless items.any? { |item| item.name == include_item.name && item.version == include_item.version }
+          end
+          items
+        end
+      end
+
       def generator
         @generator ||= Google::Apis::Generator.new(api_names: options[:names], api_names_out: options[:names_out])
       end
@@ -117,7 +177,9 @@ module Google
 
       def ensure_active_support
         begin
+          require 'active_support'
           require 'active_support/inflector'
+          require 'active_support/core_ext'
         rescue LoadError => e
           error 'ActiveSupport is required, please run:'
           error 'gem install activesupport'

data/generated/google/apis/accessapproval_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/access-approval/docs
     module AccessapprovalV1
       VERSION = 'V1'
-      REVISION = '20200930'
+      REVISION = '20201030'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

data/generated/google/apis/accessapproval_v1/classes.rb

@@ -317,21 +317,19 @@ module Google
         include Google::Apis::Core::Hashable
       
         # The product for which Access Approval will be enrolled. Allowed values are
-        # listed below (case-sensitive): * all * GA * App Engine * BigQuery * Cloud
-        # Bigtable * Cloud Key Management Service * Compute Engine * Cloud Dataflow *
-        # Cloud Identity and Access Management * Cloud Pub/Sub * Cloud Storage *
-        # Persistent Disk Note: These values are supported as input for legacy purposes,
-        # but will not be returned from the API. * all * ga-only * appengine.googleapis.
-        # com * bigquery.googleapis.com * bigtable.googleapis.com * cloudkms.googleapis.
-        # com * compute.googleapis.com * dataflow.googleapis.com * iam.googleapis.com *
-        # pubsub.googleapis.com * storage.googleapis.com Calls to
-        # UpdateAccessApprovalSettings using 'all', 'ga-only', or any of the XXX.
-        # googleapis.com will be translated to the associated product name ('all', 'GA',
-        # 'App Engine', etc.). Note: 'all' will enroll the resource in all products
-        # supported at both 'GA' and 'Preview' levels. 'ga-only'/'GA' will only enroll
-        # the resource in products supported at 'GA' level. More information about
-        # levels of support is available at https://cloud.google.com/access-approval/
-        # docs/supported-services
+        # listed below (case-sensitive): * all * App Engine * BigQuery * Cloud Bigtable *
+        # Cloud Key Management Service * Compute Engine * Cloud Dataflow * Cloud
+        # Identity and Access Management * Cloud Pub/Sub * Cloud Storage * Persistent
+        # Disk Note: These values are supported as input for legacy purposes, but will
+        # not be returned from the API. * all * appengine.googleapis.com * bigquery.
+        # googleapis.com * bigtable.googleapis.com * cloudkms.googleapis.com * compute.
+        # googleapis.com * dataflow.googleapis.com * iam.googleapis.com * pubsub.
+        # googleapis.com * storage.googleapis.com Calls to UpdateAccessApprovalSettings
+        # using 'all' or any of the XXX.googleapis.com will be translated to the
+        # associated product name ('all', 'App Engine', etc.). Note: 'all' will enroll
+        # the resource in all products supported at both 'GA' and 'Preview' levels. More
+        # information about levels of support is available at https://cloud.google.com/
+        # access-approval/docs/supported-services
         # Corresponds to the JSON property `cloudProduct`
         # @return [String]
         attr_accessor :cloud_product

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

@@ -268,9 +268,10 @@ module Google
         #   A filter on the type of approval requests to retrieve. Must be one of the
         #   following values: * [not set]: Requests that are pending or have active
         #   approvals. * ALL: All requests. * PENDING: Only pending requests. * ACTIVE:
-        #   Only active (i.e. currently approved) requests. * DISMISSED: Only dismissed (
-        #   including expired) requests. * HISTORY: Active and dismissed (including
-        #   expired) requests.
+        #   Only active (i.e. currently approved) requests. * DISMISSED: Only requests
+        #   that have been dismissed, or requests that . are not approved and past
+        #   expiration. * EXPIRED: Only requests that have been approved, and the approval
+        #   has expired. * HISTORY: Active, dismissed and expired requests.
         # @param [Fixnum] page_size
         #   Requested page size.
         # @param [String] page_token
@@ -526,9 +527,10 @@ module Google
         #   A filter on the type of approval requests to retrieve. Must be one of the
         #   following values: * [not set]: Requests that are pending or have active
         #   approvals. * ALL: All requests. * PENDING: Only pending requests. * ACTIVE:
-        #   Only active (i.e. currently approved) requests. * DISMISSED: Only dismissed (
-        #   including expired) requests. * HISTORY: Active and dismissed (including
-        #   expired) requests.
+        #   Only active (i.e. currently approved) requests. * DISMISSED: Only requests
+        #   that have been dismissed, or requests that . are not approved and past
+        #   expiration. * EXPIRED: Only requests that have been approved, and the approval
+        #   has expired. * HISTORY: Active, dismissed and expired requests.
         # @param [Fixnum] page_size
         #   Requested page size.
         # @param [String] page_token
@@ -784,9 +786,10 @@ module Google
         #   A filter on the type of approval requests to retrieve. Must be one of the
         #   following values: * [not set]: Requests that are pending or have active
         #   approvals. * ALL: All requests. * PENDING: Only pending requests. * ACTIVE:
-        #   Only active (i.e. currently approved) requests. * DISMISSED: Only dismissed (
-        #   including expired) requests. * HISTORY: Active and dismissed (including
-        #   expired) requests.
+        #   Only active (i.e. currently approved) requests. * DISMISSED: Only requests
+        #   that have been dismissed, or requests that . are not approved and past
+        #   expiration. * EXPIRED: Only requests that have been approved, and the approval
+        #   has expired. * HISTORY: Active, dismissed and expired requests.
         # @param [Fixnum] page_size
         #   Requested page size.
         # @param [String] page_token

data/generated/google/apis/adexchangebuyer2_v2beta1.rb

@@ -27,7 +27,7 @@ module Google
     # @see https://developers.google.com/authorized-buyers/apis/reference/rest/
     module Adexchangebuyer2V2beta1
       VERSION = 'V2beta1'
-      REVISION = '20200822'
+      REVISION = '20201013'
 
       # Manage your Ad Exchange buyer account configuration
       AUTH_ADEXCHANGE_BUYER = 'https://www.googleapis.com/auth/adexchange.buyer'

data/generated/google/apis/adexchangebuyer2_v2beta1/classes.rb

@@ -29,26 +29,26 @@ module Google
       class AbsoluteDateRange
         include Google::Apis::Core::Hashable
       
-        # Represents a whole or partial calendar date, e.g. a birthday. The time of day
-        # and time zone are either specified elsewhere or are not significant. The date
-        # is relative to the Proleptic Gregorian Calendar. This can represent: * A full
-        # date, with non-zero year, month and day values * A month and day value, with a
-        # zero year, e.g. an anniversary * A year on its own, with zero month and day
-        # values * A year and month value, with a zero day, e.g. a credit card
-        # expiration date Related types are google.type.TimeOfDay and `google.protobuf.
-        # Timestamp`.
+        # Represents a whole or partial calendar date, such as a birthday. The time of
+        # day and time zone are either specified elsewhere or are insignificant. The
+        # date is relative to the Gregorian Calendar. This can represent one of the
+        # following: * A full date, with non-zero year, month, and day values * A month
+        # and day value, with a zero year, such as an anniversary * A year on its own,
+        # with zero month and day values * A year and month value, with a zero day, such
+        # as a credit card expiration date Related types are google.type.TimeOfDay and `
+        # google.protobuf.Timestamp`.
         # Corresponds to the JSON property `endDate`
         # @return [Google::Apis::Adexchangebuyer2V2beta1::Date]
         attr_accessor :end_date
       
-        # Represents a whole or partial calendar date, e.g. a birthday. The time of day
-        # and time zone are either specified elsewhere or are not significant. The date
-        # is relative to the Proleptic Gregorian Calendar. This can represent: * A full
-        # date, with non-zero year, month and day values * A month and day value, with a
-        # zero year, e.g. an anniversary * A year on its own, with zero month and day
-        # values * A year and month value, with a zero day, e.g. a credit card
-        # expiration date Related types are google.type.TimeOfDay and `google.protobuf.
-        # Timestamp`.
+        # Represents a whole or partial calendar date, such as a birthday. The time of
+        # day and time zone are either specified elsewhere or are insignificant. The
+        # date is relative to the Gregorian Calendar. This can represent one of the
+        # following: * A full date, with non-zero year, month, and day values * A month
+        # and day value, with a zero year, such as an anniversary * A year on its own,
+        # with zero month and day values * A year and month value, with a zero day, such
+        # as a credit card expiration date Related types are google.type.TimeOfDay and `
+        # google.protobuf.Timestamp`.
         # Corresponds to the JSON property `startDate`
         # @return [Google::Apis::Adexchangebuyer2V2beta1::Date]
         attr_accessor :start_date
@@ -1047,31 +1047,31 @@ module Google
         end
       end
       
-      # Represents a whole or partial calendar date, e.g. a birthday. The time of day
-      # and time zone are either specified elsewhere or are not significant. The date
-      # is relative to the Proleptic Gregorian Calendar. This can represent: * A full
-      # date, with non-zero year, month and day values * A month and day value, with a
-      # zero year, e.g. an anniversary * A year on its own, with zero month and day
-      # values * A year and month value, with a zero day, e.g. a credit card
-      # expiration date Related types are google.type.TimeOfDay and `google.protobuf.
-      # Timestamp`.
+      # Represents a whole or partial calendar date, such as a birthday. The time of
+      # day and time zone are either specified elsewhere or are insignificant. The
+      # date is relative to the Gregorian Calendar. This can represent one of the
+      # following: * A full date, with non-zero year, month, and day values * A month
+      # and day value, with a zero year, such as an anniversary * A year on its own,
+      # with zero month and day values * A year and month value, with a zero day, such
+      # as a credit card expiration date Related types are google.type.TimeOfDay and `
+      # google.protobuf.Timestamp`.
       class Date
         include Google::Apis::Core::Hashable
       
-        # Day of month. Must be from 1 to 31 and valid for the year and month, or 0 if
-        # specifying a year by itself or a year and month where the day is not
-        # significant.
+        # Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to
+        # specify a year by itself or a year and month where the day isn't significant.
         # Corresponds to the JSON property `day`
         # @return [Fixnum]
         attr_accessor :day
       
-        # Month of year. Must be from 1 to 12, or 0 if specifying a year without a month
+        # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month
         # and day.
         # Corresponds to the JSON property `month`
         # @return [Fixnum]
         attr_accessor :month
       
-        # Year of date. Must be from 1 to 9999, or 0 if specifying a date without a year.
+        # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a
+        # year.
         # Corresponds to the JSON property `year`
         # @return [Fixnum]
         attr_accessor :year
@@ -2669,7 +2669,7 @@ module Google
       class Money
         include Google::Apis::Core::Hashable
       
-        # The 3-letter currency code defined in ISO 4217.
+        # The three-letter currency code defined in ISO 4217.
         # Corresponds to the JSON property `currencyCode`
         # @return [String]
         attr_accessor :currency_code

data/generated/google/apis/admin_directory_v1.rb

@@ -27,7 +27,7 @@ module Google
     # @see http://developers.google.com/admin-sdk/
     module AdminDirectoryV1
       VERSION = 'DirectoryV1'
-      REVISION = '20200909'
+      REVISION = '20201013'
 
       # View and manage customer related information
       AUTH_ADMIN_DIRECTORY_CUSTOMER = 'https://www.googleapis.com/auth/admin.directory.customer'

data/generated/google/apis/admin_directory_v1/classes.rb

@@ -1367,6 +1367,141 @@ module Google
         end
       end
       
+      # Information regarding a command that was issued to a device.
+      class DirectoryChromeosdevicesCommand
+        include Google::Apis::Core::Hashable
+      
+        # The time at which the command will expire. If the device doesn't execute the
+        # command within this time the command will become expired.
+        # Corresponds to the JSON property `commandExpireTime`
+        # @return [String]
+        attr_accessor :command_expire_time
+      
+        # Unique ID of a device command.
+        # Corresponds to the JSON property `commandId`
+        # @return [Fixnum]
+        attr_accessor :command_id
+      
+        # The result of executing a command.
+        # Corresponds to the JSON property `commandResult`
+        # @return [Google::Apis::AdminDirectoryV1::DirectoryChromeosdevicesCommandResult]
+        attr_accessor :command_result
+      
+        # The timestamp when the command was issued by the admin.
+        # Corresponds to the JSON property `issueTime`
+        # @return [String]
+        attr_accessor :issue_time
+      
+        # The payload that the command specified, if any.
+        # Corresponds to the JSON property `payload`
+        # @return [String]
+        attr_accessor :payload
+      
+        # Indicates the command state.
+        # Corresponds to the JSON property `state`
+        # @return [String]
+        attr_accessor :state
+      
+        # The type of the command.
+        # Corresponds to the JSON property `type`
+        # @return [String]
+        attr_accessor :type
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @command_expire_time = args[:command_expire_time] if args.key?(:command_expire_time)
+          @command_id = args[:command_id] if args.key?(:command_id)
+          @command_result = args[:command_result] if args.key?(:command_result)
+          @issue_time = args[:issue_time] if args.key?(:issue_time)
+          @payload = args[:payload] if args.key?(:payload)
+          @state = args[:state] if args.key?(:state)
+          @type = args[:type] if args.key?(:type)
+        end
+      end
+      
+      # The result of executing a command.
+      class DirectoryChromeosdevicesCommandResult
+        include Google::Apis::Core::Hashable
+      
+        # The error message with a short explanation as to why the command failed. Only
+        # present if the command failed.
+        # Corresponds to the JSON property `errorMessage`
+        # @return [String]
+        attr_accessor :error_message
+      
+        # The time at which the command was executed or failed to execute.
+        # Corresponds to the JSON property `executeTime`
+        # @return [String]
+        attr_accessor :execute_time
+      
+        # The result of the command.
+        # Corresponds to the JSON property `result`
+        # @return [String]
+        attr_accessor :result
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @error_message = args[:error_message] if args.key?(:error_message)
+          @execute_time = args[:execute_time] if args.key?(:execute_time)
+          @result = args[:result] if args.key?(:result)
+        end
+      end
+      
+      # A request for issuing a command.
+      class DirectoryChromeosdevicesIssueCommandRequest
+        include Google::Apis::Core::Hashable
+      
+        # The type of command.
+        # Corresponds to the JSON property `commandType`
+        # @return [String]
+        attr_accessor :command_type
+      
+        # The payload for the command, provide it only if command supports it. The
+        # following commands support adding payload: - SET_VOLUME: Payload is a JSON
+        # object in the form: ` "volume": 50 `. The volume has to be an integer in the
+        # range [0,100].
+        # Corresponds to the JSON property `payload`
+        # @return [String]
+        attr_accessor :payload
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @command_type = args[:command_type] if args.key?(:command_type)
+          @payload = args[:payload] if args.key?(:payload)
+        end
+      end
+      
+      # A response for issuing a command.
+      class DirectoryChromeosdevicesIssueCommandResponse
+        include Google::Apis::Core::Hashable
+      
+        # The unique ID of the issued command, used to retrieve the command status.
+        # Corresponds to the JSON property `commandId`
+        # @return [Fixnum]
+        attr_accessor :command_id
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @command_id = args[:command_id] if args.key?(:command_id)
+        end
+      end
+      
       # 
       class DomainAlias
         include Google::Apis::Core::Hashable