google-api-client 0.9.8 → 0.9.20

data/generated/google/apis/sqladmin_v1beta4.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://cloud.google.com/sql/docs/reference/latest
     module SqladminV1beta4
       VERSION = 'V1beta4'
-      REVISION = '20160509'
+      REVISION = '20161028'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -105,6 +105,11 @@ module Google
       class BackupRun
         include Google::Apis::Core::Hashable
       
+        # The description of this run, only applicable to on-demand backups.
+        # Corresponds to the JSON property `description`
+        # @return [String]
+        attr_accessor :description
+      
         # The time the backup operation completed in UTC timezone in RFC 3339 format,
         # for example 2012-11-15T16:19:00.094Z.
         # Corresponds to the JSON property `endTime`
@@ -154,6 +159,11 @@ module Google
         # @return [String]
         attr_accessor :status
       
+        # The type of this run; can be either "AUTOMATED" or "ON_DEMAND".
+        # Corresponds to the JSON property `type`
+        # @return [String]
+        attr_accessor :type
+      
         # The start time of the backup window during which this the backup was attempted
         # in RFC 3339 format, for example 2012-11-15T16:19:00.094Z.
         # Corresponds to the JSON property `windowStartTime`
@@ -166,6 +176,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @description = args[:description] if args.key?(:description)
           @end_time = args[:end_time] if args.key?(:end_time)
           @enqueued_time = args[:enqueued_time] if args.key?(:enqueued_time)
           @error = args[:error] if args.key?(:error)
@@ -175,6 +186,7 @@ module Google
           @self_link = args[:self_link] if args.key?(:self_link)
           @start_time = args[:start_time] if args.key?(:start_time)
           @status = args[:status] if args.key?(:status)
+          @type = args[:type] if args.key?(:type)
           @window_start_time = args[:window_start_time] if args.key?(:window_start_time)
         end
       end
@@ -377,6 +389,11 @@ module Google
         # @return [String]
         attr_accessor :backend_type
       
+        # Connection name of the Cloud SQL instance used in connection strings.
+        # Corresponds to the JSON property `connectionName`
+        # @return [String]
+        attr_accessor :connection_name
+      
         # The current disk usage of the instance in bytes. This property has been
         # deprecated. Users should use the "cloudsql.googleapis.com/database/disk/
         # bytes_used" metric in Cloud Monitoring API instead. Please see https://groups.
@@ -518,6 +535,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @backend_type = args[:backend_type] if args.key?(:backend_type)
+          @connection_name = args[:connection_name] if args.key?(:connection_name)
           @current_disk_size = args[:current_disk_size] if args.key?(:current_disk_size)
           @database_version = args[:database_version] if args.key?(:database_version)
           @etag = args[:etag] if args.key?(:etag)
@@ -555,7 +573,9 @@ module Google
           attr_accessor :available
           alias_method :available?, :available
         
-          # The name of the failover replica.
+          # The name of the failover replica. If specified at instance creation, a
+          # failover replica is created for the instance. The name doesn't include the
+          # project ID. This property is applicable only to Second Generation instances.
           # Corresponds to the JSON property `name`
           # @return [String]
           attr_accessor :name
@@ -1541,13 +1561,17 @@ module Google
       class Settings
         include Google::Apis::Core::Hashable
       
-        # The activation policy for this instance. This specifies when the instance
-        # should be activated and is applicable only when the instance state is RUNNABLE.
-        # This can be one of the following.
-        # ALWAYS: The instance should always be active.
-        # NEVER: The instance should never be activated.
-        # ON_DEMAND: The instance is activated upon receiving requests; only applicable
-        # to First Generation instances.
+        # The activation policy specifies when the instance is activated; it is
+        # applicable only when the instance state is RUNNABLE. The activation policy
+        # cannot be updated together with other settings for Second Generation instances.
+        # Valid values:
+        # ALWAYS: The instance is on; it is not deactivated by inactivity.
+        # NEVER: The instance is off; it is not activated, even if a connection request
+        # arrives.
+        # ON_DEMAND: The instance responds to incoming requests, and turns itself off
+        # when not in use. Instances with PER_USE pricing turn off after 15 minutes of
+        # inactivity. Instances with PER_PACKAGE pricing turn off after 12 hours of
+        # inactivity.
         # Corresponds to the JSON property `activationPolicy`
         # @return [String]
         attr_accessor :activation_policy

data/generated/google/apis/sqladmin_v1beta4/representations.rb

@@ -334,6 +334,7 @@ module Google
       class BackupRun
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :description, as: 'description'
           property :end_time, as: 'endTime', type: DateTime
       
           property :enqueued_time, as: 'enqueuedTime', type: DateTime
