google-api-client 0.8.6 → 0.9.3

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

@@ -0,0 +1,128 @@
+# 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 AppsactivityV1
+      # Google Apps Activity API
+      #
+      # Provides a historical view of activity.
+      #
+      # @example
+      #    require 'google/apis/appsactivity_v1'
+      #
+      #    Appsactivity = Google::Apis::AppsactivityV1 # Alias the module
+      #    service = Appsactivity::AppsactivityService.new
+      #
+      # @see https://developers.google.com/google-apps/activity/
+      class AppsactivityService < 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.
+        #  Overrides userIp if both are provided.
+        attr_accessor :quota_user
+
+        # @return [String]
+        #  IP address of the site where the request originates. Use this if you want to
+        #  enforce per-user limits.
+        attr_accessor :user_ip
+
+        def initialize
+          super('https://www.googleapis.com/', 'appsactivity/v1/')
+        end
+        
+        # Returns a list of activities visible to the current logged in user. Visible
+        # activities are determined by the visiblity settings of the object that was
+        # acted on, e.g. Drive files a user can see. An activity is a record of past
+        # events. Multiple events may be merged if they are similar. A request is scoped
+        # to activities from a given Google service using the source parameter.
+        # @param [String] drive_ancestor_id
+        #   Identifies the Drive folder containing the items for which to return
+        #   activities.
+        # @param [String] drive_file_id
+        #   Identifies the Drive item to return activities for.
+        # @param [String] grouping_strategy
+        #   Indicates the strategy to use when grouping singleEvents items in the
+        #   associated combinedEvent object.
+        # @param [Fixnum] page_size
+        #   The maximum number of events to return on a page. The response includes a
+        #   continuation token if there are more events.
+        # @param [String] page_token
+        #   A token to retrieve a specific page of results.
+        # @param [String] source
+        #   The Google service from which to return activities. Possible values of source
+        #   are:
+        #   - drive.google.com
+        # @param [String] user_id
+        #   Indicates the user to return activity for. Use the special value me to
+        #   indicate the currently authenticated user.
+        # @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::AppsactivityV1::ListActivitiesResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::AppsactivityV1::ListActivitiesResponse]
+        #
+        # @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_activities(drive_ancestor_id: nil, drive_file_id: nil, grouping_strategy: nil, page_size: nil, page_token: nil, source: nil, user_id: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+          command =  make_simple_command(:get, 'activities', options)
+          command.response_representation = Google::Apis::AppsactivityV1::ListActivitiesResponse::Representation
+          command.response_class = Google::Apis::AppsactivityV1::ListActivitiesResponse
+          command.query['drive.ancestorId'] = drive_ancestor_id unless drive_ancestor_id.nil?
+          command.query['drive.fileId'] = drive_file_id unless drive_file_id.nil?
+          command.query['groupingStrategy'] = grouping_strategy unless grouping_strategy.nil?
+          command.query['pageSize'] = page_size unless page_size.nil?
+          command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['source'] = source unless source.nil?
+          command.query['userId'] = user_id unless user_id.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
+
+        protected
+
+        def apply_command_defaults(command)
+          command.query['key'] = key unless key.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          command.query['userIp'] = user_ip unless user_ip.nil?
+        end
+      end
+    end
+  end
+end

data/generated/google/apis/appsactivity_v1.rb

@@ -0,0 +1,46 @@
+# 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/appsactivity_v1/service.rb'
+require 'google/apis/appsactivity_v1/classes.rb'
+require 'google/apis/appsactivity_v1/representations.rb'
+
+module Google
+  module Apis
+    # Google Apps Activity API
+    #
+    # Provides a historical view of activity.
+    #
+    # @see https://developers.google.com/google-apps/activity/
+    module AppsactivityV1
+      VERSION = 'V1'
+      REVISION = '20150723'
+
+      # View the activity history of your Google Apps
+      AUTH_ACTIVITY = 'https://www.googleapis.com/auth/activity'
+
+      # View and manage the files in your Google Drive
+      AUTH_DRIVE = 'https://www.googleapis.com/auth/drive'
+
+      # View and manage metadata of files in your Google Drive
+      AUTH_DRIVE_METADATA = 'https://www.googleapis.com/auth/drive.metadata'
+
+      # View metadata for files in your Google Drive
+      AUTH_DRIVE_METADATA_READONLY = 'https://www.googleapis.com/auth/drive.metadata.readonly'
+
+      # View the files in your Google Drive
+      AUTH_DRIVE_READONLY = 'https://www.googleapis.com/auth/drive.readonly'
+    end
+  end
+end

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

