google-api-client 0.28.1 → 0.28.2

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

@@ -0,0 +1,176 @@
+# Copyright 2015 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/core/base_service'
+require 'google/apis/core/json_representation'
+require 'google/apis/core/hashable'
+require 'google/apis/errors'
+
+module Google
+  module Apis
+    module DocsV1
+      # Google Docs API
+      #
+      # An API for creating and editing Google Docs documents.
+      #
+      # @example
+      #    require 'google/apis/docs_v1'
+      #
+      #    Docs = Google::Apis::DocsV1 # Alias the module
+      #    service = Docs::DocsService.new
+      #
+      # @see https://developers.google.com/docs/
+      class DocsService < Google::Apis::Core::BaseService
+        # @return [String]
+        #  API key. Your API key identifies your project and provides you with API access,
+        #  quota, and reports. Required unless you provide an OAuth 2.0 token.
+        attr_accessor :key
+
+        # @return [String]
+        #  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.
+        attr_accessor :quota_user
+
+        def initialize
+          super('https://docs.googleapis.com/', '')
+          @batch_path = 'batch'
+        end
+        
+        # Applies one or more updates to the document.
+        # Each request is validated before
+        # being applied. If any request is not valid, then the entire request will
+        # fail and nothing will be applied.
+        # Some requests have replies to
+        # give you some information about how they are applied. Other requests do
+        # not need to return information; these each return an empty reply.
+        # The order of replies matches that of the requests.
+        # For example, suppose you call batchUpdate with four updates, and only the
+        # third one returns information. The response would have two empty replies,
+        # the reply to the third request, and another empty reply, in that order.
+        # Because other users may be editing the document, the document
+        # might not exactly reflect your changes: your changes may
+        # be altered with respect to collaborator changes. If there are no
+        # collaborators, the document should reflect your changes. In any case,
+        # the updates in your request are guaranteed to be applied together
+        # atomically.
+        # @param [String] document_id
+        #   The ID of the document to update.
+        # @param [Google::Apis::DocsV1::BatchUpdateDocumentRequest] batch_update_document_request_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.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::DocsV1::BatchUpdateDocumentResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DocsV1::BatchUpdateDocumentResponse]
+        #
+        # @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 batch_update_document(document_id, batch_update_document_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:post, 'v1/documents/{documentId}:batchUpdate', options)
+          command.request_representation = Google::Apis::DocsV1::BatchUpdateDocumentRequest::Representation
+          command.request_object = batch_update_document_request_object
+          command.response_representation = Google::Apis::DocsV1::BatchUpdateDocumentResponse::Representation
+          command.response_class = Google::Apis::DocsV1::BatchUpdateDocumentResponse
+          command.params['documentId'] = document_id unless document_id.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Creates a blank document using the title given in the request. Other fields
+        # in the request, including any provided content, are ignored.
+        # Returns the created document.
+        # @param [Google::Apis::DocsV1::Document] document_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.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::DocsV1::Document] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DocsV1::Document]
+        #
+        # @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 create_document(document_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:post, 'v1/documents', options)
+          command.request_representation = Google::Apis::DocsV1::Document::Representation
+          command.request_object = document_object
+          command.response_representation = Google::Apis::DocsV1::Document::Representation
+          command.response_class = Google::Apis::DocsV1::Document
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+        
+        # Gets the latest version of the specified document.
+        # @param [String] document_id
+        #   The ID of the document to retrieve.
+        # @param [String] suggestions_view_mode
+        #   The suggestions view mode to apply to the document. This allows viewing the
+        #   document with all suggestions inline, accepted or rejected. If one is not
+        #   specified, DEFAULT_FOR_CURRENT_ACCESS is
+        #   used.
+        # @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.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::DocsV1::Document] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::DocsV1::Document]
+        #
+        # @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 get_document(document_id, suggestions_view_mode: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command =  make_simple_command(:get, 'v1/documents/{documentId}', options)
+          command.response_representation = Google::Apis::DocsV1::Document::Representation
+          command.response_class = Google::Apis::DocsV1::Document
+          command.params['documentId'] = document_id unless document_id.nil?
+          command.query['suggestionsViewMode'] = suggestions_view_mode unless suggestions_view_mode.nil?
+          command.query['fields'] = fields unless fields.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          execute_or_queue_command(command, &block)
+        end
+
+        protected
+
+        def apply_command_defaults(command)
+          command.query['key'] = key unless key.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+        end
+      end
+    end
+  end
+end

data/generated/google/apis/file_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/filestore/
     module FileV1
       VERSION = 'V1'
-      REVISION = '20190123'
+      REVISION = '20190129'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -54,149 +54,6 @@ module Google
         end
       end
       