@@ -347,6 +348,7 @@ module Google
           property :start_time, as: 'startTime', type: DateTime
       
           property :status, as: 'status'
+          property :type, as: 'type'
           property :window_start_time, as: 'windowStartTime', type: DateTime
       
         end
@@ -407,6 +409,7 @@ module Google
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
           property :backend_type, as: 'backendType'
+          property :connection_name, as: 'connectionName'
           property :current_disk_size, as: 'currentDiskSize'
           property :database_version, as: 'databaseVersion'
           property :etag, as: 'etag'

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

@@ -136,6 +136,48 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Creates a new backup run on demand. This method is applicable only to Second
+        # Generation instances.
+        # @param [String] project
+        #   Project ID of the project that contains the instance.
+        # @param [String] instance
+        #   Cloud SQL instance ID. This does not include the project ID.
+        # @param [Google::Apis::SqladminV1beta4::BackupRun] backup_run_object
+        # @param [String] fields
+        #   Selector specifying which fields to include in a partial response.
+        # @param [String] quota_user
+        #   Available to use for quota purposes for server-side applications. Can be any
+        #   arbitrary string assigned to a user, but should not exceed 40 characters.
+        #   Overrides userIp if both are provided.
+        # @param [String] user_ip
+        #   IP address of the site where the request originates. Use this if you want to
+        #   enforce per-user limits.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::SqladminV1beta4::Operation] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::SqladminV1beta4::Operation]
+        #
+        # @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 insert_backup_run(project, instance, backup_run_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+          command =  make_simple_command(:post, 'projects/{project}/instances/{instance}/backupRuns', options)
+          command.request_representation = Google::Apis::SqladminV1beta4::BackupRun::Representation
+          command.request_object = backup_run_object
+          command.response_representation = Google::Apis::SqladminV1beta4::Operation::Representation
+          command.response_class = Google::Apis::SqladminV1beta4::Operation
+          command.params['project'] = project unless project.nil?
+          command.params['instance'] = instance unless instance.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?
+          execute_or_queue_command(command, &block)
+        end
+        
         # Lists all backup runs associated with a given instance and configuration in
         # the reverse chronological order of the enqueued time.
         # @param [String] project

data/generated/google/apis/storage_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://developers.google.com/storage/docs/json_api/
     module StorageV1
       VERSION = 'V1'
-      REVISION = '20160504'
+      REVISION = '20161027'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -100,10 +100,12 @@ module Google
         # @return [String]
         attr_accessor :self_link
       
-        # The bucket's storage class. This defines how objects in the bucket are stored
-        # and determines the SLA and the cost of storage. Values include STANDARD,
-        # NEARLINE and DURABLE_REDUCED_AVAILABILITY. Defaults to STANDARD. For more
-        # information, see storage classes.
+        # The bucket's default storage class, used whenever no storageClass is specified
+        # for a newly-created object. This defines how objects in the bucket are stored
+        # and determines the SLA and the cost of storage. Values include MULTI_REGIONAL,
+        # REGIONAL, STANDARD, NEARLINE, COLDLINE, and DURABLE_REDUCED_AVAILABILITY. If
+        # this value is not specified when the bucket is created, it will default to
+        # STANDARD. For more information, see storage classes.
         # Corresponds to the JSON property `storageClass`
         # @return [String]
         attr_accessor :storage_class
@@ -123,7 +125,9 @@ module Google
         # @return [Google::Apis::StorageV1::Bucket::Versioning]
         attr_accessor :versioning
       
-        # The bucket's website configuration.
+        # The bucket's website configuration, controlling how the service behaves when
+        # accessing bucket contents as a web site. See the Static Website Examples for
+        # more information.
         # Corresponds to the JSON property `website`
         # @return [Google::Apis::StorageV1::Bucket::Website]
         attr_accessor :website
@@ -245,7 +249,12 @@ module Google
             class Action
               include Google::Apis::Core::Hashable
             
-              # Type of the action. Currently, only Delete is supported.
+              # Target storage class. Required iff the type of the action is SetStorageClass.
+              # Corresponds to the JSON property `storageClass`
+              # @return [String]
+              attr_accessor :storage_class
+            
+              # Type of the action. Currently, only Delete and SetStorageClass are supported.
               # Corresponds to the JSON property `type`
               # @return [String]
               attr_accessor :type
@@ -256,6 +265,7 @@ module Google
             
               # Update properties of this object
               def update!(**args)
+                @storage_class = args[:storage_class] if args.key?(:storage_class)
                 @type = args[:type] if args.key?(:type)
               end
             end
