google-api-client 0.42.1 → 0.44.2

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

@@ -184,6 +184,18 @@ module Google
         include Google::Apis::Core::JsonObjectSupport
       end
       
+      class AccountsUpdateLabelsRequest
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
+      class AccountsUpdateLabelsResponse
+        class Representation < Google::Apis::Core::JsonRepresentation; end
+      
+        include Google::Apis::Core::JsonObjectSupport
+      end
+      
       class AccountstatusesCustomBatchRequest
         class Representation < Google::Apis::Core::JsonRepresentation; end
       
@@ -1800,10 +1812,12 @@ module Google
           property :adult_content, as: 'adultContent'
           property :business_information, as: 'businessInformation', class: Google::Apis::ContentV2_1::AccountBusinessInformation, decorator: Google::Apis::ContentV2_1::AccountBusinessInformation::Representation
       
+          property :css_id, :numeric_string => true, as: 'cssId'
           property :google_my_business_link, as: 'googleMyBusinessLink', class: Google::Apis::ContentV2_1::AccountGoogleMyBusinessLink, decorator: Google::Apis::ContentV2_1::AccountGoogleMyBusinessLink::Representation
       
           property :id, :numeric_string => true, as: 'id'
           property :kind, as: 'kind'
+          collection :label_ids, as: 'labelIds'
           property :name, as: 'name'
           property :seller_id, as: 'sellerId'
           collection :users, as: 'users', class: Google::Apis::ContentV2_1::AccountUser, decorator: Google::Apis::ContentV2_1::AccountUser::Representation
@@ -2005,11 +2019,13 @@ module Google
           property :account_id, :numeric_string => true, as: 'accountId'
           property :batch_id, as: 'batchId'
           property :force, as: 'force'
+          collection :label_ids, as: 'labelIds'
           property :link_request, as: 'linkRequest', class: Google::Apis::ContentV2_1::AccountsCustomBatchRequestEntryLinkRequest, decorator: Google::Apis::ContentV2_1::AccountsCustomBatchRequestEntryLinkRequest::Representation
       
           property :merchant_id, :numeric_string => true, as: 'merchantId'
           property :method_prop, as: 'method'
           property :overwrite, as: 'overwrite'
+          property :view, as: 'view'
         end
       end
       
@@ -2081,6 +2097,20 @@ module Google
         end
       end
       
+      class AccountsUpdateLabelsRequest
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          collection :label_ids, as: 'labelIds'
+        end
+      end
+      
+      class AccountsUpdateLabelsResponse
+        # @private
+        class Representation < Google::Apis::Core::JsonRepresentation
+          property :kind, as: 'kind'
+        end
+      end
+      
       class AccountstatusesCustomBatchRequest
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
@@ -3413,6 +3443,7 @@ module Google
           property :full_refund, as: 'fullRefund'
           property :partial_refund, as: 'partialRefund', class: Google::Apis::ContentV2_1::OrderreturnsPartialRefund, decorator: Google::Apis::ContentV2_1::OrderreturnsPartialRefund::Representation
       
+          property :payment_type, as: 'paymentType'
           property :reason_text, as: 'reasonText'
           property :return_refund_reason, as: 'returnRefundReason'
         end
@@ -4124,6 +4155,7 @@ module Google
       
           property :shipping_width, as: 'shippingWidth', class: Google::Apis::ContentV2_1::ProductShippingDimension, decorator: Google::Apis::ContentV2_1::ProductShippingDimension::Representation
       
+          collection :shopping_ads_excluded_countries, as: 'shoppingAdsExcludedCountries'
           property :size_system, as: 'sizeSystem'
           property :size_type, as: 'sizeType'
           collection :sizes, as: 'sizes'
@@ -4214,7 +4246,10 @@ module Google
       class ProductStatusDestinationStatus
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          collection :approved_countries, as: 'approvedCountries'
           property :destination, as: 'destination'
+          collection :disapproved_countries, as: 'disapprovedCountries'
+          collection :pending_countries, as: 'pendingCountries'
           property :status, as: 'status'
         end
       end
@@ -4222,6 +4257,7 @@ module Google
       class ProductStatusItemLevelIssue
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
+          collection :applicable_countries, as: 'applicableCountries'
           property :attribute_name, as: 'attributeName'
           property :code, as: 'code'
           property :description, as: 'description'

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

@@ -204,6 +204,9 @@ module Google
         #   ID of a sub-account of this account.
         # @param [Fixnum] account_id
         #   The ID of the account.
+        # @param [String] view
+        #   Controls which fields will be populated. Acceptable values are: "merchant" and
+        #   "css". The default value is "merchant".
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -223,12 +226,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_account(merchant_id, account_id, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+        def get_account(merchant_id, account_id, view: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
           command = make_simple_command(:get, '{merchantId}/accounts/{accountId}', options)
           command.response_representation = Google::Apis::ContentV2_1::Account::Representation
           command.response_class = Google::Apis::ContentV2_1::Account
           command.params['merchantId'] = merchant_id unless merchant_id.nil?
           command.params['accountId'] = account_id unless account_id.nil?
+          command.query['view'] = view unless view.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?
@@ -316,10 +320,16 @@ module Google
         # Lists the sub-accounts in your Merchant Center account.
         # @param [Fixnum] merchant_id
         #   The ID of the managing account. This must be a multi-client account.
+        # @param [Fixnum] label
+        #   If view is set to "css", only return accounts that are assigned label with
+        #   given ID.
         # @param [Fixnum] max_results
         #   The maximum number of accounts to return in the response, used for paging.
         # @param [String] page_token
         #   The token returned by the previous request.
+        # @param [String] view
+        #   Controls which fields will be populated. Acceptable values are: "merchant" and
+        #   "css". The default value is "merchant".
         # @param [String] fields
         #   Selector specifying which fields to include in a partial response.
         # @param [String] quota_user
@@ -339,13 +349,15 @@ 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_accounts(merchant_id, max_results: nil, page_token: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+        def list_accounts(merchant_id, label: nil, max_results: nil, page_token: nil, view: nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
           command = make_simple_command(:get, '{merchantId}/accounts', options)
           command.response_representation = Google::Apis::ContentV2_1::AccountsListResponse::Representation
           command.response_class = Google::Apis::ContentV2_1::AccountsListResponse
           command.params['merchantId'] = merchant_id unless merchant_id.nil?
+          command.query['label'] = label unless label.nil?
           command.query['maxResults'] = max_results unless max_results.nil?
           command.query['pageToken'] = page_token unless page_token.nil?
+          command.query['view'] = view unless view.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?
@@ -438,6 +450,45 @@ module Google
           execute_or_queue_command(command, &block)
         end
         
+        # Updates labels that are assigned to the Merchant Center account by CSS user.
+        # @param [Fixnum] merchant_id
+        #   The ID of the managing account.
+        # @param [Fixnum] account_id
+        #   The ID of the account whose labels are updated.
+        # @param [Google::Apis::ContentV2_1::AccountsUpdateLabelsRequest] accounts_update_labels_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.
+        # @param [Google::Apis::RequestOptions] options
+        #   Request-specific options
+        #
+        # @yield [result, err] Result & error if block supplied
+        # @yieldparam result [Google::Apis::ContentV2_1::AccountsUpdateLabelsResponse] parsed result object
+        # @yieldparam err [StandardError] error object if request failed
+        #
+        # @return [Google::Apis::ContentV2_1::AccountsUpdateLabelsResponse]
+        #
+        # @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 updatelabels_account(merchant_id, account_id, accounts_update_labels_request_object = nil, fields: nil, quota_user: nil, user_ip: nil, options: nil, &block)
+          command = make_simple_command(:post, '{merchantId}/accounts/{accountId}/updatelabels', options)
+          command.request_representation = Google::Apis::ContentV2_1::AccountsUpdateLabelsRequest::Representation
+          command.request_object = accounts_update_labels_request_object
+          command.response_representation = Google::Apis::ContentV2_1::AccountsUpdateLabelsResponse::Representation
+          command.response_class = Google::Apis::ContentV2_1::AccountsUpdateLabelsResponse
+          command.params['merchantId'] = merchant_id unless merchant_id.nil?
+          command.params['accountId'] = account_id unless account_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
+        
         # Retrieves multiple Merchant Center account statuses in a single request.
         # @param [Google::Apis::ContentV2_1::AccountstatusesCustomBatchRequest] accountstatuses_custom_batch_request_object
         # @param [String] fields

data/generated/google/apis/customsearch_v1.rb

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

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

@@ -26,10 +26,9 @@ module Google
       class Promotion
         include Google::Apis::Core::Hashable
       
-        # An array of block objects for this promotion. See [Google WebSearch
-        # Protocol
-        # reference](https://developers.google.com/custom-search/docs/xml_results)
-        # for more information.
+        # An array of block objects for this promotion. See [Google WebSearch Protocol
+        # reference](https://developers.google.com/custom-search/docs/xml_results) for
+        # more information.
         # Corresponds to the JSON property `bodyLines`
         # @return [Array<Google::Apis::CustomsearchV1::Promotion::BodyLine>]
         attr_accessor :body_lines
@@ -186,20 +185,20 @@ module Google
         # @return [Google::Apis::CustomsearchV1::Result::Image]
         attr_accessor :image
       
-        # A unique identifier for the type of current object. For this API, it is
-        # `customsearch#result.`
+        # A unique identifier for the type of current object. For this API, it is `
+        # customsearch#result.`
         # Corresponds to the JSON property `kind`
         # @return [String]
         attr_accessor :kind
       
-        # Encapsulates all information about [refinement
-        # labels](https://developers.google.com/custom-search/docs/xml_results).
+        # Encapsulates all information about [refinement labels](https://developers.
+        # google.com/custom-search/docs/xml_results).
         # Corresponds to the JSON property `labels`
         # @return [Array<Google::Apis::CustomsearchV1::Result::Label>]
         attr_accessor :labels
       
-        # The full URL to which the search result is pointing, e.g.
-        # http://www.example.com/foo/bar.
+        # The full URL to which the search result is pointing, e.g. http://www.example.
+        # com/foo/bar.
         # Corresponds to the JSON property `link`
         # @return [String]
         attr_accessor :link
@@ -209,10 +208,8 @@ module Google
         # @return [String]
         attr_accessor :mime
       
-        # Contains
-        # [PageMap](https://developers.google.com/custom-search/docs/structured_data#
-        # pagemaps)
-        # information for this search result.
+        # Contains [PageMap](https://developers.google.com/custom-search/docs/
+        # structured_data#pagemaps) information for this search result.
         # Corresponds to the JSON property `pagemap`
         # @return [Hash<String,Object>]
         attr_accessor :pagemap
@@ -309,8 +306,8 @@ module Google
         class Label
           include Google::Apis::Core::Hashable
         
-          # The display name of a refinement label. This is the name you should
-          # display in your user interface.
+          # The display name of a refinement label. This is the name you should display in
+          # your user interface.
           # Corresponds to the JSON property `displayName`
           # @return [String]
           attr_accessor :display_name
@@ -320,8 +317,8 @@ module Google
           # @return [String]
           attr_accessor :label_with_op
         
-          # The name of a refinement label, which you can use to refine searches.
-          # Don't display this in your user interface; instead, use displayName.
+          # The name of a refinement label, which you can use to refine searches. Don't
+          # display this in your user interface; instead, use displayName.
           # Corresponds to the JSON property `name`
           # @return [String]
           attr_accessor :name
@@ -343,12 +340,10 @@ module Google
       class Search
         include Google::Apis::Core::Hashable
       
-        # Metadata and refinements associated with the given search engine,
-        # including:
-        # * The name of the search engine that was used for the query.
-        # *   A set of [facet
-        # objects](https://developers.google.com/custom-search/docs/refinements#create)
-        # (refinements) you can use for refining a search.
+        # Metadata and refinements associated with the given search engine, including: *
+        # The name of the search engine that was used for the query. * A set of [facet
+        # objects](https://developers.google.com/custom-search/docs/refinements#create) (
+        # refinements) you can use for refining a search.
         # Corresponds to the JSON property `context`
         # @return [Hash<String,Object>]
         attr_accessor :context
@@ -364,10 +359,9 @@ module Google
         # @return [String]
         attr_accessor :kind
       
-        # The set of
-        # [promotions](https://developers.google.com/custom-search/docs/promotions).
-        # Present only if the custom search engine's configuration files define any
-        # promotions for the given query.
+        # The set of [promotions](https://developers.google.com/custom-search/docs/
+        # promotions). Present only if the custom search engine's configuration files
+        # define any promotions for the given query.
         # Corresponds to the JSON property `promotions`
         # @return [Array<Google::Apis::CustomsearchV1::Promotion>]
         attr_accessor :promotions
@@ -447,190 +441,140 @@ module Google
             # @return [Fixnum]
             attr_accessor :count
           
-            # Restricts search results to documents originating in a particular
-            # country. You may use [Boolean
-            # operators](https://developers.google.com/custom-search/docs/xml_results#
-            # booleanOperators)
-            # in the `cr` parameter's value.
-            # Google WebSearch determines the country of a document by analyzing the
-            # following:
-            # * The top-level domain (TLD) of the document's URL.
-            # * The geographic location of the web server's IP address.
-            # See [Country (cr) Parameter
-            # Values](https://developers.google.com/custom-search/docs/xml_results#
-            # countryCollections)
-            # for a list of valid values for this parameter.
+            # Restricts search results to documents originating in a particular country. You
+            # may use [Boolean operators](https://developers.google.com/custom-search/docs/
+            # xml_results#booleanOperators) in the `cr` parameter's value. Google WebSearch
+            # determines the country of a document by analyzing the following: * The top-
+            # level domain (TLD) of the document's URL. * The geographic location of the web
+            # server's IP address. See [Country (cr) Parameter Values](https://developers.
+            # google.com/custom-search/docs/xml_results#countryCollections) for a list of
+            # valid values for this parameter.
             # Corresponds to the JSON property `cr`
             # @return [String]
             attr_accessor :cr
           
-            # The identifier of a custom search engine created using the Custom Search
-            # [Control Panel](https://cse.google.com/). This is a custom property not
-            # defined in the OpenSearch spec. This parameter is **required**.
+            # The identifier of an engine created using the Programmable Search Engine [
+            # Control Panel](https://programmablesearchengine.google.com/). This is a custom
+            # property not defined in the OpenSearch spec. This parameter is **required**.
             # Corresponds to the JSON property `cx`
             # @return [String]
             attr_accessor :cx
           
-            # Restricts results to URLs based on date. Supported values include:
-            # * `d[number]`: requests results from the specified number of past days.
-            # * `w[number]`: requests results from the specified number of past weeks.
-            # * `m[number]`: requests results from the specified number of past months.
-            # * `y[number]`: requests results from the specified number of past years.
+            # Restricts results to URLs based on date. Supported values include: * `d[number]
+            # `: requests results from the specified number of past days. * `w[number]`:
+            # requests results from the specified number of past weeks. * `m[number]`:
+            # requests results from the specified number of past months. * `y[number]`:
+            # requests results from the specified number of past years.
             # Corresponds to the JSON property `dateRestrict`
             # @return [String]
             attr_accessor :date_restrict
           
-            # Enables or disables the [Simplified and Traditional Chinese
-            # Search](https://developers.google.com/custom-search/docs/xml_results#
-            # chineseSearch)
-            # feature.
-            # Supported values are:
-            # * `0`: enabled (default)
-            # * `1`: disabled
+            # Enables or disables the [Simplified and Traditional Chinese Search](https://
+            # developers.google.com/custom-search/docs/xml_results#chineseSearch) feature.
+            # Supported values are: * `0`: enabled (default) * `1`: disabled
             # Corresponds to the JSON property `disableCnTwTranslation`
             # @return [String]
             attr_accessor :disable_cn_tw_translation
           
-            # Identifies a phrase that all documents in the search results must
-            # contain.
+            # Identifies a phrase that all documents in the search results must contain.
             # Corresponds to the JSON property `exactTerms`
             # @return [String]
             attr_accessor :exact_terms
           
-            # Identifies a word or phrase that should not appear in any documents in
-            # the search results.
+            # Identifies a word or phrase that should not appear in any documents in the
+            # search results.
             # Corresponds to the JSON property `excludeTerms`
             # @return [String]
             attr_accessor :exclude_terms
           
-            # Restricts results to files of a specified extension. Filetypes supported
-            # by Google include:
-            # * Adobe Portable Document Format (`pdf`)
-            # * Adobe PostScript (`ps`)
-            # * Lotus 1-2-3 (`wk1`, `wk2`, `wk3`, `wk4`, `wk5`, `wki`, `wks`, `wku`)
-            # * Lotus WordPro (`lwp`)
-            # * Macwrite (`mw`)
-            # * Microsoft Excel (`xls`)
-            # * Microsoft PowerPoint (`ppt`)
-            # * Microsoft Word (`doc`)
-            # * Microsoft Works (`wks`, `wps`, `wdb`)
-            # * Microsoft Write (`wri`)
-            # * Rich Text Format (`rtf`)
-            # * Shockwave Flash (`swf`)
-            # * Text (`ans`, `txt`).
-            # Additional filetypes may be added in the future. An up-to-date list can
-            # always be found in Google's [file type
-            # FAQ](https://support.google.com/webmasters/answer/35287).
+            # Restricts results to files of a specified extension. Filetypes supported by
+            # Google include: * Adobe Portable Document Format (`pdf`) * Adobe PostScript (`
+            # ps`) * Lotus 1-2-3 (`wk1`, `wk2`, `wk3`, `wk4`, `wk5`, `wki`, `wks`, `wku`) *
+            # Lotus WordPro (`lwp`) * Macwrite (`mw`) * Microsoft Excel (`xls`) * Microsoft
+            # PowerPoint (`ppt`) * Microsoft Word (`doc`) * Microsoft Works (`wks`, `wps`, `
+            # wdb`) * Microsoft Write (`wri`) * Rich Text Format (`rtf`) * Shockwave Flash (`
+            # swf`) * Text (`ans`, `txt`). Additional filetypes may be added in the future.
+            # An up-to-date list can always be found in Google's [file type FAQ](https://
+            # support.google.com/webmasters/answer/35287).
             # Corresponds to the JSON property `fileType`
             # @return [String]
             attr_accessor :file_type
           
-            # Activates or deactivates the automatic filtering of Google search
-            # results. See [Automatic
-            # Filtering](https://developers.google.com/custom-search/docs/xml_results#
-            # automaticFiltering)
-            # for more information about Google's search results filters. Valid values
-            # for this parameter are:
-            # * `0`: Disabled
-            # * `1`: Enabled (default)
-            # **Note**: By default, Google applies filtering to all search results to
-            # improve the quality of those results.
+            # Activates or deactivates the automatic filtering of Google search results. See
+            # [Automatic Filtering](https://developers.google.com/custom-search/docs/
+            # xml_results#automaticFiltering) for more information about Google's search
+            # results filters. Valid values for this parameter are: * `0`: Disabled * `1`:
+            # Enabled (default) **Note**: By default, Google applies filtering to all search
+            # results to improve the quality of those results.
             # Corresponds to the JSON property `filter`
             # @return [String]
             attr_accessor :filter
           
-            # Boosts search results whose country of origin matches the parameter
-            # value. See [Country
-            # Codes](https://developers.google.com/custom-search/docs/xml_results#
-            # countryCodes)
-            # for a list of valid values.
-            # Specifying a `gl` parameter value in WebSearch requests should improve
-            # the relevance of results. This is particularly true for international
-            # customers and, even more specifically, for customers in English-speaking
-            # countries other than the United States.
+            # Boosts search results whose country of origin matches the parameter value. See
+            # [Country Codes](https://developers.google.com/custom-search/docs/xml_results#
+            # countryCodes) for a list of valid values. Specifying a `gl` parameter value in
+            # WebSearch requests should improve the relevance of results. This is
+            # particularly true for international customers and, even more specifically, for
+            # customers in English-speaking countries other than the United States.
             # Corresponds to the JSON property `gl`
             # @return [String]
             attr_accessor :gl
           
-            # Specifies the Google domain (for example, google.com, google.de, or
-            # google.fr) to which the search should be limited.
+            # Specifies the Google domain (for example, google.com, google.de, or google.fr)
+            # to which the search should be limited.
             # Corresponds to the JSON property `googleHost`
             # @return [String]
             attr_accessor :google_host
           
-            # Specifies the ending value for a search range. Use `cse:lowRange` and
-            # `cse:highrange` to append an inclusive search range of
-            # `lowRange...highRange` to the query.
+            # Specifies the ending value for a search range. Use `cse:lowRange` and `cse:
+            # highrange` to append an inclusive search range of `lowRange...highRange` to
+            # the query.
             # Corresponds to the JSON property `highRange`
             # @return [String]
             attr_accessor :high_range
           
             # Specifies the interface language (host language) of your user interface.
-            # Explicitly setting this parameter improves the performance and the
-            # quality of your search results.
-            # See the [Interface
-            # Languages](https://developers.google.com/custom-search/docs/xml_results#
-            # wsInterfaceLanguages)
-            # section of [Internationalizing Queries and Results
-            # Presentation](https://developers.google.com/custom-search/docs/xml_results#
-            # wsInternationalizing)
-            # for more information, and [Supported Interface
-            # Languages](https://developers.google.com/custom-search/docs/
-            # xml_results_appendices#interfaceLanguages)
-            # for a list of supported languages.
+            # Explicitly setting this parameter improves the performance and the quality of
+            # your search results. See the [Interface Languages](https://developers.google.
+            # com/custom-search/docs/xml_results#wsInterfaceLanguages) section of [
+            # Internationalizing Queries and Results Presentation](https://developers.google.
+            # com/custom-search/docs/xml_results#wsInternationalizing) for more information,
+            # and [Supported Interface Languages](https://developers.google.com/custom-
+            # search/docs/xml_results_appendices#interfaceLanguages) for a list of supported
+            # languages.
             # Corresponds to the JSON property `hl`
             # @return [String]
             attr_accessor :hl
           
-            # Appends the specified query terms to the query, as if they were combined
-            # with a logical `AND` operator.
+            # Appends the specified query terms to the query, as if they were combined with
+            # a logical `AND` operator.
             # Corresponds to the JSON property `hq`
             # @return [String]
             attr_accessor :hq
           
-            # Restricts results to images of a specified color type. Supported values
-            # are:
-            # * `mono` (black and white)
-            # * `gray` (grayscale)
-            # * `color` (color)
+            # Restricts results to images of a specified color type. Supported values are: *
+            # `mono` (black and white) * `gray` (grayscale) * `color` (color)
             # Corresponds to the JSON property `imgColorType`
             # @return [String]
             attr_accessor :img_color_type
           
-            # Restricts results to images with a specific dominant color. Supported
-            # values are:
-            # * `red`
-            # * `orange`
-            # * `yellow`
-            # * `green`
-            # * `teal`
-            # * `blue`
-            # * `purple`
-            # * `pink`
-            # * `white`
-            # * `gray`
-            # * `black`
-            # * `brown`
+            # Restricts results to images with a specific dominant color. Supported values
+            # are: * `red` * `orange` * `yellow` * `green` * `teal` * `blue` * `purple` * `
+            # pink` * `white` * `gray` * `black` * `brown`
             # Corresponds to the JSON property `imgDominantColor`
             # @return [String]
             attr_accessor :img_dominant_color
           
-            # Restricts results to images of a specified size. Supported values are:
-            # * `icon` (small)
-            # * `small | medium | large | xlarge` (medium)
-            # * `xxlarge` (large)
-            # * `huge` (extra-large)
+            # Restricts results to images of a specified size. Supported values are: * `icon`
+            # (small) * `small | medium | large | xlarge` (medium) * `xxlarge` (large) * `
+            # huge` (extra-large)
             # Corresponds to the JSON property `imgSize`
             # @return [String]
             attr_accessor :img_size
           
-            # Restricts results to images of a specified type. Supported values are:
-            # * `clipart` (Clip art)
-            # * `face` (Face)
-            # * `lineart` (Line drawing)
-            # * `photo` (Photo)
-            # * `animated` (Animated)
-            # * `stock` (Stock)
+            # Restricts results to images of a specified type. Supported values are: * `
+            # clipart` (Clip art) * `face` (Face) * `lineart` (Line drawing) * `photo` (
+            # Photo) * `animated` (Animated) * `stock` (Stock)
             # Corresponds to the JSON property `imgType`
             # @return [String]
             attr_accessor :img_type
@@ -650,18 +594,17 @@ module Google
             # @return [String]
             attr_accessor :link_site
           
-            # Specifies the starting value for a search range. Use `cse:lowRange` and
-            # `cse:highrange` to append an inclusive search range of
-            # `lowRange...highRange` to the query.
+            # Specifies the starting value for a search range. Use `cse:lowRange` and `cse:
+            # highrange` to append an inclusive search range of `lowRange...highRange` to
+            # the query.
             # Corresponds to the JSON property `lowRange`
             # @return [String]
             attr_accessor :low_range
           
             # Provides additional search terms to check for in a document, where each
-            # document in the search results must contain at least one of the
-            # additional search terms. You can also use the [Boolean
-            # OR](https://developers.google.com/custom-search/docs/xml_results#BooleanOrqt)
-            # query term for this type of query.
+            # document in the search results must contain at least one of the additional
+            # search terms. You can also use the [Boolean OR](https://developers.google.com/
+            # custom-search/docs/xml_results#BooleanOrqt) query term for this type of query.
             # Corresponds to the JSON property `orTerms`
             # @return [String]
             attr_accessor :or_terms
@@ -677,23 +620,16 @@ module Google
             # @return [String]
             attr_accessor :related_site
           
-            # Filters based on licensing. Supported values include:
-            # * `cc_publicdomain`
-            # * `cc_attribute`
-            # * `cc_sharealike`
-            # * `cc_noncommercial`
-            # * `cc_nonderived`
+            # Filters based on licensing. Supported values include: * `cc_publicdomain` * `
+            # cc_attribute` * `cc_sharealike` * `cc_noncommercial` * `cc_nonderived`
             # Corresponds to the JSON property `rights`
             # @return [String]
             attr_accessor :rights
           
-            # Specifies the [SafeSearch
-            # level](https://developers.google.com/custom-search/docs/xml_results#
-            # safeSearchLevels)
-            # used for filtering out adult results. This is a custom property not
-            # defined in the OpenSearch spec. Valid parameter values are:
-            # * `"off"`: Disable SafeSearch
-            # * `"active"`: Enable SafeSearch
+            # Specifies the [SafeSearch level](https://developers.google.com/custom-search/
+            # docs/xml_results#safeSearchLevels) used for filtering out adult results. This
+            # is a custom property not defined in the OpenSearch spec. Valid parameter
+            # values are: * `"off"`: Disable SafeSearch * `"active"`: Enable SafeSearch
             # Corresponds to the JSON property `safe`
             # @return [String]
             attr_accessor :safe
@@ -703,8 +639,8 @@ module Google
             # @return [String]
             attr_accessor :search_terms
           
-            # Allowed values are `web` or `image`. If unspecified, results are limited
-            # to webpages.
+            # Allowed values are `web` or `image`. If unspecified, results are limited to
+            # webpages.
             # Corresponds to the JSON property `searchType`
             # @return [String]
             attr_accessor :search_type
@@ -714,28 +650,27 @@ module Google
             # @return [String]
             attr_accessor :site_search
           
-            # Specifies whether to include or exclude results from the site named in
-            # the `sitesearch` parameter. Supported values are:
-            # * `i`: include content from site
-            # * `e`: exclude content from site
+            # Specifies whether to include or exclude results from the site named in the `
+            # sitesearch` parameter. Supported values are: * `i`: include content from site *
+            # `e`: exclude content from site
             # Corresponds to the JSON property `siteSearchFilter`
             # @return [String]
             attr_accessor :site_search_filter
           
-            # Specifies that results should be sorted according to the specified
-            # expression. For example, sort by date.
+            # Specifies that results should be sorted according to the specified expression.
+            # For example, sort by date.
             # Corresponds to the JSON property `sort`
             # @return [String]
             attr_accessor :sort
           
-            # The index of the current set of search results into the total set of
-            # results, where the index of the first result is 1.
+            # The index of the current set of search results into the total set of results,
+            # where the index of the first result is 1.
             # Corresponds to the JSON property `startIndex`
             # @return [Fixnum]
             attr_accessor :start_index
           
-            # The page number of this set of results, where the page length is set by
-            # the `count` property.
+            # The page number of this set of results, where the page length is set by the `
+            # count` property.
             # Corresponds to the JSON property `startPage`
             # @return [Fixnum]
             attr_accessor :start_page
@@ -804,190 +739,140 @@ module Google
             # @return [Fixnum]
             attr_accessor :count
           
-            # Restricts search results to documents originating in a particular
-            # country. You may use [Boolean
-            # operators](https://developers.google.com/custom-search/docs/xml_results#
-            # booleanOperators)
-            # in the `cr` parameter's value.
-            # Google WebSearch determines the country of a document by analyzing the
-            # following:
-            # * The top-level domain (TLD) of the document's URL.
-            # * The geographic location of the web server's IP address.
-            # See [Country (cr) Parameter
-            # Values](https://developers.google.com/custom-search/docs/xml_results#
-            # countryCollections)
-            # for a list of valid values for this parameter.
+            # Restricts search results to documents originating in a particular country. You
+            # may use [Boolean operators](https://developers.google.com/custom-search/docs/
+            # xml_results#booleanOperators) in the `cr` parameter's value. Google WebSearch
+            # determines the country of a document by analyzing the following: * The top-
+            # level domain (TLD) of the document's URL. * The geographic location of the web
+            # server's IP address. See [Country (cr) Parameter Values](https://developers.
+            # google.com/custom-search/docs/xml_results#countryCollections) for a list of
+            # valid values for this parameter.
             # Corresponds to the JSON property `cr`
             # @return [String]
             attr_accessor :cr
           
-            # The identifier of a custom search engine created using the Custom Search
-            # [Control Panel](https://cse.google.com/). This is a custom property not
-            # defined in the OpenSearch spec. This parameter is **required**.
+            # The identifier of an engine created using the Programmable Search Engine [
+            # Control Panel](https://programmablesearchengine.google.com/). This is a custom
+            # property not defined in the OpenSearch spec. This parameter is **required**.
             # Corresponds to the JSON property `cx`
             # @return [String]
             attr_accessor :cx
           
-            # Restricts results to URLs based on date. Supported values include:
-            # * `d[number]`: requests results from the specified number of past days.
-            # * `w[number]`: requests results from the specified number of past weeks.
-            # * `m[number]`: requests results from the specified number of past months.
-            # * `y[number]`: requests results from the specified number of past years.
+            # Restricts results to URLs based on date. Supported values include: * `d[number]
+            # `: requests results from the specified number of past days. * `w[number]`:
+            # requests results from the specified number of past weeks. * `m[number]`:
+            # requests results from the specified number of past months. * `y[number]`:
+            # requests results from the specified number of past years.
             # Corresponds to the JSON property `dateRestrict`
             # @return [String]
             attr_accessor :date_restrict
           
-            # Enables or disables the [Simplified and Traditional Chinese
-            # Search](https://developers.google.com/custom-search/docs/xml_results#
-            # chineseSearch)
-            # feature.
-            # Supported values are:
-            # * `0`: enabled (default)
-            # * `1`: disabled
+            # Enables or disables the [Simplified and Traditional Chinese Search](https://
+            # developers.google.com/custom-search/docs/xml_results#chineseSearch) feature.
+            # Supported values are: * `0`: enabled (default) * `1`: disabled
             # Corresponds to the JSON property `disableCnTwTranslation`
             # @return [String]
             attr_accessor :disable_cn_tw_translation
           
-            # Identifies a phrase that all documents in the search results must
-            # contain.
+            # Identifies a phrase that all documents in the search results must contain.
             # Corresponds to the JSON property `exactTerms`
             # @return [String]
             attr_accessor :exact_terms
           
-            # Identifies a word or phrase that should not appear in any documents in
-            # the search results.
+            # Identifies a word or phrase that should not appear in any documents in the
+            # search results.
             # Corresponds to the JSON property `excludeTerms`
             # @return [String]
             attr_accessor :exclude_terms
           
-            # Restricts results to files of a specified extension. Filetypes supported
-            # by Google include:
-            # * Adobe Portable Document Format (`pdf`)
-            # * Adobe PostScript (`ps`)
-            # * Lotus 1-2-3 (`wk1`, `wk2`, `wk3`, `wk4`, `wk5`, `wki`, `wks`, `wku`)
-            # * Lotus WordPro (`lwp`)
-            # * Macwrite (`mw`)
-            # * Microsoft Excel (`xls`)
-            # * Microsoft PowerPoint (`ppt`)
-            # * Microsoft Word (`doc`)
-            # * Microsoft Works (`wks`, `wps`, `wdb`)
-            # * Microsoft Write (`wri`)
-            # * Rich Text Format (`rtf`)
-            # * Shockwave Flash (`swf`)
-            # * Text (`ans`, `txt`).
-            # Additional filetypes may be added in the future. An up-to-date list can
-            # always be found in Google's [file type
-            # FAQ](https://support.google.com/webmasters/answer/35287).
+            # Restricts results to files of a specified extension. Filetypes supported by
+            # Google include: * Adobe Portable Document Format (`pdf`) * Adobe PostScript (`
+            # ps`) * Lotus 1-2-3 (`wk1`, `wk2`, `wk3`, `wk4`, `wk5`, `wki`, `wks`, `wku`) *
+            # Lotus WordPro (`lwp`) * Macwrite (`mw`) * Microsoft Excel (`xls`) * Microsoft
+            # PowerPoint (`ppt`) * Microsoft Word (`doc`) * Microsoft Works (`wks`, `wps`, `
+            # wdb`) * Microsoft Write (`wri`) * Rich Text Format (`rtf`) * Shockwave Flash (`
+            # swf`) * Text (`ans`, `txt`). Additional filetypes may be added in the future.
+            # An up-to-date list can always be found in Google's [file type FAQ](https://
+            # support.google.com/webmasters/answer/35287).
             # Corresponds to the JSON property `fileType`
             # @return [String]
             attr_accessor :file_type
           
-            # Activates or deactivates the automatic filtering of Google search
-            # results. See [Automatic
-            # Filtering](https://developers.google.com/custom-search/docs/xml_results#
-            # automaticFiltering)
-            # for more information about Google's search results filters. Valid values
-            # for this parameter are:
-            # * `0`: Disabled
-            # * `1`: Enabled (default)
-            # **Note**: By default, Google applies filtering to all search results to
-            # improve the quality of those results.
+            # Activates or deactivates the automatic filtering of Google search results. See
+            # [Automatic Filtering](https://developers.google.com/custom-search/docs/
+            # xml_results#automaticFiltering) for more information about Google's search
+            # results filters. Valid values for this parameter are: * `0`: Disabled * `1`:
+            # Enabled (default) **Note**: By default, Google applies filtering to all search
+            # results to improve the quality of those results.
             # Corresponds to the JSON property `filter`
             # @return [String]
             attr_accessor :filter
           
-            # Boosts search results whose country of origin matches the parameter
-            # value. See [Country
-            # Codes](https://developers.google.com/custom-search/docs/xml_results#
-            # countryCodes)
-            # for a list of valid values.
-            # Specifying a `gl` parameter value in WebSearch requests should improve
-            # the relevance of results. This is particularly true for international
-            # customers and, even more specifically, for customers in English-speaking
-            # countries other than the United States.
+            # Boosts search results whose country of origin matches the parameter value. See
+            # [Country Codes](https://developers.google.com/custom-search/docs/xml_results#
+            # countryCodes) for a list of valid values. Specifying a `gl` parameter value in
+            # WebSearch requests should improve the relevance of results. This is
+            # particularly true for international customers and, even more specifically, for
+            # customers in English-speaking countries other than the United States.
             # Corresponds to the JSON property `gl`
             # @return [String]
             attr_accessor :gl
           
-            # Specifies the Google domain (for example, google.com, google.de, or
-            # google.fr) to which the search should be limited.
+            # Specifies the Google domain (for example, google.com, google.de, or google.fr)
+            # to which the search should be limited.
             # Corresponds to the JSON property `googleHost`
             # @return [String]
             attr_accessor :google_host
           
-            # Specifies the ending value for a search range. Use `cse:lowRange` and
-            # `cse:highrange` to append an inclusive search range of
-            # `lowRange...highRange` to the query.
+            # Specifies the ending value for a search range. Use `cse:lowRange` and `cse:
+            # highrange` to append an inclusive search range of `lowRange...highRange` to
+            # the query.
             # Corresponds to the JSON property `highRange`
             # @return [String]
             attr_accessor :high_range
           
             # Specifies the interface language (host language) of your user interface.
-            # Explicitly setting this parameter improves the performance and the
-            # quality of your search results.
-            # See the [Interface
-            # Languages](https://developers.google.com/custom-search/docs/xml_results#
-            # wsInterfaceLanguages)
-            # section of [Internationalizing Queries and Results
-            # Presentation](https://developers.google.com/custom-search/docs/xml_results#
-            # wsInternationalizing)
-            # for more information, and [Supported Interface
-            # Languages](https://developers.google.com/custom-search/docs/
-            # xml_results_appendices#interfaceLanguages)
-            # for a list of supported languages.
+            # Explicitly setting this parameter improves the performance and the quality of
+            # your search results. See the [Interface Languages](https://developers.google.
+            # com/custom-search/docs/xml_results#wsInterfaceLanguages) section of [
+            # Internationalizing Queries and Results Presentation](https://developers.google.
+            # com/custom-search/docs/xml_results#wsInternationalizing) for more information,
+            # and [Supported Interface Languages](https://developers.google.com/custom-
+            # search/docs/xml_results_appendices#interfaceLanguages) for a list of supported
+            # languages.
             # Corresponds to the JSON property `hl`
             # @return [String]
             attr_accessor :hl
           
-            # Appends the specified query terms to the query, as if they were combined
-            # with a logical `AND` operator.
+            # Appends the specified query terms to the query, as if they were combined with
+            # a logical `AND` operator.
             # Corresponds to the JSON property `hq`
             # @return [String]
             attr_accessor :hq
           
-            # Restricts results to images of a specified color type. Supported values
-            # are:
-            # * `mono` (black and white)
-            # * `gray` (grayscale)
-            # * `color` (color)
+            # Restricts results to images of a specified color type. Supported values are: *
+            # `mono` (black and white) * `gray` (grayscale) * `color` (color)
             # Corresponds to the JSON property `imgColorType`
             # @return [String]
             attr_accessor :img_color_type
           
-            # Restricts results to images with a specific dominant color. Supported
-            # values are:
-            # * `red`
-            # * `orange`
-            # * `yellow`
-            # * `green`
-            # * `teal`
-            # * `blue`
-            # * `purple`
-            # * `pink`
-            # * `white`
-            # * `gray`
-            # * `black`
-            # * `brown`
+            # Restricts results to images with a specific dominant color. Supported values
+            # are: * `red` * `orange` * `yellow` * `green` * `teal` * `blue` * `purple` * `
+            # pink` * `white` * `gray` * `black` * `brown`
             # Corresponds to the JSON property `imgDominantColor`
             # @return [String]
             attr_accessor :img_dominant_color
           
-            # Restricts results to images of a specified size. Supported values are:
-            # * `icon` (small)
-            # * `small | medium | large | xlarge` (medium)
-            # * `xxlarge` (large)
-            # * `huge` (extra-large)
+            # Restricts results to images of a specified size. Supported values are: * `icon`
+            # (small) * `small | medium | large | xlarge` (medium) * `xxlarge` (large) * `
+            # huge` (extra-large)
             # Corresponds to the JSON property `imgSize`
             # @return [String]
             attr_accessor :img_size
           
-            # Restricts results to images of a specified type. Supported values are:
-            # * `clipart` (Clip art)
-            # * `face` (Face)
-            # * `lineart` (Line drawing)
-            # * `photo` (Photo)
-            # * `animated` (Animated)
-            # * `stock` (Stock)
+            # Restricts results to images of a specified type. Supported values are: * `
+            # clipart` (Clip art) * `face` (Face) * `lineart` (Line drawing) * `photo` (
+            # Photo) * `animated` (Animated) * `stock` (Stock)
             # Corresponds to the JSON property `imgType`
             # @return [String]
             attr_accessor :img_type
@@ -1007,18 +892,17 @@ module Google
             # @return [String]
             attr_accessor :link_site
           
-            # Specifies the starting value for a search range. Use `cse:lowRange` and
-            # `cse:highrange` to append an inclusive search range of
-            # `lowRange...highRange` to the query.
+            # Specifies the starting value for a search range. Use `cse:lowRange` and `cse:
+            # highrange` to append an inclusive search range of `lowRange...highRange` to
+            # the query.
             # Corresponds to the JSON property `lowRange`
             # @return [String]
             attr_accessor :low_range
           
             # Provides additional search terms to check for in a document, where each
-            # document in the search results must contain at least one of the
-            # additional search terms. You can also use the [Boolean
-            # OR](https://developers.google.com/custom-search/docs/xml_results#BooleanOrqt)
-            # query term for this type of query.
+            # document in the search results must contain at least one of the additional
+            # search terms. You can also use the [Boolean OR](https://developers.google.com/
+            # custom-search/docs/xml_results#BooleanOrqt) query term for this type of query.
             # Corresponds to the JSON property `orTerms`
             # @return [String]
             attr_accessor :or_terms
@@ -1034,23 +918,16 @@ module Google
             # @return [String]
             attr_accessor :related_site
           
-            # Filters based on licensing. Supported values include:
-            # * `cc_publicdomain`
-            # * `cc_attribute`
-            # * `cc_sharealike`
-            # * `cc_noncommercial`
-            # * `cc_nonderived`
+            # Filters based on licensing. Supported values include: * `cc_publicdomain` * `
+            # cc_attribute` * `cc_sharealike` * `cc_noncommercial` * `cc_nonderived`
             # Corresponds to the JSON property `rights`
             # @return [String]
             attr_accessor :rights
           
-            # Specifies the [SafeSearch
-            # level](https://developers.google.com/custom-search/docs/xml_results#
-            # safeSearchLevels)
-            # used for filtering out adult results. This is a custom property not
-            # defined in the OpenSearch spec. Valid parameter values are:
-            # * `"off"`: Disable SafeSearch
-            # * `"active"`: Enable SafeSearch
+            # Specifies the [SafeSearch level](https://developers.google.com/custom-search/
+            # docs/xml_results#safeSearchLevels) used for filtering out adult results. This
+            # is a custom property not defined in the OpenSearch spec. Valid parameter
+            # values are: * `"off"`: Disable SafeSearch * `"active"`: Enable SafeSearch
             # Corresponds to the JSON property `safe`
             # @return [String]
             attr_accessor :safe
@@ -1060,8 +937,8 @@ module Google
             # @return [String]
             attr_accessor :search_terms
           
-            # Allowed values are `web` or `image`. If unspecified, results are limited
-            # to webpages.
+            # Allowed values are `web` or `image`. If unspecified, results are limited to
+            # webpages.
             # Corresponds to the JSON property `searchType`
             # @return [String]
             attr_accessor :search_type
@@ -1071,28 +948,27 @@ module Google
             # @return [String]
             attr_accessor :site_search
           
-            # Specifies whether to include or exclude results from the site named in
-            # the `sitesearch` parameter. Supported values are:
-            # * `i`: include content from site
-            # * `e`: exclude content from site
+            # Specifies whether to include or exclude results from the site named in the `
+            # sitesearch` parameter. Supported values are: * `i`: include content from site *
+            # `e`: exclude content from site
             # Corresponds to the JSON property `siteSearchFilter`
             # @return [String]
             attr_accessor :site_search_filter
           
-            # Specifies that results should be sorted according to the specified
-            # expression. For example, sort by date.
+            # Specifies that results should be sorted according to the specified expression.
+            # For example, sort by date.
             # Corresponds to the JSON property `sort`
             # @return [String]
             attr_accessor :sort
           
-            # The index of the current set of search results into the total set of
-            # results, where the index of the first result is 1.
+            # The index of the current set of search results into the total set of results,
+            # where the index of the first result is 1.
             # Corresponds to the JSON property `startIndex`
             # @return [Fixnum]
             attr_accessor :start_index
           
-            # The page number of this set of results, where the page length is set by
-            # the `count` property.
+            # The page number of this set of results, where the page length is set by the `
+            # count` property.
             # Corresponds to the JSON property `startPage`
             # @return [Fixnum]
             attr_accessor :start_page
@@ -1161,190 +1037,140 @@ module Google
             # @return [Fixnum]
             attr_accessor :count
           
-            # Restricts search results to documents originating in a particular
-            # country. You may use [Boolean
-            # operators](https://developers.google.com/custom-search/docs/xml_results#
-            # booleanOperators)
-            # in the `cr` parameter's value.
-            # Google WebSearch determines the country of a document by analyzing the
-            # following:
-            # * The top-level domain (TLD) of the document's URL.
-            # * The geographic location of the web server's IP address.
-            # See [Country (cr) Parameter
-            # Values](https://developers.google.com/custom-search/docs/xml_results#
-            # countryCollections)
-            # for a list of valid values for this parameter.
+            # Restricts search results to documents originating in a particular country. You
+            # may use [Boolean operators](https://developers.google.com/custom-search/docs/
+            # xml_results#booleanOperators) in the `cr` parameter's value. Google WebSearch
+            # determines the country of a document by analyzing the following: * The top-
+            # level domain (TLD) of the document's URL. * The geographic location of the web
+            # server's IP address. See [Country (cr) Parameter Values](https://developers.
+            # google.com/custom-search/docs/xml_results#countryCollections) for a list of
+            # valid values for this parameter.
             # Corresponds to the JSON property `cr`
             # @return [String]
             attr_accessor :cr
           
-            # The identifier of a custom search engine created using the Custom Search
-            # [Control Panel](https://cse.google.com/). This is a custom property not
-            # defined in the OpenSearch spec. This parameter is **required**.
+            # The identifier of an engine created using the Programmable Search Engine [
+            # Control Panel](https://programmablesearchengine.google.com/). This is a custom
+            # property not defined in the OpenSearch spec. This parameter is **required**.
             # Corresponds to the JSON property `cx`
             # @return [String]
             attr_accessor :cx
           
-            # Restricts results to URLs based on date. Supported values include:
-            # * `d[number]`: requests results from the specified number of past days.
-            # * `w[number]`: requests results from the specified number of past weeks.
-            # * `m[number]`: requests results from the specified number of past months.
-            # * `y[number]`: requests results from the specified number of past years.
+            # Restricts results to URLs based on date. Supported values include: * `d[number]
+            # `: requests results from the specified number of past days. * `w[number]`:
+            # requests results from the specified number of past weeks. * `m[number]`:
+            # requests results from the specified number of past months. * `y[number]`:
+            # requests results from the specified number of past years.
             # Corresponds to the JSON property `dateRestrict`
             # @return [String]
             attr_accessor :date_restrict
           
-            # Enables or disables the [Simplified and Traditional Chinese
-            # Search](https://developers.google.com/custom-search/docs/xml_results#
-            # chineseSearch)
-            # feature.
-            # Supported values are:
-            # * `0`: enabled (default)
-            # * `1`: disabled
+            # Enables or disables the [Simplified and Traditional Chinese Search](https://
+            # developers.google.com/custom-search/docs/xml_results#chineseSearch) feature.
+            # Supported values are: * `0`: enabled (default) * `1`: disabled
             # Corresponds to the JSON property `disableCnTwTranslation`
             # @return [String]
             attr_accessor :disable_cn_tw_translation
           
-            # Identifies a phrase that all documents in the search results must
-            # contain.
+            # Identifies a phrase that all documents in the search results must contain.
             # Corresponds to the JSON property `exactTerms`
             # @return [String]
             attr_accessor :exact_terms
           
-            # Identifies a word or phrase that should not appear in any documents in
-            # the search results.
+            # Identifies a word or phrase that should not appear in any documents in the
+            # search results.
             # Corresponds to the JSON property `excludeTerms`
             # @return [String]
             attr_accessor :exclude_terms
           
-            # Restricts results to files of a specified extension. Filetypes supported
-            # by Google include:
-            # * Adobe Portable Document Format (`pdf`)
-            # * Adobe PostScript (`ps`)
-            # * Lotus 1-2-3 (`wk1`, `wk2`, `wk3`, `wk4`, `wk5`, `wki`, `wks`, `wku`)
-            # * Lotus WordPro (`lwp`)
-            # * Macwrite (`mw`)
-            # * Microsoft Excel (`xls`)
-            # * Microsoft PowerPoint (`ppt`)
-            # * Microsoft Word (`doc`)
-            # * Microsoft Works (`wks`, `wps`, `wdb`)
-            # * Microsoft Write (`wri`)
-            # * Rich Text Format (`rtf`)
-            # * Shockwave Flash (`swf`)
-            # * Text (`ans`, `txt`).
-            # Additional filetypes may be added in the future. An up-to-date list can
-            # always be found in Google's [file type
-            # FAQ](https://support.google.com/webmasters/answer/35287).
+            # Restricts results to files of a specified extension. Filetypes supported by
+            # Google include: * Adobe Portable Document Format (`pdf`) * Adobe PostScript (`
+            # ps`) * Lotus 1-2-3 (`wk1`, `wk2`, `wk3`, `wk4`, `wk5`, `wki`, `wks`, `wku`) *
+            # Lotus WordPro (`lwp`) * Macwrite (`mw`) * Microsoft Excel (`xls`) * Microsoft
+            # PowerPoint (`ppt`) * Microsoft Word (`doc`) * Microsoft Works (`wks`, `wps`, `
+            # wdb`) * Microsoft Write (`wri`) * Rich Text Format (`rtf`) * Shockwave Flash (`
+            # swf`) * Text (`ans`, `txt`). Additional filetypes may be added in the future.
+            # An up-to-date list can always be found in Google's [file type FAQ](https://
+            # support.google.com/webmasters/answer/35287).
             # Corresponds to the JSON property `fileType`
             # @return [String]
             attr_accessor :file_type
           
-            # Activates or deactivates the automatic filtering of Google search
-            # results. See [Automatic
-            # Filtering](https://developers.google.com/custom-search/docs/xml_results#
-            # automaticFiltering)
-            # for more information about Google's search results filters. Valid values
-            # for this parameter are:
-            # * `0`: Disabled
-            # * `1`: Enabled (default)
-            # **Note**: By default, Google applies filtering to all search results to
-            # improve the quality of those results.
+            # Activates or deactivates the automatic filtering of Google search results. See
+            # [Automatic Filtering](https://developers.google.com/custom-search/docs/
+            # xml_results#automaticFiltering) for more information about Google's search
+            # results filters. Valid values for this parameter are: * `0`: Disabled * `1`:
+            # Enabled (default) **Note**: By default, Google applies filtering to all search
+            # results to improve the quality of those results.
             # Corresponds to the JSON property `filter`
             # @return [String]
             attr_accessor :filter
           
-            # Boosts search results whose country of origin matches the parameter
-            # value. See [Country
-            # Codes](https://developers.google.com/custom-search/docs/xml_results#
-            # countryCodes)
-            # for a list of valid values.
-            # Specifying a `gl` parameter value in WebSearch requests should improve
-            # the relevance of results. This is particularly true for international
-            # customers and, even more specifically, for customers in English-speaking
-            # countries other than the United States.
+            # Boosts search results whose country of origin matches the parameter value. See
+            # [Country Codes](https://developers.google.com/custom-search/docs/xml_results#
+            # countryCodes) for a list of valid values. Specifying a `gl` parameter value in
+            # WebSearch requests should improve the relevance of results. This is
+            # particularly true for international customers and, even more specifically, for
+            # customers in English-speaking countries other than the United States.
             # Corresponds to the JSON property `gl`
             # @return [String]
             attr_accessor :gl
           
-            # Specifies the Google domain (for example, google.com, google.de, or
-            # google.fr) to which the search should be limited.
+            # Specifies the Google domain (for example, google.com, google.de, or google.fr)
+            # to which the search should be limited.
             # Corresponds to the JSON property `googleHost`
             # @return [String]
             attr_accessor :google_host
           
-            # Specifies the ending value for a search range. Use `cse:lowRange` and
-            # `cse:highrange` to append an inclusive search range of
-            # `lowRange...highRange` to the query.
+            # Specifies the ending value for a search range. Use `cse:lowRange` and `cse:
+            # highrange` to append an inclusive search range of `lowRange...highRange` to
+            # the query.
             # Corresponds to the JSON property `highRange`
             # @return [String]
             attr_accessor :high_range
           
             # Specifies the interface language (host language) of your user interface.
-            # Explicitly setting this parameter improves the performance and the
-            # quality of your search results.
-            # See the [Interface
-            # Languages](https://developers.google.com/custom-search/docs/xml_results#
-            # wsInterfaceLanguages)
-            # section of [Internationalizing Queries and Results
-            # Presentation](https://developers.google.com/custom-search/docs/xml_results#
-            # wsInternationalizing)
-            # for more information, and [Supported Interface
-            # Languages](https://developers.google.com/custom-search/docs/
-            # xml_results_appendices#interfaceLanguages)
-            # for a list of supported languages.
+            # Explicitly setting this parameter improves the performance and the quality of
+            # your search results. See the [Interface Languages](https://developers.google.
+            # com/custom-search/docs/xml_results#wsInterfaceLanguages) section of [
+            # Internationalizing Queries and Results Presentation](https://developers.google.
+            # com/custom-search/docs/xml_results#wsInternationalizing) for more information,
+            # and [Supported Interface Languages](https://developers.google.com/custom-
+            # search/docs/xml_results_appendices#interfaceLanguages) for a list of supported
+            # languages.
             # Corresponds to the JSON property `hl`
             # @return [String]
             attr_accessor :hl
           
-            # Appends the specified query terms to the query, as if they were combined
-            # with a logical `AND` operator.
+            # Appends the specified query terms to the query, as if they were combined with
+            # a logical `AND` operator.
             # Corresponds to the JSON property `hq`
             # @return [String]
             attr_accessor :hq
           
-            # Restricts results to images of a specified color type. Supported values
-            # are:
-            # * `mono` (black and white)
-            # * `gray` (grayscale)
-            # * `color` (color)
+            # Restricts results to images of a specified color type. Supported values are: *
+            # `mono` (black and white) * `gray` (grayscale) * `color` (color)
             # Corresponds to the JSON property `imgColorType`
             # @return [String]
             attr_accessor :img_color_type
           
-            # Restricts results to images with a specific dominant color. Supported
-            # values are:
-            # * `red`
-            # * `orange`
-            # * `yellow`
-            # * `green`
-            # * `teal`
-            # * `blue`
-            # * `purple`
-            # * `pink`
-            # * `white`
-            # * `gray`
-            # * `black`
-            # * `brown`
+            # Restricts results to images with a specific dominant color. Supported values
+            # are: * `red` * `orange` * `yellow` * `green` * `teal` * `blue` * `purple` * `
+            # pink` * `white` * `gray` * `black` * `brown`
             # Corresponds to the JSON property `imgDominantColor`
             # @return [String]
             attr_accessor :img_dominant_color
           
-            # Restricts results to images of a specified size. Supported values are:
-            # * `icon` (small)
-            # * `small | medium | large | xlarge` (medium)
-            # * `xxlarge` (large)
-            # * `huge` (extra-large)
+            # Restricts results to images of a specified size. Supported values are: * `icon`
+            # (small) * `small | medium | large | xlarge` (medium) * `xxlarge` (large) * `
+            # huge` (extra-large)
             # Corresponds to the JSON property `imgSize`
             # @return [String]
             attr_accessor :img_size
           
-            # Restricts results to images of a specified type. Supported values are:
-            # * `clipart` (Clip art)
-            # * `face` (Face)
-            # * `lineart` (Line drawing)
-            # * `photo` (Photo)
-            # * `animated` (Animated)
-            # * `stock` (Stock)
+            # Restricts results to images of a specified type. Supported values are: * `
+            # clipart` (Clip art) * `face` (Face) * `lineart` (Line drawing) * `photo` (
+            # Photo) * `animated` (Animated) * `stock` (Stock)
             # Corresponds to the JSON property `imgType`
             # @return [String]
             attr_accessor :img_type
@@ -1364,18 +1190,17 @@ module Google
             # @return [String]
             attr_accessor :link_site
           
-            # Specifies the starting value for a search range. Use `cse:lowRange` and
-            # `cse:highrange` to append an inclusive search range of
-            # `lowRange...highRange` to the query.
+            # Specifies the starting value for a search range. Use `cse:lowRange` and `cse:
+            # highrange` to append an inclusive search range of `lowRange...highRange` to
+            # the query.
             # Corresponds to the JSON property `lowRange`
             # @return [String]
             attr_accessor :low_range
           
             # Provides additional search terms to check for in a document, where each
-            # document in the search results must contain at least one of the
-            # additional search terms. You can also use the [Boolean
-            # OR](https://developers.google.com/custom-search/docs/xml_results#BooleanOrqt)
-            # query term for this type of query.
+            # document in the search results must contain at least one of the additional
+            # search terms. You can also use the [Boolean OR](https://developers.google.com/
+            # custom-search/docs/xml_results#BooleanOrqt) query term for this type of query.
             # Corresponds to the JSON property `orTerms`
             # @return [String]
             attr_accessor :or_terms
@@ -1391,23 +1216,16 @@ module Google
             # @return [String]
             attr_accessor :related_site
           
-            # Filters based on licensing. Supported values include:
-            # * `cc_publicdomain`
-            # * `cc_attribute`
-            # * `cc_sharealike`
-            # * `cc_noncommercial`
-            # * `cc_nonderived`
+            # Filters based on licensing. Supported values include: * `cc_publicdomain` * `
+            # cc_attribute` * `cc_sharealike` * `cc_noncommercial` * `cc_nonderived`
             # Corresponds to the JSON property `rights`
             # @return [String]
             attr_accessor :rights
           
-            # Specifies the [SafeSearch
-            # level](https://developers.google.com/custom-search/docs/xml_results#
-            # safeSearchLevels)
-            # used for filtering out adult results. This is a custom property not
-            # defined in the OpenSearch spec. Valid parameter values are:
-            # * `"off"`: Disable SafeSearch
-            # * `"active"`: Enable SafeSearch
+            # Specifies the [SafeSearch level](https://developers.google.com/custom-search/
+            # docs/xml_results#safeSearchLevels) used for filtering out adult results. This
+            # is a custom property not defined in the OpenSearch spec. Valid parameter
+            # values are: * `"off"`: Disable SafeSearch * `"active"`: Enable SafeSearch
             # Corresponds to the JSON property `safe`
             # @return [String]
             attr_accessor :safe
@@ -1417,8 +1235,8 @@ module Google
             # @return [String]
             attr_accessor :search_terms
           
-            # Allowed values are `web` or `image`. If unspecified, results are limited
-            # to webpages.
+            # Allowed values are `web` or `image`. If unspecified, results are limited to
+            # webpages.
             # Corresponds to the JSON property `searchType`
             # @return [String]
             attr_accessor :search_type
@@ -1428,28 +1246,27 @@ module Google
             # @return [String]
             attr_accessor :site_search
           
-            # Specifies whether to include or exclude results from the site named in
-            # the `sitesearch` parameter. Supported values are:
-            # * `i`: include content from site
-            # * `e`: exclude content from site
+            # Specifies whether to include or exclude results from the site named in the `
+            # sitesearch` parameter. Supported values are: * `i`: include content from site *
+            # `e`: exclude content from site
             # Corresponds to the JSON property `siteSearchFilter`
             # @return [String]
             attr_accessor :site_search_filter
           
-            # Specifies that results should be sorted according to the specified
-            # expression. For example, sort by date.
+            # Specifies that results should be sorted according to the specified expression.
+            # For example, sort by date.
             # Corresponds to the JSON property `sort`
             # @return [String]
             attr_accessor :sort
           
-            # The index of the current set of search results into the total set of
-            # results, where the index of the first result is 1.
+            # The index of the current set of search results into the total set of results,
+            # where the index of the first result is 1.
             # Corresponds to the JSON property `startIndex`
             # @return [Fixnum]
             attr_accessor :start_index
           
-            # The page number of this set of results, where the page length is set by
-            # the `count` property.
+            # The page number of this set of results, where the page length is set by the `
+            # count` property.
             # Corresponds to the JSON property `startPage`
             # @return [Fixnum]
             attr_accessor :start_page
@@ -1514,8 +1331,8 @@ module Google
         class SearchInformation
           include Google::Apis::Core::Hashable
         
-          # The time taken for the server to return search results, formatted
-          # according to locale style.
+          # The time taken for the server to return search results, formatted according to
+          # locale style.
           # Corresponds to the JSON property `formattedSearchTime`
           # @return [String]
           attr_accessor :formatted_search_time
@@ -1577,15 +1394,13 @@ module Google
         class Url
           include Google::Apis::Core::Hashable
         
-          # The actual [OpenSearch
-          # template](http://www.opensearch.org/specifications/opensearch/1.1#
-          # opensearch_url_template_syntax)
-          # for this API.
+          # The actual [OpenSearch template](http://www.opensearch.org/specifications/
+          # opensearch/1.1#opensearch_url_template_syntax) for this API.
           # Corresponds to the JSON property `template`
           # @return [String]
           attr_accessor :template
         
-          # The MIME type of the OpenSearch URL template for the Custom Search API.
+          # The MIME type of the OpenSearch URL template for the Custom Search JSON API.
           # Corresponds to the JSON property `type`
           # @return [String]
           attr_accessor :type