-      # File share configuration for the instance.
-      class FileShareConfig
-        include Google::Apis::Core::Hashable
-      
-        # File share capacity in gigabytes (GB).
-        # Cloud Filestore defines 1 GB as 1024^3 bytes.
-        # Corresponds to the JSON property `capacityGb`
-        # @return [Fixnum]
-        attr_accessor :capacity_gb
-      
-        # The name of the file share (must be 16 characters or less).
-        # Corresponds to the JSON property `name`
-        # @return [String]
-        attr_accessor :name
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @capacity_gb = args[:capacity_gb] if args.key?(:capacity_gb)
-          @name = args[:name] if args.key?(:name)
-        end
-      end
-      
-      # A Cloud Filestore instance.
-      class Instance
-        include Google::Apis::Core::Hashable
-      
-        # Output only.
-        # The time when the instance was created.
-        # Corresponds to the JSON property `createTime`
-        # @return [String]
-        attr_accessor :create_time
-      
-        # Optional. A description of the instance (2048 characters or less).
-        # Corresponds to the JSON property `description`
-        # @return [String]
-        attr_accessor :description
-      
-        # Server-specified ETag for the instance resource to prevent simultaneous
-        # updates from overwriting each other.
-        # Corresponds to the JSON property `etag`
-        # @return [String]
-        attr_accessor :etag
-      
-        # File system shares on the instance.
-        # For this version, only a single file share is supported.
-        # Corresponds to the JSON property `fileShares`
-        # @return [Array<Google::Apis::FileV1::FileShareConfig>]
-        attr_accessor :file_shares
-      
-        # Resource labels to represent user provided metadata.
-        # Corresponds to the JSON property `labels`
-        # @return [Hash<String,String>]
-        attr_accessor :labels
-      
-        # Output only.
-        # The resource name of the instance, in the format
-        # projects/`project_id`/locations/`location_id`/instances/`instance_id`.
-        # Corresponds to the JSON property `name`
-        # @return [String]
-        attr_accessor :name
-      
-        # VPC networks to which the instance is connected.
-        # For this version, only a single network is supported.
-        # Corresponds to the JSON property `networks`
-        # @return [Array<Google::Apis::FileV1::NetworkConfig>]
-        attr_accessor :networks
-      
-        # Output only.
-        # The instance state.
-        # Corresponds to the JSON property `state`
-        # @return [String]
-        attr_accessor :state
-      
-        # Output only.
-        # Additional information about the instance state, if available.
-        # Corresponds to the JSON property `statusMessage`
-        # @return [String]
-        attr_accessor :status_message
-      
-        # The service tier of the instance.
-        # Corresponds to the JSON property `tier`
-        # @return [String]
-        attr_accessor :tier
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @create_time = args[:create_time] if args.key?(:create_time)
-          @description = args[:description] if args.key?(:description)
-          @etag = args[:etag] if args.key?(:etag)
-          @file_shares = args[:file_shares] if args.key?(:file_shares)
-          @labels = args[:labels] if args.key?(:labels)
-          @name = args[:name] if args.key?(:name)
-          @networks = args[:networks] if args.key?(:networks)
-          @state = args[:state] if args.key?(:state)
-          @status_message = args[:status_message] if args.key?(:status_message)
-          @tier = args[:tier] if args.key?(:tier)
-        end
-      end
-      
-      # ListInstancesResponse is the result of ListInstancesRequest.
-      class ListInstancesResponse
-        include Google::Apis::Core::Hashable
-      
-        # A list of instances in the project for the specified location.
-        # If the `location` value in the request is "-", the response contains a list
-        # of instances from all locations. If any location is unreachable, the
-        # response will only return instances in reachable locations and the
-        # "unreachable" field will be populated with a list of unreachable locations.
-        # Corresponds to the JSON property `instances`
-        # @return [Array<Google::Apis::FileV1::Instance>]
-        attr_accessor :instances
-      
-        # The token you can use to retrieve the next page of results. Not returned
-        # if there are no more results in the list.
-        # Corresponds to the JSON property `nextPageToken`
-        # @return [String]
-        attr_accessor :next_page_token
-      
-        # Locations that could not be reached.
-        # Corresponds to the JSON property `unreachable`
-        # @return [Array<String>]
-        attr_accessor :unreachable
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @instances = args[:instances] if args.key?(:instances)
-          @next_page_token = args[:next_page_token] if args.key?(:next_page_token)
-          @unreachable = args[:unreachable] if args.key?(:unreachable)
-        end
-      end
-      
       # The response message for Locations.ListLocations.
       class ListLocationsResponse
         include Google::Apis::Core::Hashable
@@ -294,56 +151,6 @@ module Google
         end
       end
       
