google-api-client 0.39.1 → 0.40.0

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

@@ -20,9 +20,9 @@ require 'google/apis/errors'
 module Google
   module Apis
     module FitnessV1
-      # Fitness
+      # Fitness API
       #
-      # Stores and accesses user data in the fitness store from apps on any platform.
+      # The Fitness API for managing users' fitness tracking data.
       #
       # @example
       #    require 'google/apis/fitness_v1'
@@ -30,7 +30,7 @@ module Google
       #    Fitness = Google::Apis::FitnessV1 # Alias the module
       #    service = Fitness::FitnessService.new
       #
-      # @see https://developers.google.com/fit/rest/
+      # @see https://developers.google.com/fit/rest/v1/get-started
       class FitnessService < Google::Apis::Core::BaseService
         # @return [String]
         #  API key. Your API key identifies your project and provides you with API access,
@@ -38,57 +38,55 @@ module Google
         attr_accessor :key
 
         # @return [String]
-        #  An opaque string that represents a user for quota purposes. Must not exceed 40
-        #  characters.
+        #  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
 
-        # @return [String]
-        #  Deprecated. Please use quotaUser instead.
-        attr_accessor :user_ip
-
         def initialize
-          super('https://www.googleapis.com/', 'fitness/v1/users/')
+          super('https://www.googleapis.com/', '')
           @batch_path = 'batch/fitness/v1'
         end
         
-        # Creates a new data source that is unique across all data sources belonging to
-        # this user.
-        # A data source is a unique source of sensor data. Data sources can expose raw
-        # data coming from hardware sensors on local or companion devices. They can also
-        # expose derived data, created by transforming or merging other data sources.
-        # Multiple data sources can exist for the same data type. Every data point in
-        # every dataset inserted into or read from the Fitness API has an associated
-        # data source.
-        # Each data source produces a unique stream of dataset updates, with a unique
-        # data source identifier. Not all changes to data source affect the data stream
-        # ID, so that data collected by updated versions of the same application/device
-        # can still be considered to belong to the same data source.
-        # Data sources are identified using a string generated by the server, based on
-        # the contents of the source being created. The dataStreamId field should not be
-        # set when invoking this method. It will be automatically generated by the
-        # server with the correct format. If a dataStreamId is set, it must match the
-        # format that the server would generate. This format is a combination of some
-        # fields from the data source, and has a specific order. If it doesn't match,
-        # the request will fail with an error.
-        # Specifying a DataType which is not a known type (beginning with "com.google.")
-        # will create a DataSource with a custom data type. Custom data types are only
-        # readable by the application that created them. Custom data types are
-        # deprecated; use standard data types instead.
+        # Creates a new data source that is unique across all data sources belonging
+        # to this user.
+        # A data source is a unique source of sensor data. Data sources can expose
+        # raw data coming from hardware sensors on local or companion devices. They
+        # can also expose derived data, created by transforming or merging other data
+        # sources. Multiple data sources can exist for the same data type. Every data
+        # point in every dataset inserted into or read from the Fitness API has an
+        # associated data source.
+        # Each data source produces a unique stream of dataset updates, with a
+        # unique data source identifier. Not all changes to data source affect the
+        # data stream ID, so that data collected by updated versions of the same
+        # application/device can still be considered to belong to the same data
+        # source.
+        # Data sources are identified using a string generated by the server, based
+        # on the contents of the source being created. The <code>dataStreamId</code>
+        # field should not be set when invoking this method. It
+        # will be automatically generated by the server with the correct format. If
+        # a <code>dataStreamId</code> is set, it must match the format that the
+        # server would generate. This format is a combination of some fields from the
+        # data source, and has a specific order. If it doesn't match, the request
+        # will fail with an error.
+        # Specifying a DataType which is not a known type (beginning with
+        # "com.google.") will create a DataSource with a <em>custom data type</em>.
+        # Custom data types are only readable by the application that created them.
+        # Custom data types are <strong>deprecated</strong>; use standard data types
+        # instead.
         # In addition to the data source fields included in the data source ID, the
-        # developer project number that is authenticated when creating the data source
-        # is included. This developer project number is obfuscated when read by any
-        # other developer reading public data types.
+        # developer project number that is authenticated when creating the data
+        # source is included. This developer project number is obfuscated when read
+        # by any other developer reading public data types.
         # @param [String] user_id
-        #   Create the data source for the person identified. Use me to indicate the
-        #   authenticated user. Only me is supported at this time.
+        #   Create the data source for the person identified. Use <code>me</code> to
+        #   indicate the authenticated user. Only <code>me</code> is supported at this
+        #   time.
         # @param [Google::Apis::FitnessV1::DataSource] data_source_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   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
         #
@@ -101,8 +99,8 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def create_user_data_source(user_id, data_source_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:post, '{userId}/dataSources', options)
+        def create_user_data_source(user_id, data_source_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'fitness/v1/users/{userId}/dataSources', options)
           command.request_representation = Google::Apis::FitnessV1::DataSource::Representation
           command.request_object = data_source_object
           command.response_representation = Google::Apis::FitnessV1::DataSource::Representation
@@ -110,24 +108,22 @@ module Google
           command.params['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
         
-        # Deletes the specified data source. The request will fail if the data source
-        # contains any data points.
+        # Deletes the specified data source. The request will fail if the data
+        # source contains any data points.
         # @param [String] user_id
-        #   Retrieve a data source for the person identified. Use me to indicate the
-        #   authenticated user. Only me is supported at this time.
+        #   Retrieve a data source for the person identified. Use <code>me</code> to
+        #   indicate the authenticated user. Only <code>me</code> is supported at this
+        #   time.
         # @param [String] data_source_id
         #   The data stream ID of the data source to delete.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   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
         #
@@ -140,31 +136,29 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def delete_user_data_source(user_id, data_source_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:delete, '{userId}/dataSources/{dataSourceId}', options)
+        def delete_user_data_source(user_id, data_source_id, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:delete, 'fitness/v1/users/{userId}/dataSources/{dataSourceId}', options)
           command.response_representation = Google::Apis::FitnessV1::DataSource::Representation
           command.response_class = Google::Apis::FitnessV1::DataSource
           command.params['userId'] = user_id unless user_id.nil?
           command.params['dataSourceId'] = data_source_id unless data_source_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
         
         # Returns the specified data source.
         # @param [String] user_id
-        #   Retrieve a data source for the person identified. Use me to indicate the
-        #   authenticated user. Only me is supported at this time.
+        #   Retrieve a data source for the person identified. Use <code>me</code> to
+        #   indicate the authenticated user. Only <code>me</code> is supported at this
+        #   time.
         # @param [String] data_source_id
         #   The data stream ID of the data source to retrieve.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   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
         #
@@ -177,34 +171,33 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def get_user_data_source(user_id, data_source_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:get, '{userId}/dataSources/{dataSourceId}', options)
+        def get_user_data_source(user_id, data_source_id, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'fitness/v1/users/{userId}/dataSources/{dataSourceId}', options)
           command.response_representation = Google::Apis::FitnessV1::DataSource::Representation
           command.response_class = Google::Apis::FitnessV1::DataSource
           command.params['userId'] = user_id unless user_id.nil?
           command.params['dataSourceId'] = data_source_id unless data_source_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
         
         # Lists all data sources that are visible to the developer, using the OAuth
-        # scopes provided. The list is not exhaustive; the user may have private data
-        # sources that are only visible to other developers, or calls using other scopes.
+        # scopes provided. The list is not exhaustive; the user may have private
+        # data sources that are only visible to other developers, or calls using
+        # other scopes.
         # @param [String] user_id
-        #   List data sources for the person identified. Use me to indicate the
-        #   authenticated user. Only me is supported at this time.
+        #   List data sources for the person identified. Use <code>me</code> to
+        #   indicate the authenticated user. Only <code>me</code> is supported at this
+        #   time.
         # @param [Array<String>, String] data_type_name
-        #   The names of data types to include in the list. If not specified, all data
-        #   sources will be returned.
+        #   The names of data types to include in the list. If not specified, all
+        #   data sources will be returned.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   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
         #
@@ -217,35 +210,34 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def list_user_data_sources(user_id, data_type_name: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:get, '{userId}/dataSources', options)
+        def list_user_data_sources(user_id, data_type_name: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'fitness/v1/users/{userId}/dataSources', options)
           command.response_representation = Google::Apis::FitnessV1::ListDataSourcesResponse::Representation
           command.response_class = Google::Apis::FitnessV1::ListDataSourcesResponse
           command.params['userId'] = user_id unless user_id.nil?
           command.query['dataTypeName'] = data_type_name unless data_type_name.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
         
-        # Updates the specified data source. The dataStreamId, dataType, type,
-        # dataStreamName, and device properties with the exception of version, cannot be
-        # modified.
-        # Data sources are identified by their dataStreamId.
+        # Updates the specified data source. The <code>dataStreamId</code>,
+        # <code>dataType</code>, <code>type</code>, <code>dataStreamName</code>, and
+        # <code>device</code> properties with the exception of <code>version</code>,
+        # cannot be modified.
+        # Data sources are identified by their <code>dataStreamId</code>.
         # @param [String] user_id
-        #   Update the data source for the person identified. Use me to indicate the
-        #   authenticated user. Only me is supported at this time.
+        #   Update the data source for the person identified. Use <code>me</code> to
+        #   indicate the authenticated user. Only <code>me</code> is supported at this
+        #   time.
         # @param [String] data_source_id
         #   The data stream ID of the data source to update.
         # @param [Google::Apis::FitnessV1::DataSource] data_source_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   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
         #
@@ -258,8 +250,8 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def update_user_data_source(user_id, data_source_id, data_source_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:put, '{userId}/dataSources/{dataSourceId}', options)
+        def update_user_data_source(user_id, data_source_id, data_source_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:put, 'fitness/v1/users/{userId}/dataSources/{dataSourceId}', options)
           command.request_representation = Google::Apis::FitnessV1::DataSource::Representation
           command.request_object = data_source_object
           command.response_representation = Google::Apis::FitnessV1::DataSource::Representation
@@ -268,30 +260,27 @@ module Google
           command.params['dataSourceId'] = data_source_id unless data_source_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
         
         # Queries for user's data point changes for a particular data source.
         # @param [String] user_id
-        #   List data points for the person identified. Use me to indicate the
-        #   authenticated user. Only me is supported at this time.
+        #   List data points for the person identified. Use <code>me</code> to indicate
+        #   the authenticated user. Only <code>me</code> is supported at this time.
         # @param [String] data_source_id
         #   The data stream ID of the data source that created the dataset.
         # @param [Fixnum] limit
-        #   If specified, no more than this many data point changes will be included in
-        #   the response.
+        #   If specified, no more than this many data point changes will be included
+        #   in the response.
         # @param [String] page_token
-        #   The continuation token, which is used to page through large result sets. To
-        #   get the next page of results, set this parameter to the value of nextPageToken
-        #   from the previous response.
+        #   The continuation token, which is used to page through large result sets.
+        #   To get the next page of results, set this parameter to the value of
+        #   <code>nextPageToken</code> from the previous response.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   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
         #
@@ -304,8 +293,8 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def list_user_data_source_data_point_changes(user_id, data_source_id, limit: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:get, '{userId}/dataSources/{dataSourceId}/dataPointChanges', options)
+        def list_user_data_source_data_point_changes(user_id, data_source_id, limit: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'fitness/v1/users/{userId}/dataSources/{dataSourceId}/dataPointChanges', options)
           command.response_representation = Google::Apis::FitnessV1::ListDataPointChangesResponse::Representation
           command.response_class = Google::Apis::FitnessV1::ListDataPointChangesResponse
           command.params['userId'] = user_id unless user_id.nil?
@@ -314,26 +303,26 @@ module Google
           command.query['pageToken'] = page_token unless page_token.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
         
-        # Performs an inclusive delete of all data points whose start and end times have
-        # any overlap with the time range specified by the dataset ID. For most data
-        # types, the entire data point will be deleted. For data types where the time
-        # span represents a consistent value (such as com.google.activity.segment), and
-        # a data point straddles either end point of the dataset, only the overlapping
-        # portion of the data point will be deleted.
+        # Performs an inclusive delete of all data points whose start and end times
+        # have any overlap with the time range specified by the dataset ID. For most
+        # data types, the entire data point will be deleted. For data types where the
+        # time span represents a consistent value (such as
+        # <code>com.google.activity.segment</code>), and a data point straddles
+        # either end point of the dataset, only the overlapping portion of the data
+        # point will be deleted.
         # @param [String] user_id
-        #   Delete a dataset for the person identified. Use me to indicate the
-        #   authenticated user. Only me is supported at this time.
+        #   Delete a dataset for the person identified. Use <code>me</code> to indicate
+        #   the authenticated user. Only <code>me</code> is supported at this time.
         # @param [String] data_source_id
         #   The data stream ID of the data source that created the dataset.
         # @param [String] dataset_id
         #   Dataset identifier that is a composite of the minimum data point start time
-        #   and maximum data point end time represented as nanoseconds from the epoch. The
-        #   ID is formatted like: "startTime-endTime" where startTime and endTime are 64
-        #   bit integers.
+        #   and maximum data point end time represented as nanoseconds from the epoch.
+        #   The ID is formatted like: "<var>startTime</var>-<var>endTime</var>"
+        #   where <var>startTime</var> and <var>endTime</var> are 64 bit integers.
         # @param [Fixnum] current_time_millis
         #   The client's current time in milliseconds since epoch.
         # @param [Fixnum] modified_time_millis
@@ -341,10 +330,8 @@ module Google
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   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
         #
@@ -357,8 +344,8 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def delete_user_data_source_dataset(user_id, data_source_id, dataset_id, current_time_millis: nil, modified_time_millis: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:delete, '{userId}/dataSources/{dataSourceId}/datasets/{datasetId}', options)
+        def delete_user_data_source_dataset(user_id, data_source_id, dataset_id, current_time_millis: nil, modified_time_millis: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:delete, 'fitness/v1/users/{userId}/dataSources/{dataSourceId}/datasets/{datasetId}', options)
           command.params['userId'] = user_id unless user_id.nil?
           command.params['dataSourceId'] = data_source_id unless data_source_id.nil?
           command.params['datasetId'] = dataset_id unless dataset_id.nil?
@@ -366,42 +353,40 @@ module Google
           command.query['modifiedTimeMillis'] = modified_time_millis unless modified_time_millis.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
         
-        # Returns a dataset containing all data points whose start and end times overlap
-        # with the specified range of the dataset minimum start time and maximum end
-        # time. Specifically, any data point whose start time is less than or equal to
-        # the dataset end time and whose end time is greater than or equal to the
-        # dataset start time.
+        # Returns a dataset containing all data points whose start and end times
+        # overlap with the specified range of the dataset minimum start time and
+        # maximum end time. Specifically, any data point whose start time is less
+        # than or equal to the dataset end time and whose end time is greater than or
+        # equal to the dataset start time.
         # @param [String] user_id
-        #   Retrieve a dataset for the person identified. Use me to indicate the
-        #   authenticated user. Only me is supported at this time.
+        #   Retrieve a dataset for the person identified. Use <code>me</code> to
+        #   indicate the authenticated user. Only <code>me</code> is supported at this
+        #   time.
         # @param [String] data_source_id
         #   The data stream ID of the data source that created the dataset.
         # @param [String] dataset_id
         #   Dataset identifier that is a composite of the minimum data point start time
-        #   and maximum data point end time represented as nanoseconds from the epoch. The
-        #   ID is formatted like: "startTime-endTime" where startTime and endTime are 64
-        #   bit integers.
+        #   and maximum data point end time represented as nanoseconds from the epoch.
+        #   The ID is formatted like: "<var>startTime</var>-<var>endTime</var>"
+        #   where <var>startTime</var> and <var>endTime</var> are 64 bit integers.
         # @param [Fixnum] limit
         #   If specified, no more than this many data points will be included in the
-        #   dataset. If there are more data points in the dataset, nextPageToken will be
-        #   set in the dataset response.
+        #   dataset. If there are more data points in the dataset, nextPageToken
+        #   will be set in the dataset response.
         # @param [String] page_token
-        #   The continuation token, which is used to page through large datasets. To get
-        #   the next page of a dataset, set this parameter to the value of nextPageToken
-        #   from the previous response. Each subsequent call will yield a partial dataset
-        #   with data point end timestamps that are strictly smaller than those in the
-        #   previous partial response.
+        #   The continuation token, which is used to page through large datasets.
+        #   To get the next page of a dataset, set this parameter to the value of
+        #   <code>nextPageToken</code> from the previous response. Each subsequent
+        #   call will yield a partial dataset with data point end timestamps that are
+        #   strictly smaller than those in the previous partial response.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   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
         #
@@ -414,8 +399,8 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def get_user_data_source_dataset(user_id, data_source_id, dataset_id, limit: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:get, '{userId}/dataSources/{dataSourceId}/datasets/{datasetId}', options)
+        def get_user_data_source_dataset(user_id, data_source_id, dataset_id, limit: nil, page_token: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'fitness/v1/users/{userId}/dataSources/{dataSourceId}/datasets/{datasetId}', options)
           command.response_representation = Google::Apis::FitnessV1::Dataset::Representation
           command.response_class = Google::Apis::FitnessV1::Dataset
           command.params['userId'] = user_id unless user_id.nil?
@@ -425,36 +410,33 @@ module Google
           command.query['pageToken'] = page_token unless page_token.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
         
-        # Adds data points to a dataset. The dataset need not be previously created. All
-        # points within the given dataset will be returned with subsquent calls to
-        # retrieve this dataset. Data points can belong to more than one dataset. This
-        # method does not use patch semantics.
+        # Adds data points to a dataset. The dataset need not be previously created.
+        # All points within the given dataset will be returned with subsquent calls
+        # to retrieve this dataset. Data points can belong to more than one dataset.
+        # This method does not use patch semantics.
         # @param [String] user_id
-        #   Patch a dataset for the person identified. Use me to indicate the
-        #   authenticated user. Only me is supported at this time.
+        #   Patch a dataset for the person identified. Use <code>me</code> to indicate
+        #   the authenticated user. Only <code>me</code> is supported at this time.
         # @param [String] data_source_id
         #   The data stream ID of the data source that created the dataset.
         # @param [String] dataset_id
         #   Dataset identifier that is a composite of the minimum data point start time
-        #   and maximum data point end time represented as nanoseconds from the epoch. The
-        #   ID is formatted like: "startTime-endTime" where startTime and endTime are 64
-        #   bit integers.
+        #   and maximum data point end time represented as nanoseconds from the epoch.
+        #   The ID is formatted like: "<var>startTime</var>-<var>endTime</var>"
+        #   where <var>startTime</var> and <var>endTime</var> are 64 bit integers.
         # @param [Google::Apis::FitnessV1::Dataset] dataset_object
         # @param [Fixnum] current_time_millis
         #   The client's current time in milliseconds since epoch. Note that the
-        #   minStartTimeNs and maxEndTimeNs properties in the request body are in
-        #   nanoseconds instead of milliseconds.
+        #   <code>minStartTimeNs</code> and <code>maxEndTimeNs</code> properties in
+        #   the request body are in nanoseconds instead of milliseconds.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   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
         #
@@ -467,8 +449,8 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def patch_user_data_source_dataset(user_id, data_source_id, dataset_id, dataset_object = nil, current_time_millis: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:patch, '{userId}/dataSources/{dataSourceId}/datasets/{datasetId}', options)
+        def patch_user_data_source_dataset(user_id, data_source_id, dataset_id, dataset_object = nil, current_time_millis: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:patch, 'fitness/v1/users/{userId}/dataSources/{dataSourceId}/datasets/{datasetId}', options)
           command.request_representation = Google::Apis::FitnessV1::Dataset::Representation
           command.request_object = dataset_object
           command.response_representation = Google::Apis::FitnessV1::Dataset::Representation
@@ -479,7 +461,6 @@ module Google
           command.query['currentTimeMillis'] = current_time_millis unless current_time_millis.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
         
@@ -487,16 +468,14 @@ module Google
         # type of boundary. Multiple data sets of multiple types and from multiple
         # sources can be aggregated into exactly one bucket type per request.
         # @param [String] user_id
-        #   Aggregate data for the person identified. Use me to indicate the authenticated
-        #   user. Only me is supported at this time.
+        #   Aggregate data for the person identified. Use <code>me</code> to indicate
+        #   the authenticated user. Only <code>me</code> is supported at this time.
         # @param [Google::Apis::FitnessV1::AggregateRequest] aggregate_request_object
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   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
         #
@@ -509,8 +488,8 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def aggregate_dataset(user_id, aggregate_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:post, '{userId}/dataset:aggregate', options)
+        def aggregate_dataset(user_id, aggregate_request_object = nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:post, 'fitness/v1/users/{userId}/dataset:aggregate', options)
           command.request_representation = Google::Apis::FitnessV1::AggregateRequest::Representation
           command.request_object = aggregate_request_object
           command.response_representation = Google::Apis::FitnessV1::AggregateResponse::Representation
@@ -518,14 +497,13 @@ module Google
           command.params['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
         
         # Deletes a session specified by the given session ID.
         # @param [String] user_id
-        #   Delete a session for the person identified. Use me to indicate the
-        #   authenticated user. Only me is supported at this time.
+        #   Delete a session for the person identified. Use <code>me</code> to indicate
+        #   the authenticated user. Only <code>me</code> is supported at this time.
         # @param [String] session_id
         #   The ID of the session to be deleted.
         # @param [Fixnum] current_time_millis
@@ -533,10 +511,8 @@ module Google
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   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
         #
@@ -549,48 +525,49 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def delete_user_session(user_id, session_id, current_time_millis: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:delete, '{userId}/sessions/{sessionId}', options)
+        def delete_user_session(user_id, session_id, current_time_millis: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:delete, 'fitness/v1/users/{userId}/sessions/{sessionId}', options)
           command.params['userId'] = user_id unless user_id.nil?
           command.params['sessionId'] = session_id unless session_id.nil?
           command.query['currentTimeMillis'] = current_time_millis unless current_time_millis.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 sessions previously created.
         # @param [String] user_id
-        #   List sessions for the person identified. Use me to indicate the authenticated
-        #   user. Only me is supported at this time.
+        #   List sessions for the person identified. Use <code>me</code> to indicate
+        #   the authenticated user. Only <code>me</code> is supported at this time.
         # @param [Array<Fixnum>, Fixnum] activity_type
         #   If non-empty, only sessions with these activity types should be returned.
         # @param [String] end_time
-        #   An RFC3339 timestamp. Only sessions ending between the start and end times
-        #   will be included in the response.
+        #   An <a href="https://www.ietf.org/rfc/rfc3339.txt">RFC3339</a> timestamp.
+        #   Only sessions ending between the start and end times will be included in
+        #   the response. If this time is omitted but <var>startTime</var> is
+        #   specified, all sessions from <var>startTime</var> to the end of time will
+        #   be returned.
         # @param [Boolean] include_deleted
-        #   If true, deleted sessions will be returned. When set to true, sessions
-        #   returned in this response will only have an ID and will not have any other
-        #   fields.
+        #   If true, and if both <var>startTime</var> and <var>endTime</var> are
+        #   omitted, session deletions will be returned.
         # @param [String] page_token
-        #   The continuation token, which is used for incremental syncing. To get the next
-        #   batch of changes, set this parameter to the value of nextPageToken from the
-        #   previous response. This token is treated as a timestamp (in millis since epoch)
-        #   . If specified, the API returns sessions modified since this time. The page
-        #   token is ignored if either start or end time is specified. If none of start
-        #   time, end time, and the page token is specified, sessions modified in the last
+        #   The continuation token, which is used for incremental syncing.
+        #   To get the next batch of changes, set this parameter to the value of
+        #   <code>nextPageToken</code> from the previous response. The page token is
+        #   ignored if either start or end time is specified. If none of start time,
+        #   end time, and the page token is specified, sessions modified in the last
         #   30 days are returned.
         # @param [String] start_time
-        #   An RFC3339 timestamp. Only sessions ending between the start and end times
-        #   will be included in the response.
+        #   An <a href="https://www.ietf.org/rfc/rfc3339.txt">RFC3339</a> timestamp.
+        #   Only sessions ending between the start and end times will be included in
+        #   the response. If this time is omitted but <var>endTime</var> is specified,
+        #   all sessions from the start of time up to <var>endTime</var> will be
+        #   returned.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   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
         #
@@ -603,8 +580,8 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def list_user_sessions(user_id, activity_type: nil, end_time: nil, include_deleted: nil, page_token: nil, start_time: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:get, '{userId}/sessions', options)
+        def list_user_sessions(user_id, activity_type: nil, end_time: nil, include_deleted: nil, page_token: nil, start_time: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:get, 'fitness/v1/users/{userId}/sessions', options)
           command.response_representation = Google::Apis::FitnessV1::ListSessionsResponse::Representation
           command.response_class = Google::Apis::FitnessV1::ListSessionsResponse
           command.params['userId'] = user_id unless user_id.nil?
@@ -615,14 +592,13 @@ module Google
           command.query['startTime'] = start_time unless start_time.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
         
         # Updates or insert a given session.
         # @param [String] user_id
-        #   Create sessions for the person identified. Use me to indicate the
-        #   authenticated user. Only me is supported at this time.
+        #   Create sessions for the person identified. Use <code>me</code> to indicate
+        #   the authenticated user. Only <code>me</code> is supported at this time.
         # @param [String] session_id
         #   The ID of the session to be created.
         # @param [Google::Apis::FitnessV1::Session] session_object
@@ -631,10 +607,8 @@ module Google
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
-        #   An opaque string that represents a user for quota purposes. Must not exceed 40
-        #   characters.
-        # @param [String] user_ip
-        #   Deprecated. Please use quotaUser instead.
+        #   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
         #
@@ -647,8 +621,8 @@ module Google
         # @raise [Google::Apis::ServerError] An error occurred on the server and the request can be retried
         # @raise [Google::Apis::ClientError] The request is invalid and should not be retried without modification
         # @raise [Google::Apis::AuthorizationError] Authorization is required
-        def update_user_session(user_id, session_id, session_object = nil, current_time_millis: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
-          command = make_simple_command(:put, '{userId}/sessions/{sessionId}', options)
+        def update_user_session(user_id, session_id, session_object = nil, current_time_millis: nil, fields: nil, quota_user: nil, options: nil, &block)
+          command = make_simple_command(:put, 'fitness/v1/users/{userId}/sessions/{sessionId}', options)
           command.request_representation = Google::Apis::FitnessV1::Session::Representation
           command.request_object = session_object
           command.response_representation = Google::Apis::FitnessV1::Session::Representation
@@ -658,7 +632,6 @@ module Google
           command.query['currentTimeMillis'] = current_time_millis unless current_time_millis.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
 
@@ -667,7 +640,6 @@ module Google
         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