@@ -284,6 +294,13 @@ module Google
               attr_accessor :is_live
               alias_method :is_live?, :is_live
             
+              # Objects having any of the storage classes specified by this condition will be
+              # matched. Values include MULTI_REGIONAL, REGIONAL, NEARLINE, COLDLINE, STANDARD,
+              # and DURABLE_REDUCED_AVAILABILITY.
+              # Corresponds to the JSON property `matchesStorageClass`
+              # @return [Array<String>]
+              attr_accessor :matches_storage_class
+            
               # Relevant only for versioned objects. If the value is N, this condition is
               # satisfied when there are at least N versions (including the live version)
               # newer than this version of the object.
@@ -300,6 +317,7 @@ module Google
                 @age = args[:age] if args.key?(:age)
                 @created_before = args[:created_before] if args.key?(:created_before)
                 @is_live = args[:is_live] if args.key?(:is_live)
+                @matches_storage_class = args[:matches_storage_class] if args.key?(:matches_storage_class)
                 @num_newer_versions = args[:num_newer_versions] if args.key?(:num_newer_versions)
               end
             end
@@ -377,17 +395,23 @@ module Google
           end
         end
         
-        # The bucket's website configuration.
+        # The bucket's website configuration, controlling how the service behaves when
+        # accessing bucket contents as a web site. See the Static Website Examples for
+        # more information.
         class Website
           include Google::Apis::Core::Hashable
         
-          # Behaves as the bucket's directory index where missing objects are treated as
-          # potential directories.
+          # If the requested object path is missing, the service will ensure the path has
+          # a trailing '/', append this suffix, and attempt to retrieve the resulting
+          # object. This allows the creation of index.html objects to represent directory
+          # pages.
           # Corresponds to the JSON property `mainPageSuffix`
           # @return [String]
           attr_accessor :main_page_suffix
         
-          # The custom object to return when a requested resource is not found.
+          # If the requested object path is missing, and any mainPageSuffix object is
+          # missing, if applicable, the service will return the named object from this
+          # bucket as the content for a 404 Not Found result.
           # Corresponds to the JSON property `notFoundPage`
           # @return [String]
           attr_accessor :not_found_page
@@ -466,7 +490,7 @@ module Google
         # @return [Google::Apis::StorageV1::BucketAccessControl::ProjectTeam]
         attr_accessor :project_team
       
-        # The access permission for the entity. Can be READER, WRITER, or OWNER.
+        # The access permission for the entity.
         # Corresponds to the JSON property `role`
         # @return [String]
         attr_accessor :role
@@ -504,7 +528,7 @@ module Google
           # @return [String]
           attr_accessor :project_number
         
-          # The team. Can be owners, editors, or viewers.
+          # The team.
           # Corresponds to the JSON property `team`
           # @return [String]
           attr_accessor :team
@@ -755,7 +779,8 @@ module Google
         # @return [String]
         attr_accessor :bucket
       
-        # Cache-Control directive for the object data.
+        # Cache-Control directive for the object data. If omitted, and the object is
+        # accessible to all anonymous users, the default will be public, max-age=3600.
         # Corresponds to the JSON property `cacheControl`
         # @return [String]
         attr_accessor :cache_control
@@ -1017,7 +1042,7 @@ module Google
         # @return [String]
         attr_accessor :etag
       
-        # The content generation of the object.
+        # The content generation of the object, if applied to an object.
         # Corresponds to the JSON property `generation`
         # @return [String]
         attr_accessor :generation
@@ -1033,7 +1058,7 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # The name of the object.
+        # The name of the object, if applied to an object.
         # Corresponds to the JSON property `object`
         # @return [String]
         attr_accessor :object
@@ -1043,7 +1068,7 @@ module Google
         # @return [Google::Apis::StorageV1::ObjectAccessControl::ProjectTeam]
         attr_accessor :project_team
       
-        # The access permission for the entity. Can be READER or OWNER.
+        # The access permission for the entity.
         # Corresponds to the JSON property `role`
         # @return [String]
         attr_accessor :role
@@ -1083,7 +1108,7 @@ module Google
           # @return [String]
           attr_accessor :project_number
         
-          # The team. Can be owners, editors, or viewers.
+          # The team.
           # Corresponds to the JSON property `team`
           # @return [String]
           attr_accessor :team
@@ -1106,7 +1131,7 @@ module Google
       
         # The list of items.
         # Corresponds to the JSON property `items`
-        # @return [Array<Object>]
+        # @return [Array<Google::Apis::StorageV1::ObjectAccessControl>]
         attr_accessor :items
       
         # The kind of item this is. For lists of object access control entries, this is