@@ -0,0 +1,154 @@
+# 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 'date'
+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 AppstateV1
+      
+      # This is a JSON template for an app state resource.
+      class GetResponse
+        include Google::Apis::Core::Hashable
+      
+        # The current app state version.
+        # Corresponds to the JSON property `currentStateVersion`
+        # @return [String]
+        attr_accessor :current_state_version
+      
+        # The requested data.
+        # Corresponds to the JSON property `data`
+        # @return [String]
+        attr_accessor :data
+      
+        # Uniquely identifies the type of this resource. Value is always the fixed
+        # string appstate#getResponse.
+        # Corresponds to the JSON property `kind`
+        # @return [String]
+        attr_accessor :kind
+      
+        # The key for the data.
+        # Corresponds to the JSON property `stateKey`
+        # @return [Fixnum]
+        attr_accessor :state_key
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @current_state_version = args[:current_state_version] if args.key?(:current_state_version)
+          @data = args[:data] if args.key?(:data)
+          @kind = args[:kind] if args.key?(:kind)
+          @state_key = args[:state_key] if args.key?(:state_key)
+        end
+      end
+      
+      # This is a JSON template to convert a list-response for app state.
+      class ListResponse
+        include Google::Apis::Core::Hashable
+      
+        # The app state data.
+        # Corresponds to the JSON property `items`
+        # @return [Array<Google::Apis::AppstateV1::GetResponse>]
+        attr_accessor :items
+      
+        # Uniquely identifies the type of this resource. Value is always the fixed
+        # string appstate#listResponse.
+        # Corresponds to the JSON property `kind`
+        # @return [String]
+        attr_accessor :kind
+      
+        # The maximum number of keys allowed for this user.
+        # Corresponds to the JSON property `maximumKeyCount`
+        # @return [Fixnum]
+        attr_accessor :maximum_key_count
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @items = args[:items] if args.key?(:items)
+          @kind = args[:kind] if args.key?(:kind)
+          @maximum_key_count = args[:maximum_key_count] if args.key?(:maximum_key_count)
+        end
+      end
+      
+      # This is a JSON template for a requests which update app state
+      class UpdateRequest
+        include Google::Apis::Core::Hashable
+      
+        # The new app state data that your application is trying to update with.
+        # Corresponds to the JSON property `data`
+        # @return [String]
+        attr_accessor :data
+      
+        # Uniquely identifies the type of this resource. Value is always the fixed
+        # string appstate#updateRequest.
+        # Corresponds to the JSON property `kind`
+        # @return [String]
+        attr_accessor :kind
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @data = args[:data] if args.key?(:data)
+          @kind = args[:kind] if args.key?(:kind)
+        end
+      end
+      
+      # This is a JSON template for an app state write result.
+      class WriteResult
+        include Google::Apis::Core::Hashable
+      
+        # The version of the data for this key on the server.
+        # Corresponds to the JSON property `currentStateVersion`
+        # @return [String]
+        attr_accessor :current_state_version
+      
+        # Uniquely identifies the type of this resource. Value is always the fixed
+        # string appstate#writeResult.
+        # Corresponds to the JSON property `kind`
+        # @return [String]
+        attr_accessor :kind
+      
+        # The written key.
+        # Corresponds to the JSON property `stateKey`
+        # @return [Fixnum]
+        attr_accessor :state_key
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @current_state_version = args[:current_state_version] if args.key?(:current_state_version)
+          @kind = args[:kind] if args.key?(:kind)
+          @state_key = args[:state_key] if args.key?(:state_key)
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,87 @@
+# 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 'date'
+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 AppstateV1
+      
+      class GetResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class ListResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class UpdateRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class WriteResult
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class GetResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :current_state_version, as: 'currentStateVersion'
+          property :data, as: 'data'
+          property :kind, as: 'kind'
+          property :state_key, as: 'stateKey'
+        end
+      end
+      
+      class ListResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :items, as: 'items', class: Google::Apis::AppstateV1::GetResponse, decorator: Google::Apis::AppstateV1::GetResponse::Representation
+      
+          property :kind, as: 'kind'
+          property :maximum_key_count, as: 'maximumKeyCount'
+        end
+      end
+      
+      class UpdateRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :data, as: 'data'
+          property :kind, as: 'kind'
+        end
+      end
+      
+      class WriteResult
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :current_state_version, as: 'currentStateVersion'
+          property :kind, as: 'kind'
+          property :state_key, as: 'stateKey'
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,260 @@
+# 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 AppstateV1
+      # Google App State API
+      #
+      # The Google App State API.
+      #
+      # @example
+      #    require 'google/apis/appstate_v1'
+      #
+      #    Appstate = Google::Apis::AppstateV1 # Alias the module
+      #    service = Appstate::AppStateService.new
+      #
+      # @see https://developers.google.com/games/services/web/api/states
+      class AppStateService < 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.
+        #  Overrides userIp if both are provided.
+        attr_accessor :quota_user
+
+        # @return [String]
+        #  IP address of the site where the request originates. Use this if you want to
+        #  enforce per-user limits.
+        attr_accessor :user_ip
+
+        def initialize
+          super('https://www.googleapis.com/', 'appstate/v1/')
+        end
+        
+        # Clears (sets to empty) the data for the passed key if and only if the passed
+        # version matches the currently stored version. This method results in a
+        # conflict error on version mismatch.
+        # @param [Fixnum] state_key
+        #   The key for the data to be retrieved.
+        # @param [String] current_data_version
+        #   The version of the data to be cleared. Version strings are returned by the
+        #   server.
+        # @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::AppstateV1::WriteResult] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::AppstateV1::WriteResult]
+        #
+        # @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 clear_state(state_key, current_data_version: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+          command =  make_simple_command(:post, 'states/{stateKey}/clear', options)
+          command.response_representation = Google::Apis::AppstateV1::WriteResult::Representation
+          command.response_class = Google::Apis::AppstateV1::WriteResult
+          command.params['stateKey'] = state_key unless state_key.nil?
+          command.query['currentDataVersion'] = current_data_version unless current_data_version.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
+        
+        # Deletes a key and the data associated with it. The key is removed and no
+        # longer counts against the key quota. Note that since this method is not safe
+        # in the face of concurrent modifications, it should only be used for
+        # development and testing purposes. Invoking this method in shipping code can
+        # result in data loss and data corruption.
+        # @param [Fixnum] state_key
+        #   The key for the data to be retrieved.
+        # @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 [NilClass] No result returned for this method
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [void]
+        #
+        # @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_state(state_key, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+          command =  make_simple_command(:delete, 'states/{stateKey}', options)
+          command.params['stateKey'] = state_key unless state_key.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
+        
+        # Retrieves the data corresponding to the passed key. If the key does not exist
+        # on the server, an HTTP 404 will be returned.
+        # @param [Fixnum] state_key
+        #   The key for the data to be retrieved.
+        # @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::AppstateV1::GetResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::AppstateV1::GetResponse]
+        #
+        # @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_state(state_key, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+          command =  make_simple_command(:get, 'states/{stateKey}', options)
+          command.response_representation = Google::Apis::AppstateV1::GetResponse::Representation
+          command.response_class = Google::Apis::AppstateV1::GetResponse
+          command.params['stateKey'] = state_key unless state_key.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 the states keys, and optionally the state data.
+        # @param [Boolean] include_data
+        #   Whether to include the full data in addition to the version number
+        # @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::AppstateV1::ListResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::AppstateV1::ListResponse]
+        #
+        # @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_states(include_data: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+          command =  make_simple_command(:get, 'states', options)
+          command.response_representation = Google::Apis::AppstateV1::ListResponse::Representation
+          command.response_class = Google::Apis::AppstateV1::ListResponse
+          command.query['includeData'] = include_data unless include_data.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
+        
+        # Update the data associated with the input key if and only if the passed
+        # version matches the currently stored version. This method is safe in the face
+        # of concurrent writes. Maximum per-key size is 128KB.
+        # @param [Fixnum] state_key
+        #   The key for the data to be retrieved.
+        # @param [Google::Apis::AppstateV1::UpdateRequest] update_request_object
+        # @param [String] current_state_version
+        #   The version of the app state your application is attempting to update. If this
+        #   does not match the current version, this method will return a conflict error.
+        #   If there is no data stored on the server for this key, the update will succeed
+        #   irrespective of the value of this parameter.
+        # @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::AppstateV1::WriteResult] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::AppstateV1::WriteResult]
+        #
+        # @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_state(state_key, update_request_object = nil, current_state_version: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+          command =  make_simple_command(:put, 'states/{stateKey}', options)
+          command.request_representation = Google::Apis::AppstateV1::UpdateRequest::Representation
+          command.request_object = update_request_object
+          command.response_representation = Google::Apis::AppstateV1::WriteResult::Representation
+          command.response_class = Google::Apis::AppstateV1::WriteResult
+          command.params['stateKey'] = state_key unless state_key.nil?
+          command.query['currentStateVersion'] = current_state_version unless current_state_version.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
+
+        protected
+
+        def apply_command_defaults(command)
+          command.query['key'] = key unless key.nil?
+          command.query['quotaUser'] = quota_user unless quota_user.nil?
+          command.query['userIp'] = user_ip unless user_ip.nil?
+        end
+      end
+    end
+  end
+end