google-api-client 0.23.4 → 0.23.5

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

@@ -70,6 +70,24 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class AccountStatusItemLevelIssue
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class AccountStatusProducts
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class AccountStatusStatistics
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class AccountTax
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -1528,6 +1546,8 @@ module Google
           collection :data_quality_issues, as: 'dataQualityIssues', class: Google::Apis::ContentV2::AccountStatusDataQualityIssue, decorator: Google::Apis::ContentV2::AccountStatusDataQualityIssue::Representation
       
           property :kind, as: 'kind'
+          collection :products, as: 'products', class: Google::Apis::ContentV2::AccountStatusProducts, decorator: Google::Apis::ContentV2::AccountStatusProducts::Representation
+      
           property :website_claimed, as: 'websiteClaimed'
         end
       end
@@ -1573,6 +1593,43 @@ module Google
         end
       end
       
+      class AccountStatusItemLevelIssue
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :attribute_name, as: 'attributeName'
+          property :code, as: 'code'
+          property :description, as: 'description'
+          property :detail, as: 'detail'
+          property :documentation, as: 'documentation'
+          property :num_items, :numeric_string => true, as: 'numItems'
+          property :resolution, as: 'resolution'
+          property :servability, as: 'servability'
+        end
+      end
+      
+      class AccountStatusProducts
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :channel, as: 'channel'
+          property :country, as: 'country'
+          property :destination, as: 'destination'
+          collection :item_level_issues, as: 'itemLevelIssues', class: Google::Apis::ContentV2::AccountStatusItemLevelIssue, decorator: Google::Apis::ContentV2::AccountStatusItemLevelIssue::Representation
+      
+          property :statistics, as: 'statistics', class: Google::Apis::ContentV2::AccountStatusStatistics, decorator: Google::Apis::ContentV2::AccountStatusStatistics::Representation
+      
+        end
+      end
+      
+      class AccountStatusStatistics
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :active, :numeric_string => true, as: 'active'
+          property :disapproved, :numeric_string => true, as: 'disapproved'
+          property :expiring, :numeric_string => true, as: 'expiring'
+          property :pending, :numeric_string => true, as: 'pending'
+        end
+      end
+      
       class AccountTax
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -2918,6 +2975,7 @@ module Google
       class OrdersCreateTestOrderRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :country, as: 'country'
           property :template_name, as: 'templateName'
           property :test_order, as: 'testOrder', class: Google::Apis::ContentV2::TestOrder, decorator: Google::Apis::ContentV2::TestOrder::Representation
       
@@ -3673,6 +3731,7 @@ module Google
           property :size_system, as: 'sizeSystem'
           property :size_type, as: 'sizeType'
           collection :sizes, as: 'sizes'
+          property :source, as: 'source'
           property :target_country, as: 'targetCountry'
           collection :taxes, as: 'taxes', class: Google::Apis::ContentV2::ProductTax, decorator: Google::Apis::ContentV2::ProductTax::Representation
       

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

@@ -1790,7 +1790,9 @@ module Google
         end
         
         # Creates a refund invoice for one or more shipment groups, and triggers a
-        # refund for non-facilitated payment orders.
+        # refund for non-facilitated payment orders. This can only be used for line
+        # items that have previously been charged using createChargeInvoice. All amounts
+        # (except for the summary) are incremental with respect to the previous invoice.
         # @param [Fixnum] merchant_id
         #   The ID of the account that manages the order. This cannot be a multi-client
         #   account.
@@ -2299,6 +2301,8 @@ module Google
         #   client account.
         # @param [String] template_name
         #   The name of the template to retrieve.
+        # @param [String] country
+        #   The country of the template to retrieve. Defaults to US.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -2318,12 +2322,13 @@ 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_test_order_template(merchant_id, template_name, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+        def get_test_order_template(merchant_id, template_name, country: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
           command =  make_simple_command(:get, '{merchantId}/testordertemplates/{templateName}', options)
           command.response_representation = Google::Apis::ContentV2::OrdersGetTestOrderTemplateResponse::Representation
           command.response_class = Google::Apis::ContentV2::OrdersGetTestOrderTemplateResponse
           command.params['merchantId'] = merchant_id unless merchant_id.nil?
           command.params['templateName'] = template_name unless template_name.nil?
+          command.query['country'] = country unless country.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?
@@ -2442,7 +2447,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Refund a portion of the order, up to the full amount paid.
+        # Deprecated, please use returnRefundLineItem instead.
         # @param [Fixnum] merchant_id
         #   The ID of the account that manages the order. This cannot be a multi-client
         #   account.

data/generated/google/apis/content_v2sandbox.rb

@@ -26,7 +26,7 @@ module Google
     # @see https://developers.google.com/shopping-content
     module ContentV2sandbox
       VERSION = 'V2sandbox'
-      REVISION = ''
+      REVISION = '20180809'
 
       # Manage your product listings and accounts for Google Shopping
       AUTH_CONTENT = 'https://www.googleapis.com/auth/content'

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

@@ -118,23 +118,25 @@ module Google
         # @return [Array<Google::Apis::ContentV2sandbox::InvoiceSummaryAdditionalChargeSummary>]
         attr_accessor :additional_charge_summaries
       
-        # [required] Customer balance on this invoice. A positive amount means the
-        # customer is paying, a negative one means the customer is receiving money. Note:
+        # [required] Customer balance on this invoice. A negative amount means the
+        # customer is paying, a positive one means the customer is receiving money. Note:
         # the sum of merchant_balance, customer_balance and google_balance must always
         # be zero.
+        # Furthermore the absolute value of this amount is expected to be equal to the
+        # sum of product amount and additional charges, minus promotions.
         # Corresponds to the JSON property `customerBalance`
         # @return [Google::Apis::ContentV2sandbox::Amount]
         attr_accessor :customer_balance
       
-        # [required] Google balance on this invoice. A positive amount means Google is
-        # paying, a negative one means Google is receiving money. Note: the sum of
+        # [required] Google balance on this invoice. A negative amount means Google is
+        # paying, a positive one means Google is receiving money. Note: the sum of
         # merchant_balance, customer_balance and google_balance must always be zero.
         # Corresponds to the JSON property `googleBalance`
         # @return [Google::Apis::ContentV2sandbox::Amount]
         attr_accessor :google_balance
       
-        # [required] Merchant balance on this invoice. A positive amount means the
-        # merchant is paying, a negative one means the merchant is receiving money. Note:
+        # [required] Merchant balance on this invoice. A negative amount means the
+        # merchant is paying, a positive one means the merchant is receiving money. Note:
         # the sum of merchant_balance, customer_balance and google_balance must always
         # be zero.
         # Corresponds to the JSON property `merchantBalance`
@@ -370,7 +372,8 @@ module Google
         # @return [String]
         attr_accessor :recipient_name
       
-        # Top-level administrative subdivision of the country (e.g. "CA").
+        # Top-level administrative subdivision of the country. For example, a state like
+        # California ("CA") or a province like Quebec ("QC").
         # Corresponds to the JSON property `region`
         # @return [String]
         attr_accessor :region
@@ -1719,9 +1722,7 @@ module Google
       class OrdersCancelLineItemRequest
         include Google::Apis::Core::Hashable
       
-        # Amount to refund for the cancelation. Optional. If not set, Google will
-        # calculate the default based on the price and tax of the items involved. The
-        # amount must not be larger than the net amount left on the order.
+        # Deprecated. Please use amountPretax and amountTax instead.
         # Corresponds to the JSON property `amount`
         # @return [Google::Apis::ContentV2sandbox::Price]
         attr_accessor :amount
@@ -1874,6 +1875,16 @@ module Google
       class OrdersCreateTestOrderRequest
         include Google::Apis::Core::Hashable
       
+        # The  CLDR territory code of the country of the test order to create. Affects
+        # the currency and addresses of orders created via template_name, or the
+        # addresses of orders created via test_order.
+        # Acceptable values are:
+        # - "US"
+        # - "FR"  Defaults to US.
+        # Corresponds to the JSON property `country`
+        # @return [String]
+        attr_accessor :country
+      
         # The test order template to use. Specify as an alternative to testOrder as a
         # shortcut for retrieving a template and then creating an order using that
         # template.
@@ -1892,6 +1903,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @country = args[:country] if args.key?(:country)
           @template_name = args[:template_name] if args.key?(:template_name)
           @test_order = args[:test_order] if args.key?(:test_order)
         end
@@ -2088,9 +2100,7 @@ module Google
       class OrdersCustomBatchRequestEntryCancelLineItem
         include Google::Apis::Core::Hashable
       
-        # Amount to refund for the cancelation. Optional. If not set, Google will
-        # calculate the default based on the price and tax of the items involved. The
-        # amount must not be larger than the net amount left on the order.
+        # Deprecated. Please use amountPretax and amountTax instead.
         # Corresponds to the JSON property `amount`
         # @return [Google::Apis::ContentV2sandbox::Price]
         attr_accessor :amount
@@ -2210,7 +2220,7 @@ module Google
       class OrdersCustomBatchRequestEntryRefund
         include Google::Apis::Core::Hashable
       
-        # The amount that is refunded.
+        # Deprecated. Please use amountPretax and amountTax instead.
         # Corresponds to the JSON property `amount`
         # @return [Google::Apis::ContentV2sandbox::Price]
         attr_accessor :amount
@@ -2342,7 +2352,8 @@ module Google
       class OrdersCustomBatchRequestEntryReturnRefundLineItem
         include Google::Apis::Core::Hashable
       
-        # The amount that is refunded. Optional, but if filled then both amountPretax
+        # The amount that is refunded. If omitted, refundless return is assumed (same as
+        # calling returnLineItem method). Optional, but if filled then both amountPretax
         # and amountTax must be set.
         # Corresponds to the JSON property `amountPretax`
         # @return [Google::Apis::ContentV2sandbox::Price]
@@ -2639,8 +2650,9 @@ module Google
         # @return [Google::Apis::ContentV2sandbox::Errors]
         attr_accessor :errors
       
-        # The status of the execution. Only defined if the method is not get or
-        # getByMerchantOrderId and if the request was successful.
+        # The status of the execution. Only defined if
+        # - the request was successful; and
+        # - the method is not get, getByMerchantOrderId, or one of the test methods.
         # Corresponds to the JSON property `executionStatus`
         # @return [String]
         attr_accessor :execution_status
@@ -2847,7 +2859,7 @@ module Google
       class OrdersRefundRequest
         include Google::Apis::Core::Hashable
       
-        # The amount that is refunded.
+        # Deprecated. Please use amountPretax and amountTax instead.
         # Corresponds to the JSON property `amount`
         # @return [Google::Apis::ContentV2sandbox::Price]
         attr_accessor :amount
@@ -3075,7 +3087,8 @@ module Google
       class OrdersReturnRefundLineItemRequest
         include Google::Apis::Core::Hashable
       
-        # The amount that is refunded. Optional, but if filled then both amountPretax
+        # The amount that is refunded. If omitted, refundless return is assumed (same as
+        # calling returnLineItem method). Optional, but if filled then both amountPretax
         # and amountTax must be set.
         # Corresponds to the JSON property `amountPretax`
         # @return [Google::Apis::ContentV2sandbox::Price]

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

@@ -1143,6 +1143,7 @@ module Google
       class OrdersCreateTestOrderRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          property :country, as: 'country'
           property :template_name, as: 'templateName'
           property :test_order, as: 'testOrder', class: Google::Apis::ContentV2sandbox::TestOrder, decorator: Google::Apis::ContentV2sandbox::TestOrder::Representation
       

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

@@ -94,7 +94,9 @@ module Google
         end
         
         # Creates a refund invoice for one or more shipment groups, and triggers a
-        # refund for non-facilitated payment orders.
+        # refund for non-facilitated payment orders. This can only be used for line
+        # items that have previously been charged using createChargeInvoice. All amounts
+        # (except for the summary) are incremental with respect to the previous invoice.
         # @param [Fixnum] merchant_id
         #   The ID of the account that manages the order. This cannot be a multi-client
         #   account.
@@ -603,6 +605,8 @@ module Google
         #   client account.
         # @param [String] template_name
         #   The name of the template to retrieve.
+        # @param [String] country
+        #   The country of the template to retrieve. Defaults to US.
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -622,12 +626,13 @@ 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 gettestordertemplate_order(merchant_id, template_name, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+        def gettestordertemplate_order(merchant_id, template_name, country: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
           command =  make_simple_command(:get, '{merchantId}/testordertemplates/{templateName}', options)
           command.response_representation = Google::Apis::ContentV2sandbox::OrdersGetTestOrderTemplateResponse::Representation
           command.response_class = Google::Apis::ContentV2sandbox::OrdersGetTestOrderTemplateResponse
           command.params['merchantId'] = merchant_id unless merchant_id.nil?
           command.params['templateName'] = template_name unless template_name.nil?
+          command.query['country'] = country unless country.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?
@@ -746,7 +751,7 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # Refund a portion of the order, up to the full amount paid.
+        # Deprecated, please use returnRefundLineItem instead.
         # @param [Fixnum] merchant_id
         #   The ID of the account that manages the order. This cannot be a multi-client
         #   account.

data/generated/google/apis/customsearch_v1.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://developers.google.com/custom-search/v1/using_rest
     module CustomsearchV1
       VERSION = 'V1'
-      REVISION = ''
+      REVISION = '20180815'
     end
   end
 end

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

@@ -87,8 +87,8 @@ module Google
         # @param [String] img_color_type
         #   Returns black and white, grayscale, or color images: mono, gray, and color.
         # @param [String] img_dominant_color
-        #   Returns images of a specific dominant color: yellow, green, teal, blue, purple,
-        #   pink, white, gray, black and brown.
+        #   Returns images of a specific dominant color: red, orange, yellow, green, teal,
+        #   blue, purple, pink, white, gray, black and brown.
         # @param [String] img_size
         #   Returns images of a specified size, where size can be one of: icon, small,
         #   medium, large, xlarge, xxlarge, and huge.
@@ -188,9 +188,9 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
-        # (Closed Beta API) Returns metadata about the search performed, metadata about
-        # the custom search engine used for the search, and the search results only for
-        # site-restrict cses.
+        # Returns metadata about the search performed, metadata about the custom search
+        # engine used for the search, and the search results. Uses a small set of url
+        # patterns.
         # @param [String] q
         #   Query
         # @param [String] c2coff
@@ -225,8 +225,8 @@ module Google
         # @param [String] img_color_type
         #   Returns black and white, grayscale, or color images: mono, gray, and color.
         # @param [String] img_dominant_color
-        #   Returns images of a specific dominant color: yellow, green, teal, blue, purple,
-        #   pink, white, gray, black and brown.
+        #   Returns images of a specific dominant color: red, orange, yellow, green, teal,
+        #   blue, purple, pink, white, gray, black and brown.
         # @param [String] img_size
         #   Returns images of a specified size, where size can be one of: icon, small,
         #   medium, large, xlarge, xxlarge, and huge.

data/generated/google/apis/dataproc_v1beta2.rb

@@ -25,7 +25,7 @@ module Google
     # @see https://cloud.google.com/dataproc/
     module DataprocV1beta2
       VERSION = 'V1beta2'
-      REVISION = '20180702'
+      REVISION = '20180803'
 
       # View and manage your data across Google Cloud Platform services
       AUTH_CLOUD_PLATFORM = 'https://www.googleapis.com/auth/cloud-platform'

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

@@ -59,6 +59,14 @@ module Google
       class Binding
         include Google::Apis::Core::Hashable
       
+        # Represents an expression text. Example:
+        # title: "User account presence"
+        # description: "Determines whether the request has a user account"
+        # expression: "size(request.user) > 0"
+        # Corresponds to the JSON property `condition`
+        # @return [Google::Apis::DataprocV1beta2::Expr]
+        attr_accessor :condition
+      
         # Specifies the identities requesting access for a Cloud Platform resource.
         # members can have the following values:
         # allUsers: A special identifier that represents anyone who is  on the internet;
@@ -89,6 +97,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @condition = args[:condition] if args.key?(:condition)
           @members = args[:members] if args.key?(:members)
           @role = args[:role] if args.key?(:role)
         end
@@ -594,6 +603,51 @@ module Google
         end
       end
       
+      # Represents an expression text. Example:
+      # title: "User account presence"
+      # description: "Determines whether the request has a user account"
+      # expression: "size(request.user) > 0"
+      class Expr
+        include Google::Apis::Core::Hashable
+      
+        # An optional description of the expression. This is a longer text which
+        # describes the expression, e.g. when hovered over it in a UI.
+        # Corresponds to the JSON property `description`
+        # @return [String]
+        attr_accessor :description
+      
+        # Textual representation of an expression in Common Expression Language syntax.
+        # The application context of the containing message determines which well-known
+        # feature set of CEL is supported.
+        # Corresponds to the JSON property `expression`
+        # @return [String]
+        attr_accessor :expression
+      
+        # An optional string indicating the location of the expression for error
+        # reporting, e.g. a file name and a position in the file.
+        # Corresponds to the JSON property `location`
+        # @return [String]
+        attr_accessor :location
+      
+        # An optional title for the expression, i.e. a short string describing its
+        # purpose. This can be used e.g. in UIs which allow to enter the expression.
+        # Corresponds to the JSON property `title`
+        # @return [String]
+        attr_accessor :title
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @description = args[:description] if args.key?(:description)
+          @expression = args[:expression] if args.key?(:expression)
+          @location = args[:location] if args.key?(:location)
+          @title = args[:title] if args.key?(:title)
+        end
+      end
+      
       # Common config settings for resources of Compute Engine cluster instances,
       # applicable to all instances in the cluster.
       class GceClusterConfig
@@ -935,12 +989,7 @@ module Google
       class InstantiateWorkflowTemplateRequest
         include Google::Apis::Core::Hashable
       
-        # Optional. A tag that prevents multiple concurrent workflow instances with the
-        # same tag from running. This mitigates risk of concurrent instances started due
-        # to retries.It is recommended to always set this value to a UUID (https://en.
-        # wikipedia.org/wiki/Universally_unique_identifier).The tag must contain only
-        # letters (a-z, A-Z), numbers (0-9), underscores (_), and hyphens (-). The
-        # maximum length is 40 characters.
+        # Deprecated. Please use request_id field instead.
         # Corresponds to the JSON property `instanceId`
         # @return [String]
         attr_accessor :instance_id
@@ -951,6 +1000,16 @@ module Google
         # @return [Hash<String,String>]
         attr_accessor :parameters
       
+        # Optional. A tag that prevents multiple concurrent workflow instances with the
+        # same tag from running. This mitigates risk of concurrent instances started due
+        # to retries.It is recommended to always set this value to a UUID (https://en.
+        # wikipedia.org/wiki/Universally_unique_identifier).The tag must contain only
+        # letters (a-z, A-Z), numbers (0-9), underscores (_), and hyphens (-). The
+        # maximum length is 40 characters.
+        # Corresponds to the JSON property `requestId`
+        # @return [String]
+        attr_accessor :request_id
+      
         # Optional. The version of workflow template to instantiate. If specified, the
         # workflow will be instantiated only if the current version of the workflow
         # template has the supplied version.This option cannot be used to instantiate a
@@ -967,6 +1026,7 @@ module Google
         def update!(**args)
           @instance_id = args[:instance_id] if args.key?(:instance_id)
           @parameters = args[:parameters] if args.key?(:parameters)
+          @request_id = args[:request_id] if args.key?(:request_id)
           @version = args[:version] if args.key?(:version)
         end
       end
@@ -1912,8 +1972,8 @@ module Google
         include Google::Apis::Core::Hashable
       
         # Required. RE2 regular expressions used to validate the parameter's value. The
-        # provided value must match the regexes in its entirety, e.g. substring matches
-        # are not enough.
+        # value must match the regex in its entirety (substring matches are not
+        # sufficient).
         # Corresponds to the JSON property `regexes`
         # @return [Array<String>]
         attr_accessor :regexes
@@ -2244,50 +2304,59 @@ module Google
       end
       
       # A configurable parameter that replaces one or more fields in the template.
+      # Parameterizable fields: - Labels - File uris - Job properties - Job arguments -
+      # Script variables - Main class (in HadoopJob and SparkJob) - Zone (in
+      # ClusterSelector)
       class TemplateParameter
         include Google::Apis::Core::Hashable
       
-        # Optional. User-friendly description of the parameter. Must not exceed 1024
-        # characters.
+        # Optional. Brief description of the parameter. Must not exceed 1024 characters.
         # Corresponds to the JSON property `description`
         # @return [String]
         attr_accessor :description
       
-        # Required. Paths to all fields that this parameter replaces. Each field may
-        # appear in at most one Parameter's fields list.Field path syntax:A field path
-        # is similar to a FieldMask. For example, a field path that references the zone
-        # field of the template's cluster selector would look like:placement.
-        # clusterSelector.zoneThe only differences between field paths and standard
-        # field masks are that:
-        # Values in maps can be referenced by key.Example: placement.clusterSelector.
-        # clusterLabels'key'
-        # Jobs in the jobs list can be referenced by step id.Example: jobs'step-id'.
-        # hadoopJob.mainJarFileUri
-        # Items in repeated fields can be referenced by zero-based index.Example: jobs'
-        # step-id'.sparkJob.args0NOTE: Maps and repeated fields may not be parameterized
-        # in their entirety. Only individual map values and items in repeated fields may
-        # be referenced. For example, the following field paths are invalid: - placement.
-        # clusterSelector.clusterLabels - jobs'step-id'.sparkJob.argsParameterizable
-        # fields:Only certain types of fields may be parameterized, specifically: -
-        # Labels - File uris - Job properties - Job arguments - Script variables - Main
-        # class (in HadoopJob and SparkJob) - Zone (in ClusterSelector)Examples of
-        # parameterizable fields:Labels:labels'key' placement.managedCluster.labels'key'
-        # placement.clusterSelector.clusterLabels'key' jobs'step-id'.labels'key'File
-        # uris:jobs'step-id'.hadoopJob.mainJarFileUri jobs'step-id'.hiveJob.queryFileUri
-        # jobs'step-id'.pySparkJob.mainPythonFileUri jobs'step-id'.hadoopJob.
-        # jarFileUris0 jobs'step-id'.hadoopJob.archiveUris0 jobs'step-id'.hadoopJob.
-        # fileUris0 jobs'step-id'.pySparkJob.pythonFileUris0Other:jobs'step-id'.
-        # hadoopJob.properties'key' jobs'step-id'.hadoopJob.args0 jobs'step-id'.hiveJob.
-        # scriptVariables'key' jobs'step-id'.hadoopJob.mainJarFileUri placement.
-        # clusterSelector.zone
+        # Required. Paths to all fields that the parameter replaces. A field is allowed
+        # to appear in at most one parameter's list of field paths.A field path is
+        # similar in syntax to a google.protobuf.FieldMask. For example, a field path
+        # that references the zone field of a workflow template's cluster selector would
+        # be specified as <code>placement.clusterSelector.zone</code>.Also, field paths
+        # can reference fields using the following syntax:
+        # Values in maps can be referenced by key. Examples<br>
+        # labels'key'
+        # placement.clusterSelector.clusterLabels'key'
+        # placement.managedCluster.labels'key'
+        # placement.clusterSelector.clusterLabels'key'
+        # jobsstep-id.labels'key'
+        # Jobs in the jobs list can be referenced by step-id. Examples:<br>
+        # jobsstep-id.hadoopJob.mainJarFileUri
+        # jobsstep-id.hiveJob.queryFileUri
+        # jobsstep-id.pySparkJob.mainPythonFileUri
+        # jobsstep-id.hadoopJob.jarFileUris0
+        # jobsstep-id.hadoopJob.archiveUris0
+        # jobsstep-id.hadoopJob.fileUris0
+        # jobsstep-id.pySparkJob.pythonFileUris0
+        # Items in repeated fields can be referenced by a zero-based index. Example:<br>
+        # jobsstep-id.sparkJob.args0
+        # Other examples:
+        # jobsstep-id.hadoopJob.properties'key'
+        # jobsstep-id.hadoopJob.args0
+        # jobsstep-id.hiveJob.scriptVariables'key'
+        # jobsstep-id.hadoopJob.mainJarFileUri
+        # placement.clusterSelector.zoneIt may not be possible to parameterize maps and
+        # repeated fields in their entirety since only individual map values and
+        # individual items in repeated fields can be referenced. For example, the
+        # following field paths are invalid:
+        # placement.clusterSelector.clusterLabels
+        # jobsstep-id.sparkJob.args
         # Corresponds to the JSON property `fields`
         # @return [Array<String>]
         attr_accessor :fields
       
-        # Required. User-friendly parameter name. This name is used as a key when
-        # providing a value for this parameter when the template is instantiated. Must
-        # contain only capital letters (A-Z), numbers (0-9), and underscores (_), and
-        # must not start with a number. The maximum length is 40 characters.
+        # Required. Parameter name. The parameter name is used as the key, and paired
+        # with the parameter value, which are passed to the template when the template
+        # is instantiated. The name must contain only capital letters (A-Z), numbers (0-
+        # 9), and underscores (_), and must not start with a number. The maximum length
+        # is 40 characters.
         # Corresponds to the JSON property `name`
         # @return [String]
         attr_accessor :name
@@ -2354,7 +2423,7 @@ module Google
       class ValueValidation
         include Google::Apis::Core::Hashable
       
-        # Required. List of allowed values for this parameter.
+        # Required. List of allowed values for the parameter.
         # Corresponds to the JSON property `values`
         # @return [Array<String>]
         attr_accessor :values
@@ -2531,7 +2600,7 @@ module Google
         attr_accessor :name
       
         # Optional. Template parameters whose values are substituted into the template.
-        # Values for these parameters must be provided when the template is instantiated.
+        # Values for parameters must be provided when the template is instantiated.
         # Corresponds to the JSON property `parameters`
         # @return [Array<Google::Apis::DataprocV1beta2::TemplateParameter>]
         attr_accessor :parameters