data/generated/google/apis/storage_v1/representations.rb

@@ -241,6 +241,7 @@ module Google
             class Action
               # @private
               class Representation < Google::Apis::Core::JsonRepresentation
+                property :storage_class, as: 'storageClass'
                 property :type, as: 'type'
               end
             end
@@ -252,6 +253,7 @@ module Google
                 property :created_before, as: 'createdBefore', type: Date
             
                 property :is_live, as: 'isLive'
+                collection :matches_storage_class, as: 'matchesStorageClass'
                 property :num_newer_versions, as: 'numNewerVersions'
               end
             end
@@ -464,7 +466,8 @@ module Google
       class ObjectAccessControls
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
-          collection :items, as: 'items'
+          collection :items, as: 'items', class: Google::Apis::StorageV1::ObjectAccessControl, decorator: Google::Apis::StorageV1::ObjectAccessControl::Representation
+      
           property :kind, as: 'kind'
         end
       end

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

@@ -469,7 +469,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates a bucket. This method supports patch semantics.
+        # Updates a bucket. Changes to the bucket will be readable immediately after
+        # writing, but configuration changes may take time to propagate. This method
+        # supports patch semantics.
         # @param [String] bucket
         #   Name of a bucket.
         # @param [Google::Apis::StorageV1::Bucket] bucket_object
@@ -524,7 +526,8 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Updates a bucket.
+        # Updates a bucket. Changes to the bucket will be readable immediately after
+        # writing, but configuration changes may take time to propagate.
         # @param [String] bucket
         #   Name of a bucket.
         # @param [Google::Apis::StorageV1::Bucket] bucket_object

data/generated/google/apis/translate_v2.rb

@@ -20,12 +20,12 @@ module Google
   module Apis
     # Translate API
     #
-    # Lets you translate text from one language to another
+    # Translates text from one language to another.
     #
     # @see https://developers.google.com/translate/v2/using_rest
     module TranslateV2
       VERSION = 'V2'
-      REVISION = '20160217'
+      REVISION = '20160627'
     end
   end
 end

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

@@ -22,7 +22,7 @@ module Google
     module TranslateV2
       # Translate API
       #
-      # Lets you translate text from one language to another
+      # Translates text from one language to another.
       #
       # @example
       #    require 'google/apis/translate_v2'

data/generated/google/apis/vision_v1.rb

@@ -27,7 +27,7 @@ module Google
     # @see https://cloud.google.com/vision/
     module VisionV1
       VERSION = 'V1'
-      REVISION = '20160519'
+      REVISION = '20161031'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -54,7 +54,7 @@ module Google
         # @return [Google::Apis::VisionV1::Image]
         attr_accessor :image
       
-        # Image context.
+        # Image context and/or feature-specific parameters.
         # Corresponds to the JSON property `imageContext`
         # @return [Google::Apis::VisionV1::ImageContext]
         attr_accessor :image_context
@@ -658,7 +658,7 @@ module Google
         end
       end
       
-      # Image context.
+      # Image context and/or feature-specific parameters.
       class ImageContext
         include Google::Apis::Core::Hashable
       
@@ -668,15 +668,14 @@ module Google
         attr_accessor :lat_long_rect
       
         # List of languages to use for TEXT_DETECTION. In most cases, an empty value
-        # will yield the best results as it will allow text detection to
-        # automatically detect the text language. For languages based on the latin
-        # alphabet a hint is not needed. In rare cases, when the language of
-        # the text in the image is known in advance, setting this hint will help get
-        # better results (although it will hurt a great deal if the hint is wrong).
-        # Text detection will return an error if one or more of the languages
-        # specified here are not supported. The exact list of supported languages are
-        # specified here:
-        # https://cloud.google.com/translate/v2/using_rest#language-params
+        # yields the best results since it enables automatic language detection. For
+        # languages based on the Latin alphabet, setting `language_hints` is not
+        # needed. In rare cases, when the language of the text in the image is known,
+        # setting a hint will help get better results (although it will be a
+        # significant hindrance if the hint is wrong). Text detection returns an
+        # error if one or more of the specified languages is not one of the
+        # [supported
+        # languages](/translate/v2/translate-reference#supported_languages).
         # Corresponds to the JSON property `languageHints`
         # @return [Array<String>]
         attr_accessor :language_hints
@@ -1064,6 +1063,8 @@ module Google
         attr_accessor :source
       
         # Image content, represented as a stream of bytes.
+        # Note: as with all `bytes` fields, protobuffers use a pure binary
+        # representation, whereas JSON representations use base64.
         # Corresponds to the JSON property `content`
         # @return [String]
         attr_accessor :content