-      # Network configuration for the instance.
-      class NetworkConfig
-        include Google::Apis::Core::Hashable
-      
-        # Output only.
-        # IPv4 addresses in the format
-        # `octet 1`.`octet 2`.`octet 3`.`octet 4` or IPv6 addresses in the format
-        # `block 1`:`block 2`:`block 3`:`block 4`:`block 5`:`block 6`:`block 7`:`block 8`
-        # .
-        # Corresponds to the JSON property `ipAddresses`
-        # @return [Array<String>]
-        attr_accessor :ip_addresses
-      
-        # Internet protocol versions for which the instance has IP addresses
-        # assigned. For this version, only MODE_IPV4 is supported.
-        # Corresponds to the JSON property `modes`
-        # @return [Array<String>]
-        attr_accessor :modes
-      
-        # The name of the Google Compute Engine
-        # [VPC network](/compute/docs/networks-and-firewalls#networks) to which the
-        # instance is connected.
-        # Corresponds to the JSON property `network`
-        # @return [String]
-        attr_accessor :network
-      
-        # A /29 CIDR block in one of the
-        # [internal IP address ranges](https://www.arin.net/knowledge/address_filters.
-        # html)
-        # that identifies the range of IP addresses reserved for this
-        # instance. For example, 10.0.0.0/29 or 192.168.0.0/29. The range you specify
-        # can't overlap with either existing subnets or assigned IP address ranges
-        # for other Cloud Filestore instances in the selected VPC network.
-        # Corresponds to the JSON property `reservedIpRange`
-        # @return [String]
-        attr_accessor :reserved_ip_range
-      
-        def initialize(**args)
-           update!(**args)
-        end
-      
-        # Update properties of this object
-        def update!(**args)
-          @ip_addresses = args[:ip_addresses] if args.key?(:ip_addresses)
-          @modes = args[:modes] if args.key?(:modes)
-          @network = args[:network] if args.key?(:network)
-          @reserved_ip_range = args[:reserved_ip_range] if args.key?(:reserved_ip_range)
-        end
-      end
-      
       # This resource represents a long-running operation that is the result of a
       # network API call.
       class Operation

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

@@ -34,24 +34,6 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
-      class FileShareConfig
-        class Representation < Google::Apis::Core::JsonRepresentation; end
-      
-        include Google::Apis::Core::JsonObjectSupport
-      end
-      
-      class Instance
-        class Representation < Google::Apis::Core::JsonRepresentation; end
-      
-        include Google::Apis::Core::JsonObjectSupport
-      end
-      
-      class ListInstancesResponse
-        class Representation < Google::Apis::Core::JsonRepresentation; end
-      
-        include Google::Apis::Core::JsonObjectSupport
-      end
-      
       class ListLocationsResponse
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -70,12 +52,6 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
-      class NetworkConfig
-        class Representation < Google::Apis::Core::JsonRepresentation; end
-      
-        include Google::Apis::Core::JsonObjectSupport
-      end
-      
       class Operation
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -106,42 +82,6 @@ module Google
         end
       end
       
-      class FileShareConfig
-        # @private
-        class Representation < Google::Apis::Core::JsonRepresentation
-          property :capacity_gb, :numeric_string => true, as: 'capacityGb'
-          property :name, as: 'name'
-        end
-      end
-      
-      class Instance
-        # @private
-        class Representation < Google::Apis::Core::JsonRepresentation
-          property :create_time, as: 'createTime'
-          property :description, as: 'description'
-          property :etag, as: 'etag'
-          collection :file_shares, as: 'fileShares', class: Google::Apis::FileV1::FileShareConfig, decorator: Google::Apis::FileV1::FileShareConfig::Representation
-      
-          hash :labels, as: 'labels'
-          property :name, as: 'name'
-          collection :networks, as: 'networks', class: Google::Apis::FileV1::NetworkConfig, decorator: Google::Apis::FileV1::NetworkConfig::Representation
-      
-          property :state, as: 'state'
-          property :status_message, as: 'statusMessage'
-          property :tier, as: 'tier'
-        end
-      end
-      
-      class ListInstancesResponse
-        # @private
-        class Representation < Google::Apis::Core::JsonRepresentation
-          collection :instances, as: 'instances', class: Google::Apis::FileV1::Instance, decorator: Google::Apis::FileV1::Instance::Representation
-      
-          property :next_page_token, as: 'nextPageToken'
-          collection :unreachable, as: 'unreachable'
-        end
-      end
-      
       class ListLocationsResponse
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -171,16 +111,6 @@ module Google
         end
       end
       
-      class NetworkConfig
-        # @private
-        class Representation < Google::Apis::Core::JsonRepresentation
-          collection :ip_addresses, as: 'ipAddresses'
-          collection :modes, as: 'modes'
-          property :network, as: 'network'
-          property :reserved_ip_range, as: 'reservedIpRange'
-        end
-      end
-      
       class Operation
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation